Pasek narzędziowy (Toolbar) Wstęp Zestaw kontrolek obsługiwanych przez wbudowane funkcje AitoIt nie obejmuje bardzo popularnego w nowszych programach paska narzędziowego. Tworzenie i obsługę tego typu kontrolek umożliwia standardowy UDF o nazwie GuiToolbar.au3.

UDF jest bardzo rozbudowany, zawiera ponad sto funkcji do tworzeni, usuwania, odczytu, ustawiania i zmiany wyglądu elementów paska.

Wszystkie nazwy stałych są zdefiniowane w ToolbarConstants.au3. Dołączenie tych definicji jest realizowane przez GuiToolbar.au3, więc nie trzeba robić tego w programie.

Funkcje podstawowe _GUICtrlToolbar_Create #include _GUICtrlToolbar_Create($hWnd [, $iStyle = 0x800 [, $iExStyle = 0]]) Funkcja tworzy pasek narzędziowy. Zwraca uchwyt do kontrolki, lub 0 gdy wystąpił błąd.

$hWnd - uchwyt do okna GUI, w którym ma być utworzona kontrolka.

$iStyle - styl okna: $TBSTYLE_FLAT | 0x800 | pasek jednowierszowy, tekst pod ikoną (domyślnie) $TBSTYLE_LIST | 0x1000 | pasek jednowierszowy, tekst po prawej stronie ikony $TBSTYLE_WRAPABLE | 0x200 | pasek wielowierszowy (jeżeli przyciski nie mieszczą się w jednym wierszu) $TBSTYLE_TRANSPARENT | 0x8000 | pasek przezroczysty (ale przyciski nie są przezroczyste)

$iExStyle - dodatkowy parametr stylu (domyślna wartość 0):

_GUICtrlToolbar_AddButton #include _GUICtrlToolbar_AddButton($hToolbar, $iID, $iImage [, $iString = 0 [, $iStyle = 0 [, $iState = 4 [, $iParam = 0]]]]) Funkcja dodaje przycisk do paska narzędziowego. Zwraca 1 gdy sukces, lub 0 gdy wystąpił błąd.

$hToolbar - uchwyt do paska narzędziowego

$iID - ID przycisku nadane przez programistę

$iImage - indeks obrazka na przycisku. Przy korzystaniu z zasobów systemowych jest to: $STD_COPY - Kopiuj (Copy) $STD_CUT - Wytnij (Cut) $STD_DELETE - Usuń (Delete) $STD_FILENEW - Nowy plik (New file) $STD_FILEOPEN - Otwórz plik (Open file) $STD_FILESAVE - Zapisz plik (Save file) $STD_FIND - Szukaj (Find) $STD_HELP - Pomoc (Help) $STD_PASTE - Wklej (Paste) $STD_PRINT - Drukuj (Print) $STD_PRINTPRE - Podgląd wydruku (Print preview) $STD_PROPERTIES - Właściwości (Properties) $STD_REDOW - Ponów (Redo) $STD_REPLACE - Zamień (Replace) $STD_UNDO - Cofnij (Undo)

Pozostałe opcjonalnie:

$iString - indeks stringu z opisem przycisku

$iStyle - styl przycisku

$iState - status przycisku

$IParam - dodatkowy parametr (w zasadzie należy używać tylko wartości domyślnej)

_GUICtrlToolbar_AddButtonSep #include _GUICtrlToolbar_AddButtonSep($hToolbar [, $iWidth = 6]) Funkcja wstawia separator do paska narzędziowego. Nie zwraca żadnej wartości.

$hToolbar - uchwyt do paska narzędziowego

$iWidth - szerokość separatora w pikselach (domyślna wartość to 6 pikseli)

_GUICtrlToolbar_AddBitmap #include _GUICtrlToolbar_AddBitmap($hToolbar, $iButtons, $hInst, $iID)

$hToolbar - uchwyt do paska narzędziowego

$iButtons - ilość obrazów przycisków w bitmapie (jeżeli korzystamy z zasobów systemowych parametr ten nie ma znaczenie i może mieć dowolną wartość)

$hInst - uchwyt do instancji modułu z pliku wykonywalnego, który zawiera zasób grafiki rastrowej. Jeżeli chcemy korzystać z zasobów systemowych parametr należy ustawić na -1.

