img/mfc2.jpg

CToolBarCtrl


Opis

Pasek narzędzi jest to prostokątne okno ze stylem WS_CHILD, które zawiera jeden lub więcej przycisków. Przyciski te mogą wyświetlać bitmapy, napisy lub bitmapę z napisem. Kiedy użytkownik wybiera przycisk, pasek narzędzi wysyła komunikat do właściciela paska narzędzi. Normalnie przyciski na pasku narzędzi odpowiadają komendom zawartym w menu aplikacji.

Obiekt CToolBarCtrl zawiera kilka wewnętrzyn struktur danych: listę bitmap przycisków, listę napisów przycisków, oraz listę kojarzącą dany przycisk z komendą w menu.

W celu stworzenia własnego paska narzędzi należy wykonać następujące kroki:

  1. Utworzyć obiekt CToolBarCtrl.
  2. Wywołać metodę Create w celu utworzenia standardowego paska narzędzi i skojarzenia go z obiektem CToolBarCtrl.
  3. Zdecydować się na jeden ze sposobów wyświetlania przycisków na pasku narzędzi:
  4. Dodaj strukturę przycisków do paska narzędzi poprzez wywołanie metody AddButtons.

Możesz użyć metody SaveState w celu zapisania bieżącego ustawienia paska narzędzi w rejestrach. Aby odzyskać zapisane informacje należy wywołać metodę RestoreState.

Metody

Metody Opis
CToolBarCtrlKOnstruktor obiektu CToolBarCtrl.
CreateTworzy standardowy pasek narzędzi Windows i kojarzy go z obiektem CToolBarCtrl.
IsButtonEnabledSprawdza czy zadany przycisk jest dostępny.
IsButtonCheckedSprawdza czy zadany przycisk jest zaznaczony.
IsButtonPressedSprawdza czy zadany przycisk jest wciśnięty.
IsButtonHiddenSprawdza czy zadany przycisk jest ukryty.
SetStateUstawia stan przycisku.
GetStatePobiera stan przycisku.
GetButtonPobiera informacje o przycisku.
GetButtonCountZwraca liczbę przycisków na pasku narzędzi.
GetButtonSizeZwraca wymiar przycisku w pikselach.
SetButtonSizeUstawia wymiar przycisku w pikselach.
SetBitmapSizeUstala wymiar wyświetlanej bitmapy.
SetRowsUstala liczbę wierszy wyświetlanych przycisków.
GetRowsZwraca liczbę wierszy wyświetlanych przycisków.
GetImageListZwraca litę obrazków wykorzystywaną do wyświetlania obrazków na przyciskach.
SetButtonWidthUstala szerokość przycisku.
SetImageListKojarzy listę obrazków z paskiem narzędzi.
EnableButtonWłącza lub wyłącza przycisk.
CheckButtonZaznacza lub odznacza przycisk.
PressButtonWciska lub zwalnia przycisk.
GetButtonInfoZwraca informacje o przycisku.
SetButtonInfoZapisuje informacje o przycisku.
HideButtonUkrywa lub pokazuje przycisk.
AddBitmapDodaje jeden lub wiele przycisków z bitmapą.
AddButtonsDodaje jeden lub kilka przycisków.
InsertButtonWstawia przycisk na określonej pozycji.
DeleteButtonUsuwa przycisk z paska narzędzi.
LoadImagesŁaduje bitmapy do listy obrazków.
AddStringDodaje napis z zasobów do listy napisów.
AddStringsDdodaje napisy do listy napisów.
AutoSizeZmienia wymiary paska narzędzi.

Hierarchia

img/hr_ctoolbarctrl.gif