Wtyczka InstallOptions 2

Liczba kontrolek wyświetlanych w oknie dialogowym.

Jeśli określony, zwraca tekst dla tytułu okna. W przeciwym przypadku, tekst tytułu okna nie jest zmieniany.

Jeśli określony, nadpisuje ustawienia NSIS i włącza lub wyłącza przycisk Anuluj. Jeśli wartość ustawiona jest na 1, przycisk Anuluj będzie aktywny. Jeśli wartość ustawiona jest na 0, przycisk Anuluj będzie nieaktywny.

Jeśli określony, nadpisuje ustawienia NSIS i wyświetla lub ukrywa przycisk Anuluj. Jeśli wartość ustawiona jest na 1, przycisk Anuluj będzie widoczny. Jeśli wartość ustawiona jest na 0, przycisk Anuluj będzie ukryty.

Jeśli określony, nadpisuje ustawienia NSIS i włącza lub wyłącza przycisk Wstecz. Jeśli wartość ustawiona jest na 1, przycisk Wstecz będzie aktywny. Jeśli wartość ustawiona jest na 0, przycisk Wstecz będzie nieaktywny.

Nadpisuje tekst na przycisku Anuluj. Jeśli nie określony, tekst na przycisku Anuluj nie zostanie zmieniony.

Nadpisuje tekst na przycisku Dalej. Jeśli nie określony, tekst na przycisku Dalej nie zostanie zmieniony.

Nadpisuje tekst na przycisku Wstecz. Jeśli nie określony, tekst na przycisku Wstecz nie zostanie zmieniony.

Nadpisuje domyślny ID obszaru rect, na którym jest wyświetlany. Pozwala to na zmianę rozmiaru IO na inny.

Jeśli określono wartość 1 okno dialogowe wyświetlane jest jako lustrzane odbicie, a wszystkie teksty wyrównywane są do prawej. Makro INSTALLOPTIONS_EXTRACT automatycznie ustawia to pole na odpowiednią wartość w zależności od bieżącego języka instalatora dzięki zmiennej $(^RTL).

Pole to ustawiane jest przez wtyczkę InstallOptions, przed wywołaniem funkcji walidacji niestandardowej strony, dla kontrolek, które posiadają flagę Notify (np. przycisk). Pole ustawiane jest, jeśli użytkownik wykona jakąś akcję (np. naciśnie przycisk).

Typ kontrolki, która zostanie utworzona. Poprawnymi wartościami są: "Label", "Text", "Password", "Combobox", "DropList", "Listbox", "CheckBox", "RadioButton", "FileRequest", "DirRequest" "Icon", "Bitmap", "GroupBox", "HLine", "VLine", "Link" lub "Button".

• Label

  Kontrolka Label używana jest do wyświetlania statycznego tekstu (np. etykieta dla kontrolki textbox).

• Text

  Kontrolka Text przyjmuje tekst wprowadzany przez użytkownika.

• Password

  Kontrolka Password przyjmuje tekst wprowadzany przez użytkownika oraz maskuje dane wejściowe przy użyciu znaku *.

• Combobox

  Kontrolka Combobox pozwala użytkownikowi na wpisywanie tekstu nie na liście typu popup.

• Droplist

  Kontrolka Droplist pozwala tylko na wybór elementów z listy.

• Listbox

  Kontrolka Listbox wyświetla wiele elementów i opcjonalnie umożliwia użytkownikowi na wybranie więcej niż jednego z nich.

• CheckBox

  Kontrolka CheckBox wyświetla pole wyboru wraz z etykietą.

• RadioButton

  Kontrolka RadioButton wyświetla przycisk typu radio z etykietą.

• FileRequest

  Kontrolka FileRequest wyświetla pole tekstowe i przycisk Przeglądaj. Klikając na ów przycisk, wyświetlone zostanie okno, z którego można wybrać poszukiwany przez użytkownika plik.

• DirRequest

  Kontrolka DirRequest wyświetla pole tekstowe i przycisk Przeglądaj. Klikając na ów przycisk, wyświetlone zostanie okno, z którego można wybrać poszukiwany przez użytkownika katalog.

• Icon

  Kontrolka Icon wyświetla ikonę. Jeśli pole Text jest puste, użyta zostanie ikonka instalatora.

• Bitmap

  Kontrolka Bitmap wyświetla mapę bitową.

• GroupBox

  Kontrolka GroupBox wyświetla ramkę, w której można zgrupować inne kontrolki.