$hID - ID bitmapy z obrazkami przycisków. Przy korzystaniu z zasobów systemowych jest to ID zasobu: $IDB_STD_LARGE_COLOR - duże standardowe ikony $IDB_STD_SMALL_COLOR - małe standardowe ikony $IDB_VIEW_LARGE_COLOR - duże ikony w bardziej kolorowej wersji $IDB_VIEW_SMALL_COLOR - małe ikony w bardziej kolorowej wersji

_GUICtrlToolbar_AddString #include _GUICtrlToolbar_AddString($hToolbar, $sString) Funkcja dodaje nowy string do opisu przycisków paska narzędziowego. Zwraca numer indeksu, lub -1 gdy wystąpił błąd.

Numerowanie rozpoczyna się od 0, kolejno dodawane stringi będą miały indeksy 0, 1, 2, ... itd.

$hToolbar - uchwyt do paska narzędziowego

$hString - string z opisem przycisku

_GUICtrlToolbar_IsButtonPressed #include _GUICtrlToolbar_IsButtonPressed($hToolbar, $iID) Funkcja sprawdza czy został wciśnięty przycisk o podanym ID. Zwraca True gdy przycisk został wciśnięty, lub False gdy nie jest wciśnięty.

$hToolbar - uchwyt do paska narzędziowego

$iID - numer ID przycisku (jest nadawany przez programistę podczas tworzenia przycisku funkcją _GUICtrlToolbar_AddButton)

Tworzenie paska narzędziowego

Omówione powyżej funkcję stanowią podstawę do utworzenia paska narzędziowego z opisanymi przyciskami. Można to zrobić np. tak: #include #include #include #include

$GUI = GUICreate("Test tworzenia paska narzędziowego:", 400, 200) ;tworzenie okna GUI

Local Enum $idOpen=1000, $idSave, $idDelete, $idHlp ;nadanie wartości

$hToolbar = _GUICtrlToolbar_Create($GUI) ;utworzenie paska narzędziowego

;opisy na przyciskach _GUICtrlToolbar_AddString($hToolbar, "Otwórz") _GUICtrlToolbar_AddString($hToolbar, "Zapisz") _GUICtrlToolbar_AddString($hToolbar, "Usuń") _GUICtrlToolbar_AddString($hToolbar, "Pomoc")

;obrazki na przyciskach (korzystamy z zasobów systemowych) _GUICtrlToolbar_AddBitmap($hToolbar, 1, -1, $IDB_VIEW_LARGE_COLOR)

;tworzenie przycisków _GUICtrlToolbar_AddButton($hToolbar, $idOpen, $STD_FILEOPEN, 0) _GUICtrlToolbar_AddButton($hToolbar, $idSave, $STD_FILESAVE, 1) _GUICtrlToolbar_AddButton($hToolbar, $idDelete, $STD_DELETE, 2) _GUICtrlToolbar_AddButtonSep($hToolbar, 12) ;separator _GUICtrlToolbar_AddButtonSep($hToolbar, 0) ;separator _GUICtrlToolbar_AddButton($hToolbar, $idHlp, $STD_HELP, 3)

GUISetState()

Do Select Case _GUICtrlToolbar_IsButtonPressed($hToolbar, $idOpen) MsgBox(0,"Wybrano:","Otwórz",2) Case _GUICtrlToolbar_IsButtonPressed($hToolbar, $idSave) MsgBox(0,"Wybrano:","Zapisz",2) Case _GUICtrlToolbar_IsButtonPressed($hToolbar, $idDelete) MsgBox(0,"Wybrano:","Usuń",2) Case _GUICtrlToolbar_IsButtonPressed($hToolbar, $idHlp) MsgBox(0,"Wybrano:","Pomoc",2) EndSelect Until GUIGetMsg() = $GUI_EVENT_CLOSE

Funkcje dodatkowe _GUICtrlToolbar_Destroy #include _GUICtrlToolbar_Destroy(ByRef $hToolbar) Funkcja usuwa pasek narzędziowy łącznie z wszystkimi przyciskami. Zwraca 1 gdy sukces, lub 0 gdy wystąpił błąd.

$hToolbar - uchwyt do kontrolki zwrócony przez funkcję _GUICtrlToolbar_Create

