Kontrolka ToolBar

Właściwości | Zdarzenia | Metody

Kontrolka Toolbar zawiera kolekcję obiektów Button używanych do tworzenia paska narzędziowego (toolbar), który jest skojarzony z aplikacją.

Najczęściej pasek narzędziowy zawiera przyciski, które mają swoje odpowiedniki w menu aplikacji, wprowadzając graficzną reprezentację najczęściej wykorzystywanych funkcji i poleceń.

Kontrolka Toolbar pozwala tworzyć paski narzędziowe przez dodawanie obiektów Button do kolekcji Buttons. Każdy obiekt Button może zawierać tekst, obrazek lub jedno i drugie, przez użycie skojarzonej kontrolki ImageList. Można wyświetlać obrazek na przycisku przez użycie właściwości Image lub wyświetlać tekst przez użycie właściwości Caption dla każdego obiektu Button.
W fazie projektowania można dodawać obiekty Button do kontrolki Toolbar przez użycie Properties Page kontrolki Toolbar. W fazie wykonywania programu można dodawać lub usuwać przyciski z kolekcji Buttons przez użycie metod Add i Remove.

W kodzie programu należy dodać obsługę zdarzenia ButtonClick, aby zareagować na wciśnięcie wybranego przycisku kontrolki Toolbar. Można również określić wygląd każdego obiektu Button przez użycie właściwości Style.

Można tworzyć odstępy pomiędzy kontrolkami na pasku narzędzi przez ustawienie stylu obietku Button na PlaceHolder, a następnie ustawienie kontrolki za nim. Np. aby umieścić listę rozwijaną na pasku narzędziowym, należy w fazie projektowania dodać obiekt Button o stylu ustawionym na PlaceHolder i szerokości odpowiedniej dla kontrolki ComboBox. Następnie należy umieścić kontrolkę ComboBox na tym przycisku.

Podwójne kliknięcie na pasku narzędzi w fazie wykonywania programu powoduje otwarcie okna dialogowego Customize Toolbar, które pozwala użytkownikowi na ukrywanie, wyświetlanie lub zmianę kolejności przycisków paska narzędzi. Aby zezwolić użytkownikowi na modyfikację przycisków paska narzędzi należy ustawić właściwość AllowCustomize kontrolki Toolbar na True. Można również wywołać okno Customize Toolbar przez użycie metody Customize. Aby zachować lub odtworzyć ustawieniac paska narzędzi lub umożliwić użytkownikowi wykonanie tych operacji należy wykorzystać metody SaveToolbar i RestoreToolbar. Zdarzenie Change jest generowane podczas zmian dokonywanych na pasku narzędzi, zwykle jest używane z metodą SaveToolbar.

Okno Customize zawiera przycisk Help. Należy użyć właściwości HelpFile i HelpContextID, aby określić który plik pomocy będzie wyświetlany, gdy użytkownik kliknie przycisk Help

Użytecznym rozszerzeniem jest możliwość używania opisów ToolTipText dla każdego obiektu Button. Aby wyświetlać pomoc ToolTips należy ustawić właściwość ShowTips na True. Podpowiedzi ToolTip wyświetlane są, gdy użytkownik zatrzyma kursor myszki nad przyciskiem.
Po otwarciu okna dialogowego Customize Toolbar kliknięcie przycisku powoduje wyświetlenie opisu w oknie dialogowym. Opis przycisku może być zaprogramowany przez użycie właściwości Description.

Kontrolka Toolbar jest częścią grupy kontrolek ActiveX, które znajdują się w pliku COMCTL32.OCX. Aby używać kontrolki Toolbar, należy dołączyć plik COMCTL32.OCX do projektu. Przy rozpowszechnianiu aplikacji należy instalować plik COMCTL32.OCX w folderze System sytemu Microstoft Windows (System32 w Windows NT).

Właściwości:

Align	sposób wyświetlania obiektu
AllowCustomize	dostosowywanie kontrolki przez użytkownika
Appearance (ActiveX)	wygląd kontrolek
BorderStyle (ActiveX)	rodzaj obramowania
ButtonHeight	wysokość przycisków
Buttons	kolekcja obiektów Button kontrolki
ButtonWidth	szerokość przycisków
Container	pojemnik obiektu
Controls (Toolbar)	kolekcja Controls kontrolki
DataBindings	kolekcja DataBindings kontrolki
DragIcon	wskaźnik przy operacjach drag-and-drop
DragMode	tryb operacji drag-drop
Enabled (ActiveX)	reakcja na zdarzenia użytkownika
Height (ActiveX)	wysokość obiektu
HelpContextID	numer kontekstu obiektu
HelpFile (App, CommonDialog, MenuLine)	plik pomocy kontrolki
hWnd (ActiveX)	uchwyt obiektu
ImageList (ActiveX)	wykorzystana kontrolka ImageList
Index (ActiveX)	numer obiektu w kolekcji
Left (ActiveX)	położenie lewej krawędzi obiektu
MouseIcon	kursor myszki użytkownika
MousePointer (ActiveX)	kursor myszki
Name	identyfikator obiektu
Object (ActiveX)	obiekt w kontrolce
OLEDropMode (ActiveX)	sposób przechwytywania operacji drop
Parent	właściciel obiektu
ShowTips (ActiveX)	pomoc ToolTips przycisków
TabIndex	kolejność przełączania Tab
Tag (ActiveX)	dodatkowe dane obiektu
ToolTipText	podpowiedzi dla użytkownika
Top (ActiveX)	położenie górnej krawędzi obiektu
Visible (ActiveX)	ukrywanie obiektu
WhatsThisHelpID	numer kontekstu pomocy
Width (ActiveX)	szerokość obiektu
Wrappable	przenoszenie przycisków do następnego wiersza

na górę strony...

Zdarzenia:

ButtonClick	kliknięcie przycisku Button
Change (Toolbar, Slider)	zakończenie dostosowywania kontrolki przez użytkownika
Click (ActiveX)	wciśnięcie przycisku myszy
DblClick (ActiveX)	podwójne wciśnięcie przycisku myszy
DragDrop	zakończenie przeciągania obiektu
DragOver	przeciąganie obiektu
MouseDown	wciśnięcie klawisza myszy
MouseMove	przesuwanie wskaźnika myszy
MouseUp	wciśnięcie klawisza myszy
OLECompleteDrag (ActiveX)	poinformowanie komponentu docelowego o zakończeniu operacji OLE drag/drop
OLEDragDrop (ActiveX)	opuszczanie komoponentu źródłowego na docelowym w operacji OLE drag/drop
OLEDragOver (ActiveX)	przeciąganie jednego komponentu nad drugim w operacji OLE drag/drop
OLEGiveFeedback (ActiveX)	zakończono zdarzenie OLEDragOver
OLESetData (ActiveX)	brak danych w odpowiednim formacie dla komponentu docelowego w operacji OLE drag/drop
OLEStartDrag (ActiveX)	zainicjowanie operacji OLE drag/drop

na górę strony...

Metody:

Customize	wywołanie okna dialogowego Customize
Drag	rozpoczęcie, zakończenie lub przerwanie przeciąganie kontrolki
Move	zmiana położenia obiektu
OLEDrag (ActiveX)	rozpoczęcie operacji drag/drop
Refresh (ActiveX)	odświeżenie zawartości obiektu
RestoreToolbar	odtworzenie stanu początkowego kontrolki
SaveToolbar	zapisanie ustawień kontrolki w pliku
ShowWhatsThis	wyświetlenie pomocy What's This?
ZOrder	zmiana kolejności z-order obiektów

na górę strony...