• HLine

  Kontrolka HLine wyświetla poziomą linię, która rozdziela kontrolki.

• VLine

  Kontrolka VLine wyświetla pionową linię, która rozdziela kontrolki.

• Link

  Kontrolka Link wyświetla statyczny "gorący" tekst. Wyświetla statyczny "gorący" tekst. Gdy użytkownik naciśnie tę kontrolkę zawartość "State" (np http://...) zostanie wykonana przy użyciu polecenia ShellExecute. Alternatywnie, wartość "State" może być pominięta, a flaga NOTIFY użyta do wywołania skryptu NSIS. Więcej informacji znajdziesz poniżej, w opisie flagi "NOTIFY".

• Button

  Kontrolka Button wyświetla przycisk, którego można użyć tak samo jak kontrolkę "Link".

Określa tekst etykiet, pól wyboru lub przycisku typu radio. Dla kontrolki DirRequest określa tytuł okna dialogowego przeglądania. Dla kontrolek ikon oraz map bitowych określa ścieżkę dostępu do obrazka.

Uwaga
Dla etykiet, znaki \r\n zostaną przekonwertowane na nowe linie. Aby użyć znaku odwrotnego ukośnika back-slash w tekście musisz użyć innego ukośnika odwrotnego - \\. Opisane tutaj są funkcjami NSIS do konwersji tekstu z/na ten format.

Określa stan kontrolki. Uaktualniany jest po zamknięciu przez użytkownika okna, więc można go odczytać z NSIS. Dla edycji tekstu, okien wybory katalogów oraz plików, jest to łańcuch znaków. Dla przycisków radio oraz pól wyboru, może to być wartość '0' lub '1' (odznaczony lub zaznaczony). Dla list, list kombinowanych i list rozwijalnych są to wybrane elementy rozdzielone znakiem ('|'). Dla łączy i Przycisków może określać coś do wykonania lub otwarcia (poprzez funkcję ShellExecute).

Uwaga
Dla pól Text z ustawioną flagą MULTILINE, znaki \r\n zostaną przekonwertowane na nowe linie. Aby użyć znaku odwrotnego ukośnika back-slash w tekście musisz użyć innego ukośnika odwrotnego - \\. Opisane tutaj są funkcjami NSIS do konwersji tekstu z/na ten format.

Lista elementów, które wyświetlane są w kontrolkach typu combobox, droplist, lub listbox.
Jest to pojedyncza linia tekstu, z elementami rozdzielanymi znakiem '|'

Powoduje walidację zaznaczonej kontrolki, ograniczając maksymalną długość tekstu.
Jeśli użytkownik określi dłuższy tekst niż ten, pojawi się komunikat, po kliknięciu "OK" okno dialogowe nie zniknie.
Nie powinieneś używać tego w kontrolkach "combobox", jako że użytkownik nie może kontrolować tego co jest zaznaczone.
Wartość MaxLen może być przypisana maksymalnie dla 260 kontrolek "FileRequest" oraz "DirRequest".
Ignorowane jest w kontrolkach "Label".

Powoduje walidację zaznaczonej kontrolki, wymuszając wpisanie określonej minimalnej długości tekstu.
Jeśli użytkownik określi krótszy tekst niż ten, pojawi się komunikat, po kliknięciu "OK" okno dialogowe nie zniknie.
W przeciwieństwie do MaxLen, MinLen jest użyteczne dla kontrolek "Combobox". Ustawiając jej wartość "1" program wymusi na użytkowniku wybranie elementu.
Ignorowane jest w kontrolkach "Label".

Jeśli pole nie przejdzie testu dla "MinLen" lub "MaxLen", pojawi się komunikat z tym tekstem.

Uwaga
Znaki \r\n zostaną przekonwertowane na nowe linie, dwa ukośniki odwroten back-slash zostanazmienione na jeden - \\. Opisane tutaj są funkcjami NSIS do konwersji tekstu z/na ten format.

Pozycja, w której zostanie dana kontrolka wyświetlona w oknie dialogowym. Wszystkie rozmiary powinny być ustawione w jednostkach dialogowych. Aby pobrać prawidłowe wymiary dla kontrolki, projektuj swoje okno dialogowe przy pomocy edytora zasobów i następnie skopiuj wymiary do pliku INI.

Uwaga
Możesz określić ujemne współrzędne, aby ustalić odległość z prawej lub dolnej krawędzi.

Uwaga (2)
W kontrolkach typu lista kombinowana lub lista rozwijalna, wartość "bottom" nie jest używana w taki sam sposób.
W tym przypadku, wartość bottom jest maksymalnym rozmiarem okna, gdy lista jest wyświetlana. W każdym przypadku, rozmiary elementów listy kombinowanej są automatycznie dopasowywane do rozmiaru jednego z nich. Jeśli masz problemy z zobaczeniem rozwiniętej listy kombinowanej, sprawdź wartość bottom i upewnij się że jest wystarczająco długa. Wymaganą wysokością elementu jest liczba elementów na liście pomnożona przez 8, plus 20.

Uwaga (3)
Kontrolki FileRequest oraz DirRequest alokują 15 jednostek dialogowych dla przycisku Przeglądaj. Upewnij się, że kontrolki te są odpowiednio szerokie, tak żeby można było zobaczyć ich tekstową zawartość.

(opcjonalne)

Określa filtr, który używany jest w kontrolce "FileRequest".
Skonstruowany jest tak, że wpsiuje się pary wpisów, każda rozdzielona znakiem |.
Pierwsza z wartości jest tekstem, który wyświetlany jest w filtrze.
Druga z nich, jest wzorcem maski używanym do ograniczania wyświetlania plików.
Na przykład, możesz określić:
Filter=Pliki tekstowe|*.txt|Programy|*.exe;*.com|Wszystkie pliki|*.*
Jeśli nie określone, filtr domyślnie wskazuje na Wszystkie Pliki|*.*

Uwaga
Nie powinieneś wstawiać żadnych dodatkowych spacji pomiędzy znaki |.

Używane przez kontrolkę DirRequest do określenia katalogu nadrzędnego przeszukiwania. Domyślnie, pozwala użytkownikowi na przeglądanie dowolnego katalogu na komputerze. Pozwala ograniczyć przeglądanie do określonego katalogu w systemie.

Określa dodatkowe flagi dla wyświetlania kolejnych kontrolek. Każda wartość powinna być rozdzielona znakiem |. Uważaj, żeby nie było żadnych spacji przy znaku |.

• REQ_SAVE

  Powoduje, że kontrolka "FileRequest" wyświetla okno dialogowe 'Zapisz jako'. Jeśli nie określone, używane jest okno dialogowe 'Otwórz'.

• FILE_MUST_EXIST

  Używane przez kontrolkę "FileRequest" do określenia czy wybrany plik musi istnieć.
  Działa tylko wtedy gdy okno dialogowe 'Otwórz' jest wyświetlone.
  Obecnie działa tylko z oknem dialogowym przycisku Przeglądaj.

• FILE_EXPLORER

  Używane przez kontrolkę "FileRequest", włącza widok żądania nowego pliku (zalecane)

• FILE_HIDEREADONLY

  Używane przez kontrolkę "FileRequest", ukrywa pole wyboru "Otwórz tylko do odczytu" w oknie dialogowym 'Otwórz'.

• WARN_IF_EXIST

  Używane przez kontrolkę "FileRequest" do wyświetlania komunikatu ostrzegawczego, że wybrany plik już istnieje.
  Wyświetla komunikat ostrzegawczy tylko dla plików wybranych przy użyciu okna dialogowego przycisku Przeglądaj.

• PATH_MUST_EXIST

  Używane przez kontrolkę "FileRequest" do wymuszenia istnienia ścieżki dostepu. Ma na celu ochronę użytkownika, przed wpisaniem nieistniejącej ścieżki dostępu w oknie dialogowym przeglądania za plikiem.
  Sprawdza tylko wybraną ścieżkę dostępu okna dialogowego przycisku Przeglądaj.

• PROMPT_CREATE

  Używane przez kontrolkę "FileRequest" do wyświetlania ostrzeżeń, jeśli wybrany plik nie istnieje. Mimo to, wciąż istnieje możliwość wybrania przez użytkownika pliku.
  Wyświetla komunikat ostrzegawczy tylko dla plików wybranych przy użyciu okna dialogowego przycisku Przeglądaj.
  Nie działa z REQ_SAVE.

• RIGHT

  Używane przez kontrolkę "Checkbox" oraz "Radiobutton" do określenia czy pole wyboru ma być po prawej stronie tekstu czy też po jego lewej stronie (domyślnie).

• MULTISELECT

  Używane przez kontrolkę "Listbox". Przełącza zazmaczenie lub odznaczenie łańcucha znaków, za każdym razem gdy użytkownik kliknie lub kliknie podwójnie ten wpis na liście. Użytkownik może wybrać dowolną liczbę wpisów. Jeśli ta flaga oraz flaga EXTENDEDSELCT nie jest określona, tylko jeden element będzie mógł być wybrany z listy.

• EXTENDEDSELCT

  Używane przez kontrolkę "Listbox". Pozwala wielu elementom na zaznaczenie przy użyciu klawisza SHIFT oraz klawisza myszy lub też specjalną kombinacją klawiszy. Jeśli ta flaga oraz flaga MULTISELECT nie jest określona, z listy będzie można wybrać tylko jeden element.

• RESIZETOFIT

  Pozwala kontrolce "Bitmap" na zmianę rozmiaru obrazka do rozmiaru kontrolki. Użyteczne również do obsługi własnych ustawień DPI. Bez tej flagi, obrazek będzie wyśrodkowany na określonym obszarze.

• TRANSPARENT

  Używane przez kontrolkę "Bitmap". Ukrywa każdy piksel o tym samym kolorze co piksel w lewym górnym rogu. Pozwala to na uzyskanie efektu przezroczystości. Flaga ta nie działa poprawnie w kombinacji z flagą RESIZETOFIT oraz mapami bitowymi z więcej niż 256 kolorami.

• GROUP

  Dodaj tę flagę do pierwszej z kontrolek grupy kontrolek, aby je zgrupować. Grupowanie kontrolek pozwala na tworzenie wielu grup przycisków typu radio i nawigacji pomiędzy nimi za pomocą klawiszy strzałek.

• FOCUS

  Ustawia fokus na określonej kontrolce, zamiast domyślnej pierwszej. Jeśli więcej niż jedno pole ma określoną tę flagę, tylko pierwsza z nich zostanie aktywowana.

• NOTABSTOP

  Nie zatrzymuje się na kontrolce, gdy użytkownik wciśnie klawisz tabulacji. Dodaj NOTABSTOP do wszystkich kontrolek grupy, poza pierwszą, aby mieć możliwość nawigacji pomiędzy nimi za pomocą klawisza tabulacji Tab.

• DISABLED

  Dezaktywuje kontrolkę.

• ONLY_NUMBERS

  Używane przez kontrolkę "Text". Wymusza wpisywanie tylko liczb do pola tekstowego.

• MULTILINE

  Używane przez kontrolkę "Text". Sprawia, że kontrolka akceptuje wielowierszowy tekst.

• WANTRETURN

  Używane przez kontrolkę "Text" z wielowierszowym tekstem. Pozwala na powrót karetki , po naciśnięciu przez użytkownika klawisza ENTER, po wpisaniu tekstu w pole tekstowe.

• NOWORDWRAP

  Używane przez kontrolkę "Text" z wielowierszowym tekstem. Wyłącza zawijanie wierszy, które występuje przy wpisywaniu długich linii tekstu. Długie linie zamiast przewijania. Określenie flagi HSCROLL daje taki sam rezultat.

• HSCROLL

  Wyświetla poziomy pasek przewijania. Użyty przez kontrolkę "Text" z wieloliniowym tekstem wyłącza zawijanie wierszy.

• VSCROLL

  Wyświetla pionowy pasek przewijania.

• READONLY

  Używane przez kontrolkę "Text". Uniemożliwia ona użytkownikowi wpisywanie lub edycję tekstu w kontrolce edycji - pozwala jednak użytkownikowi na zaznaczanie i kopiowanie tego tekstu.

• NOTIFY

  Używane przez kontrolki "Button", "Link", "CheckBox", "RadioButton", "ListBox" oraz "DropList". Powoduje, że InstallOptions wywołuje funkcję walidacji/wyjścia niestandardowej strony NSIS, za każdym razem gdy zmieni się zaznaczenie danej kontrolki. Twoja funkcja walidacji/wyjścia może odczytywać wartość "State" z sekcji "Settings", aby określić, która z kontrolek spowodowała zgłoszenie (jeśli w ogóle), oraz wykonać jakąś określoną akcję, po instrukcji Abort (aby NSIS wrócił do strony). Katalog Examples\InstallOptions zawiera przykładowy skrypt, który prezentuje sposób użycia tej flagi.

Używane przez kontrolkę Link, w celu określenia koloru tekstu. Format: 0xBBRRGG (heksadecymalnie).

Wartość zwracana przez funkcję initDialog zawiera uchwyt HWND kontrolki tworzonej przez to pole. Może być użyte zamiast funkcji FindWindow oraz GetDlgItem. HWND2 zawiera uchwyt HWND dodatkowej kontrolki, na przykład przycisku Przeglądaj.