UWAGA: Funkcja działa tylko na paski narzędziowe utworzone przez _GUICtrlToolbar_Create.

_GUICtrlToolbar_ButtonCount #include _GUICtrlToolbar_ButtonCount($hToolbar) Funkcja zwraca ilość przycisków na pasku narzędziowym.

$hToolbar - uchwyt do paska narzędziowego

UWAGA: Separatory są także zliczane jak zwykłe przyciski.

_GUICtrlToolbar_CheckButton #include _GUICtrlToolbar_CheckButton($hToolbar, $iID [, $fCheck = True]) Funkcja zaznacza lub usuwa zaznaczenie przycisku. Zwraca True gdy sukces, lub False gdy wystąpił błąd.

$hToolbar - uchwyt do paska narzędziowego

$iID - ID przycisku nadane przez programistę

$Check - True - zaznaczanie przycisku (wartość domyślna), False - usunięcie zaznaczenia

Przykład: #include #include #include #include

$GUI = GUICreate("Test:", 200, 200)

Local Enum $idOpen=1000, $idHelp $hToolbar = _GUICtrlToolbar_Create($GUI)

_GUICtrlToolbar_AddString($hToolbar, "Otwórz") _GUICtrlToolbar_AddString($hToolbar, "Pomoc") _GUICtrlToolbar_AddBitmap($hToolbar, 1, -1, $IDB_VIEW_LARGE_COLOR) _GUICtrlToolbar_AddButton($hToolbar, $idOpen, $STD_FILEOPEN, 0) _GUICtrlToolbar_AddButtonSep($hToolbar) _GUICtrlToolbar_AddButton($hToolbar, $idHelp, $STD_HELP, 1)

GUISetState()

Do $msg = GUIGetMsg() _GUICtrlToolbar_CheckButton($hToolbar, $idOpen) Sleep(1000) _GUICtrlToolbar_CheckButton($hToolbar, $idOpen, False) Sleep(1000) Until $msg

_GUICtrlToolbar_PressButton #include _GUICtrlToolbar_PressButton($hToolbar, $iID [, $fPress = True]) Funkcja symuluje wciśnięci (zwolnienie) przycisku w pasku narzędziowym. Zwraca True gdy sukces, lub False gdy wystąpił błąd.

$hToolbar - uchwyt do paska narzędziowego

$iID - ID przycisku nadane przez programistę

$fPress - True (wartość domyślna) oznacza wciśnięcie przycisku, False jego zwolnienie

Przykład: #include #include #include #include

Global Enum $idNew = 1000, $idOpen, $idSave, $idHelp

$hGUI = GUICreate("Toolbar", 600, 400) $hToolbar = _GUICtrlToolbar_Create($hGUI)

_GUICtrlToolbar_AddBitmap($hToolbar, 1, -1, $IDB_STD_LARGE_COLOR)

_GUICtrlToolbar_AddString($hToolbar, "&Nowy") _GUICtrlToolbar_AddString($hToolbar, "&Otwórz") _GUICtrlToolbar_AddString($hToolbar, "&Zapisz") _GUICtrlToolbar_AddString($hToolbar, "&Pomoc")

_GUICtrlToolbar_AddButton($hToolbar, $idNew, $STD_FILENEW, 0) _GUICtrlToolbar_AddButton($hToolbar, $idOpen, $STD_FILEOPEN, 1) _GUICtrlToolbar_AddButton($hToolbar, $idSave, $STD_FILESAVE, 2) _GUICtrlToolbar_AddButtonSep($hToolbar) _GUICtrlToolbar_AddButton($hToolbar, $idHelp, $STD_HELP, 3)

GUISetState()

Sleep(2000) _GUICtrlToolbar_PressButton($hToolbar, $idSave) ;wciśnięcie przycisku If _GUICtrlToolbar_IsButtonPressed($hToolbar, $idSave) Then MsgBox(0, "Test:", _ "Symulacja wciśnięcia przycisku: Zapisz") _GUICtrlToolbar_PressButton($hToolbar, $idSave, False) ;zwolnienie przycisku

Do Until GUIGetMsg() = $GUI_EVENT_CLOSE

