Klasa CToolBar

Artykuł
02/27/2013

Formant słupki wiersz separatory opcjonalnych i przycisków mapy bitowej.

class CToolBar : public CControlBar

Członkowie

Publiczne konstruktory

Nazwa	Opis
CToolBar::CToolBar	Konstrukcje CToolBar obiektu.

Metody publiczne

Nazwa	Opis
CToolBar::CommandToIndex	Zwraca indeks przycisku polecenia danego identyfikatora.
CToolBar::Create	Tworzy narzędzi systemu Windows i dołącza go do CToolBar obiektu.
CToolBar::CreateEx	Tworzy CToolBar dodatkowe style dla osadzonego obiektu CToolBarCtrl obiektu.
CToolBar::GetButtonInfo	Pobiera identyfikator, styl i numer obraz przycisku.
CToolBar::GetButtonStyle	Pobiera styl przycisku.
CToolBar::GetButtonText	Pobiera tekst, który będzie wyświetlany na przycisku.
CToolBar::GetItemID	Zwraca identyfikator polecenia, przycisku lub separator w danym indeksie.
CToolBar::GetItemRect	Pobiera prostokątny obszar wyświetlania dla towaru w danym indeksie.
CToolBar::GetToolBarCtrl	Umożliwia bezpośredni dostęp do podstawowych wspólnej kontroli.
CToolBar::LoadBitmap	Ładuje bitmapy zawierające obrazy bitmapowe przycisku.
CToolBar::LoadToolBar	Ładuje zasobów narzędzi, utworzone za pomocą edytora zasobów.
CToolBar::SetBitmap	Ustawia obraz mapy bitowej.
CToolBar::SetButtonInfo	Określa identyfikator, styl i numer obraz przycisku.
CToolBar::SetButtons	Zestawy przycisk style i indeks przycisk obrazy w obrębie mapy bitowej.
CToolBar::SetButtonStyle	Ustawia styl przycisku.
CToolBar::SetButtonText	Określa tekst, który będzie wyświetlany na przycisku.
CToolBar::SetHeight	Ustawia wysokość paska narzędzi.
CToolBar::SetSizes	Ustawia rozmiarów przycisków i ich bitmapy.

Uwagi

Przyciski mogą działać jak przyciski, przyciski pole wyboru lub przycisków.CToolBarobiekty są członkami zwykle osadzonych obiektów ramki okna pochodną klasy CFrameWnd lub CMDIFrameWnd.

CToolBar::GetToolBarCtrl, funkcja Członkowskie nowe 4.0 MFC pozwala skorzystać z obsługi sterowania wspólnego systemu Windows dla pasków narzędzi i dodatkowe funkcje.CToolBarFunkcje składowe nadać większość funkcji Windows wspólnej kontroli; Jednakże wywołaniu GetToolBarCtrl, paski narzędzi można nadać jeszcze więcej cech paski narzędzi systemu Windows 95 i 98.Po wywołaniu GetToolBarCtrl, zwraca odwołanie do CToolBarCtrl obiektu.Zobacz CToolBarCtrl uzyskać więcej informacji o projektowaniu paski narzędzi przy użyciu wspólnej kontroli systemu Windows.Aby uzyskać informacje ogólne dotyczące wspólnej kontroli, zobacz Wspólnej kontroli w Windows SDK.

Visual C++ oferuje dwie metody tworzenia paska narzędzi.Aby utworzyć zasób narzędzi edytora zasobu, wykonaj następujące kroki:

Utwórz zasób narzędzi.
Konstruowanie CToolBar obiektu.
Wywołanie Tworzenie (lub CreateEx) Funkcja tworzenia narzędzi systemu Windows i dołączyć go do CToolBar obiektu.
Wywołanie LoadToolBar do ładowania zasobów narzędzi.

W przeciwnym razie wykonaj następujące kroki:

Konstruowanie CToolBar obiektu.
Wywołanie Tworzenie (lub CreateEx) Funkcja tworzenia narzędzi systemu Windows i dołączyć go do CToolBar obiektu.
Wywołanie LoadBitmap do ładowania bitmapy, która zawiera obrazy przycisków paska narzędzi.
Wywołanie SetButtons styl przycisku i skojarzyć każdy przycisk obrazu bitmapy.