_GUICtrlToolbar_SetButtonText #include _GUICtrlToolbar_SetButtonText($hToolbar, $iID, $sText) Funkcja zmienia opis przycisków paska narzędziowego. Zwraca True gdy sukces, lub False gdy wystąpił błąd.

$hToolbar - uchwyt do paska narzędziowego

$iID - ID przycisku nadane przez programistę

$sText - nowy tekst opisu przycisku

UWAGA: Nowy opis powinien być krótszy od pierwotnego, w przeciwnym razie jego część będzie zastąpiona kropkami.

W razie konieczności wydłużyć pierwotny opis dodając na jego końcu odpowiednią ilość spacji.

Przykład: #include #include #include #include

Global Enum $idNew = 1000, $idOpen, $idSave, $idHelp

$hGUI = GUICreate("Toolbar", 600, 400) $hToolbar = _GUICtrlToolbar_Create($hGUI)

_GUICtrlToolbar_AddBitmap($hToolbar, 1, -1, $IDB_STD_LARGE_COLOR)

_GUICtrlToolbar_AddString($hToolbar, "&New") _GUICtrlToolbar_AddString($hToolbar, "&Open ") _GUICtrlToolbar_AddString($hToolbar, "&Save") _GUICtrlToolbar_AddString($hToolbar, "&Help")

_GUICtrlToolbar_AddButton($hToolbar, $idNew, $STD_FILENEW, 0) _GUICtrlToolbar_AddButton($hToolbar, $idOpen, $STD_FILEOPEN, 1) _GUICtrlToolbar_AddButton($hToolbar, $idSave, $STD_FILESAVE, 2) _GUICtrlToolbar_AddButtonSep($hToolbar) _GUICtrlToolbar_AddButton($hToolbar, $idHelp, $STD_HELP, 3)

GUISetState()

Sleep(2000) MsgBox(0, "Test", "Zmiana opisu przycisków") _GUICtrlToolbar_SetButtonText($hToolbar, $idNew, "&Nowy") _GUICtrlToolbar_SetButtonText($hToolbar, $idOpen, "&Otwórz") _GUICtrlToolbar_SetButtonText($hToolbar, $idSave, "&Zapis") _GUICtrlToolbar_SetButtonText($hToolbar, $idHelp, "&Pomoc")

Do Until GUIGetMsg() = $GUI_EVENT_CLOSE

_GUICtrlToolbar_SetStyle #include _GUICtrlToolbar_SetStyle($hToobar, $iStyle) Funkcja ustala styl paska narzędziowego. Zwraca True gdy sukces, lub False gdy wystąpił błąd.

$hToolbar - uchwyt do paska narzędziowego

$iStyle - kod stylu paska $CCS_TOP - pasek na górze $CCS_BOTTOM - pasek na dole $TBSTYLE_TOOLTIPS - pasek może być wielowierszowy (jeżeli przyciski nie mieszczą się w jednym wierszu) $TBSTYLE_FLAT - pasek jednowierszowy, opis pod spodem odrazka $TBSTYLE_LIST - pasek jednowierszowy, opis z prawej strony obrazka $TBSTYLE_TRANSPARENT - pasek przezroczysty Kody można łączyć za pomocą funkcji BitOR, np.: BitOR($TBSTYLE_WRAPABLE, $CCS_TOP).

_GUICtrlToolbar_GetStyle #include _GUICtrlToolbar_GetStyle($hToolbar) Funkcja odczytuje kod stylu paska narzędziowego. Zwraca ten kod lub 0 gdy wystąpił błąd.

$hToolbar - uchwyt do paska narzędziowego

Przykład: #include #include #include #include

Enum $idNew = 1000, $idOpen, $idSave, $idHelp

$hGUI = GUICreate("", 120, 300, 700, 200) $hToolbar = _GUICtrlToolbar_Create($hGUI)

;ustalenie stylu paska _GUICtrlToolbar_SetStyle($hToolbar, BitOR($TBSTYLE_WRAPABLE, $CCS_TOP))

_GUICtrlToolbar_AddBitmap($hToolbar, 1, -1, $IDB_STD_LARGE_COLOR)

$a1 = _GUICtrlToolbar_AddString($hToolbar, "&Nowy") $a2 = _GUICtrlToolbar_AddString($hToolbar, "&Otwórz") $a3 = _GUICtrlToolbar_AddString($hToolbar, "&Zapis")