Wszystkie obrazy przycisków na pasku narzędzi są pobierane z jednej bitmapy, która musi zawierać jeden obraz dla każdego przycisku.Wszystkie obrazy muszą być takie same rozmiary; Wartość domyślna to 16 pikseli szerokości i 15 pikseli.Obrazy należy siebie bitmapy.

SetButtons Funkcja przyjmuje wskaźnik do tablicy kontroli identyfikatory i liczba całkowita określająca liczbę elementów w tablicy.Funkcja ustawia wartość odpowiedniego elementu tablicy identyfikator każdego przycisku i przypisuje przyciskowi indeks obrazu Określa położenie przycisku obrazu bitmapy.Jeśli element tablicy ma wartość ID_SEPARATOR, indeks obrazu nie jest przypisany.

Kolejność obrazów mapy bitowej jest zazwyczaj zamówienia, w którym są rysowane na ekranie, ale można użyć SetButtonInfo funkcji, aby zmienić relacje między kolejność obrazu i kolejność rysowania.

Wszystkie przyciski na pasku narzędzi są tego samego rozmiaru.Wartość domyślna to 24 x 22 piksele zgodnie z Windows interfejsu wskazówki dotyczące projektowania oprogramowania.Dodatkowe miejsce między wymiarami obrazu i przycisk służy do tworzenia obramowania wokół obrazu.

Każdy przycisk ma jeden obraz.Przycisk różnych Państw i style (dół wciśnięty, wyłączone, wyłączony w dół i nieokreśloną) są generowane z jednego obrazu.Chociaż bitmap może być dowolny kolor, można osiągnąć najlepsze wyniki, obrazami w czerni i odcieni szarości.

Przestroga
CToolBarobsługuje mapy bitowe maksymalnie 16 kolorów.Po załadowaniu obrazu do narzędzi edytora Visual Studio automatycznie konwertuje obraz bitmapy 16 kolorów, jeśli to konieczne i wyświetla ostrzeżenie, jeśli obraz został przekonwertowany.Użyć obrazu z więcej niż 16 kolorów (przy użyciu edytora zewnętrznego do edycji obrazu), aplikacja może być nieoczekiwane zachowanie.

Przyciski paska narzędzi naśladowania przyciski domyślnie.Przyciski paska narzędzi można jednak również naśladowania przycisków pole wyboru lub przycisków radiowych.Pole wyboru, przyciski mają trzy stany: checked, wyczyszczone i nieokreślona.Przyciski radiowe mają tylko dwa stany: zaznaczone i wyczyszczone.

Aby ustawić przycisk indywidualnych lub separator stylu bez wskazując tablicy, należy wywołać GetButtonStyle do pobierania stylu, a następnie wywołać SetButtonStyle zamiast SetButtons.SetButtonStylejest najbardziej użyteczna, gdy chcesz zmienić styl przycisku w czasie wykonywania.

Aby przypisać tekst wyświetlany na przycisku, wywołanie GetButtonText pobrać tekst wyświetlany na przycisku, a następnie wywołać SetButtonText , aby ustawić tekst.

Aby utworzyć przycisk pole wyboru, należy przypisać mu styl TBBS_CHECKBOX lub CCmdUI obiektu SetCheck Członkowskich funkcji w ON_UPDATE_COMMAND_UI obsługi.Wywołanie SetCheck z przyciskiem zmieni się w przycisk pole wyboru.Przekazać SetCheck argumentu 0 dla 1 jest niezaznaczone, zaznaczone lub 2 dla nieokreślonego.

Aby utworzyć przycisk radiowy, call CCmdUI obiektu SetRadio Członkowskich funkcję z ON_UPDATE_COMMAND_UI obsługi.Przekazać SetRadio argument 0 niezerową skontrolowanych lub niezaznaczone.Aby zapewnić zachowanie wykluczają grupy opcji, musisz mieć ON_UPDATE_COMMAND_UI obsługi dla wszystkich przycisków w grupie.

Aby uzyskać więcej informacji na temat używania CToolBar, zobacz artykuł Wdrożenia narzędzi MFC i technicznych 31 Uwaga: pasków.