Klasa CToolBarCtrl

Artykuł
02/27/2013

Udostępnia funkcje kontroli wspólnych narzędzi systemu Windows.

class CToolBarCtrl : public CWnd

Członkowie

Publiczne konstruktory

Nazwa	Opis
CToolBarCtrl::CToolBarCtrl	Konstrukcje CToolBarCtrl obiektu.

Metody publiczne

Nazwa	Opis
CToolBarCtrl::AddBitmap	Obrazy przycisków bitmapy dodaje do listy dostępnych dla formantu toolbar obrazy przycisków.
CToolBarCtrl::AddButtons	Dodaje jeden lub więcej przycisków do formantu toolbar.
CToolBarCtrl::AddString	Dodaje nowy ciąg przekazywany jako identyfikator zasobu, na pasku narzędzi listy wewnętrznej ciągów.
CToolBarCtrl::AddStrings	Dodaje nowy ciąg lub ciągi przekazane jako wskaźnik do buforu ciągów oddzielone null, do wewnętrznej listy ciągów pasku narzędzi.
CToolBarCtrl::AutoSize	Zmienia rozmiar formantu toolbar.
CToolBarCtrl::ChangeBitmap	Zmienia bitmapy przycisku w bieżącym formantu toolbar.
CToolBarCtrl::CheckButton	Kontrole lub czyści danego przycisku w formancie toolbar.
CToolBarCtrl::CommandToIndex	Pobiera wyświetlanego na przycisku skojarzony z identyfikatorem określonego polecenia.
CToolBarCtrl::Create	Tworzy formant paska narzędzi i dołącza go do CToolBarCtrl obiektu.
CToolBarCtrl::CreateEx	Tworzy formant paska narzędzi w określonym stylu rozszerzonego systemu Windows i dołącza go do CToolBarCtrl obiektu.
CToolBarCtrl::Customize	Wyświetla okno dialogowe Dostosuj pasek narzędzi.
CToolBarCtrl::DeleteButton	Usuwa przycisk z formantu toolbar.
CToolBarCtrl::EnableButton	Włącza lub wyłącza przycisk określony w formancie toolbar.
CToolBarCtrl::GetAnchorHighlight	Pobiera podświetlenie kontrolnych dla paska narzędzi.
CToolBarCtrl::GetBitmap	Pobiera indeks bitmapy skojarzone z przycisku na pasku narzędzi.
CToolBarCtrl::GetBitmapFlags	Pobiera flagi skojarzone z narzędzi bitmapowych.
CToolBarCtrl::GetButton	Pobiera informacje o określony przycisk w formancie toolbar.
CToolBarCtrl::GetButtonCount	Pobiera liczba przycisków aktualnie w formancie toolbar.
CToolBarCtrl::GetButtonInfo	Pobiera informacje dla przycisku na pasku narzędzi.
CToolBarCtrl::GetButtonSize	Pobiera bieżący szerokość i wysokość w pikselach przyciski paska narzędzi.
CToolBarCtrl::GetColorScheme	Pobiera schemat kolorów bieżącego formantu toolbar.
CToolBarCtrl::GetDisabledImageList	Pobiera listę obrazu formantu toolbar używa do wyświetlania wyłączone przycisków.
CToolBarCtrl::GetDropTarget	Pobiera IDropTarget interfejsu dla formantu toolbar.
CToolBarCtrl::GetExtendedStyle	Pobiera extended style dla formantu toolbar.
CToolBarCtrl::GetHotImageList	Pobiera listę obrazu formantu toolbar używa do wyświetlania przycisków "hot".Pojawia się przycisk hot wyróżnione, gdy wskaźnik myszy znajduje się nad nim.
CToolBarCtrl::GetHotItem	Pobiera indeks hot elementu na pasku narzędzi.
CToolBarCtrl::GetImageList	Pobiera listę formantu toolbar używa do wyświetlania przycisków w ich stanu domyślnego obrazu.
CToolBarCtrl::GetInsertMark	Pobiera bieżący znacznik wstawiania na pasku narzędzi.
CToolBarCtrl::GetInsertMarkColor	Pobiera kolor używany do wstawiania znaku paska narzędzi Rysowanie.
CToolBarCtrl::GetItemRect	Pobiera prostokąta obwiedni przycisk w formancie toolbar.
CToolBarCtrl::GetMaxSize	Pobiera całkowity rozmiar wszystkich widocznych przycisków i separatory w pasku narzędzi.
CToolBarCtrl::GetMaxTextRows	Pobiera maksymalna liczba wierszy tekst wyświetlany na przycisku paska narzędzi.
CToolBarCtrl::GetMetrics	Pobiera metryki formantu toolbar.
CToolBarCtrl::GetPadding	Pobiera dopełnienie poziome i pionowe bieżącego formantu toolbar.
CToolBarCtrl::GetPressedImageList	Pobiera listę obrazu używa bieżącego formantu toolbar do reprezentowania wciśnięte przyciski.
CToolBarCtrl::GetRect	Pobiera prostokąta obwiedni dla przycisku określony pasek narzędzi.
CToolBarCtrl::GetRows	Pobiera liczbę wierszy przycisków aktualnie wyświetlane na pasku narzędzi.
CToolBarCtrl::GetState	Pobiera informacje o stanie określonego przycisku w formant paska narzędzi, na przykład jest włączona, naciśnięty czy zaznaczone.
CToolBarCtrl::GetString	Pobiera ciąg narzędzi.
CToolBarCtrl::GetStyle	Pobiera style aktualnie w użyciu dla formantu toolbar.
CToolBarCtrl::GetToolTips	Pobiera uchwyt sterowania Porada narzędzia, jeśli, skojarzone z formantu toolbar.
CToolBarCtrl::HideButton	Ukrywa lub pokazuje określony przycisk w formancie toolbar.
CToolBarCtrl::HitTest	Określa, gdzie punkt leży w formancie toolbar.
CToolBarCtrl::Indeterminate	Ustawia lub czyści nieokreśloną (szare) stan określony przycisk w formancie toolbar.
CToolBarCtrl::InsertButton	Wstawia przycisk formantu toolbar.
CToolBarCtrl::InsertMarkHitTest	Pobiera informacje znacznik wstawiania dla punktu na pasku narzędzi.
CToolBarCtrl::IsButtonChecked	Informuje, czy określony przycisk w formancie pasek narzędzi jest zaznaczony.
CToolBarCtrl::IsButtonEnabled	Informuje, czy włączone jest określony przycisk w formancie toolbar.
CToolBarCtrl::IsButtonHidden	Informuje, czy określony przycisk w formancie pasek narzędzi jest ukryty.
CToolBarCtrl::IsButtonHighlighted	Sprawdza stan podświetlenia przycisku paska narzędzi.
CToolBarCtrl::IsButtonIndeterminate	Informuje, czy stan określony przycisk w formancie toolbar jest nieokreślona (szarym).
CToolBarCtrl::IsButtonPressed	Informuje, czy określony przycisk w formancie pasek narzędzi jest wciśnięty.
CToolBarCtrl::LoadImages	Ładuje bitmap do listy obrazu formantu toolbar.
CToolBarCtrl::MapAccelerator	Znak akcelerator mapy do przycisku paska narzędzi.
CToolBarCtrl::MarkButton	Ustawia stan wyróżnienia danego przycisku w formancie toolbar.
CToolBarCtrl::MoveButton	Przenosi przycisk z jednym indeksie do innego.
CToolBarCtrl::PressButton	Nacionie klawisz lub zwalnia określony przycisk w formancie toolbar.
CToolBarCtrl::ReplaceBitmap	Zastępuje istniejące bitmapy w bieżącym formantu toolbar nowej bitmapy.
CToolBarCtrl::RestoreState	Przywraca stan formantu toolbar.
CToolBarCtrl::SaveState	Zapisuje stan formantu toolbar.
CToolBarCtrl::SetAnchorHighlight	Ustawienie rozjaśnienia kontrolnych dla paska narzędzi.
CToolBarCtrl::SetBitmapSize	Ustawia rozmiar obrazów bitowych ma zostać dodany do formantu toolbar.
CToolBarCtrl::SetButtonInfo	Ustawia informacje dotyczące istniejącego przycisku na pasku narzędzi.
CToolBarCtrl::SetButtonSize	Ustawia rozmiar przycisków, które mają zostać dodane do formantu toolbar.
CToolBarCtrl::SetButtonStructSize	Określa rozmiar TBBUTTON struktury.
CToolBarCtrl::SetButtonWidth	Ustawia szerokość minimalną i maksymalną przycisk formantu toolbar.
CToolBarCtrl::SetCmdID	Ustawia identyfikator polecenia wysyłane do okna właściciela, po naciśnięciu przycisku określony.
CToolBarCtrl::SetColorScheme	Ustawia schemat kolorów bieżącego formantu toolbar.
CToolBarCtrl::SetDisabledImageList	Ustawia listy obrazów, używające formantu toolbar przycisków wyświetlania wyłączone.
CToolBarCtrl::SetDrawTextFlags	Ustawia flagi w funkcji Win32 DrawText, który jest używany do rysowania tekst w określonego prostokąta sformatowane zgodnie z konfiguracji flag.
CToolBarCtrl::SetExtendedStyle	Ustawia extended style dla formantu toolbar.
CToolBarCtrl::SetHotImageList	Ustawia listę obrazu, który formantu toolbar będzie używany do wyświetlania przycisków "na gorąco".
CToolBarCtrl::SetHotItem	Ustawia hot element paska narzędzi.
CToolBarCtrl::SetImageList	Ustawia listę obraz używany do wyświetlania przycisków, które są w stanie ich domyślne paska narzędzi.
CToolBarCtrl::SetIndent	Ustawia wcięcia pierwszego przycisku w formancie toolbar.
CToolBarCtrl::SetInsertMark	Ustawia bieżący znacznik wstawiania na pasku narzędzi.
CToolBarCtrl::SetInsertMarkColor	Ustawia kolor używany do wstawiania znaku paska narzędzi Rysowanie.
CToolBarCtrl::SetMaxTextRows	Ustawia maksymalną liczbę wierszy tekstu, wyświetlany na przycisku paska narzędzi.
CToolBarCtrl::SetMetrics	Ustawia metryki formantu toolbar.
CToolBarCtrl::SetOwner	Ustawia okna odbierania wiadomości powiadomień z formantu toolbar.
CToolBarCtrl::SetPadding	Ustawia poziomy i pionowy dopełnienie bieżącego formantu toolbar.
CToolBarCtrl::SetPressedImageList	Ustawia listę obrazu, który używa bieżącego formantu toolbar do reprezentowania wciśnięte przyciski.
CToolBarCtrl::SetRows	Ustawia liczbę wierszy przycisków wyświetlanych na pasku narzędzi.
CToolBarCtrl::SetState	Ustawia stan przycisku określonego formantu toolbar.
CToolBarCtrl::SetStyle	Ustawia style dla formantu toolbar.
CToolBarCtrl::SetToolTips	Kojarzy formant Porada narzędzia z formantu toolbar.
CToolBarCtrl::SetWindowTheme	Ustawia styl wizualny formantu toolbar.

Uwagi

Ten formant (a zatem CToolBarCtrl klasy) jest dostępna tylko dla programów działających w systemie Windows 95 i 98 i Windows NT w wersji 3.51 i później.

Kontroli wspólnych narzędzi systemu Windows jest okno prostokątne dziecka, zawierający jeden lub więcej przycisków.Przyciski te można wyświetlić obrazu bitmapowego lub ciąg.Po wybraniu przycisku wysyła komunikat polecenia na pasku narzędzi okna właściciela.Zazwyczaj przycisków na pasku narzędzi odpowiadają elementom menu aplikacji; zapewniają one bardziej bezpośredni sposób uzyskiwać dostęp do poleceń aplikacji użytkownika.

CToolBarCtrlobiekty zawierają kilka ważnych wewnętrznych struktur danych: listy przycisk obrazu bitmapy lub listy obrazów, lista ciągów Etykieta przycisku i listę TBBUTTON struktur, które skojarzyć obrazu string ze stanowiska, styl, Państwa i identyfikator przycisku polecenia.Każdy z elementów tych struktur danych jest określone przez indeksu.Przed użyciem CToolBarCtrl obiektu, należy zdefiniować te struktury danych.Lista ciągów można tylko dla etykiety przycisków; nie można pobrać ciągów z paska narzędzi.

Aby użyć CToolBarCtrl obiektu, będzie zazwyczaj wykonaj następujące kroki:

Konstruowanie CToolBarCtrl obiektu.
Wywołanie Tworzenie kontroli wspólnych narzędzi Windows utwórz i dołącz ją do CToolBarCtrl obiektu.Wskazuje styl paska narzędzi przy użyciu stylów, takich jak TBSTYLE_TRANSPARENT dla narzędzi przezroczysty lub TBSTYLE_DROPDOWN dla obsługującego rozwijanej styl przycisków paska narzędzi.
Określenie sposobu przycisków na pasku narzędzi wyświetlane:
- Aby użyć przycisków obrazów bitmapowych, Dodawanie bitmap przycisk do paska narzędzi, wywołując AddBitmap.
- Aby użyć obrazów wyświetlanych na liście obrazu dla przycisków, należy określić listę obrazu wywołując SetImageList, SetHotImageList, lub SetDisabledImageList.
- Aby użyć ciąg etykiety przycisków, Dodaj ciągi do paska narzędzi, wywołując Addstring() lub AddStrings.
Dodać struktur przycisk do paska narzędzi, wywołując AddButtons.
Jeśli chcesz podpowiedzi dla przycisku paska narzędzi w oknie właściciela, który nie jest CFrameWnd, potrzebne do obsługi TTN_NEEDTEXT w pasku narzędzi okna właściciela wiadomości, jak opisano w Powiadomienia Porada narzędzia obsługi.Jeśli okno nadrzędne paska narzędzi jest pochodną CFrameWnd, etykietki narzędzi są wyświetlane bez żadnych dodatkowych nakładu pracy od Ciebie, ponieważ CFrameWnd zawiera domyślny program obsługi.
Użytkownikowi można dostosować pasek narzędzi, należy obsługiwać dostosowywania wiadomości powiadomień w oknie właściciela opisane w Powiadomień obsługi dostosowywania.

Można użyć SaveState zapisać bieżący stan formantu toolbar w rejestrze i RestoreState do przywrócenia stanu na podstawie informacji przechowywanych wcześniej w rejestrze.Poza zapisaniem Państwo narzędzi między używa aplikacji, aplikacje zwykle przechowywać stanu, zanim użytkownik rozpocznie Dostosowywanie paska narzędzi, w przypadku, gdy użytkownik chce później przywrócić oryginalny stan paska narzędzi.

Wsparcie dla Internet Explorer w wersji 4.0 i nowszych

Do obsługi funkcji wprowadzonych w programie Internet Explorer w wersji 4.0 i nowszych, MFC zapewnia listy obrazu oraz przejrzyste i płaskie style dla formantów z paska narzędzi.

Przezroczyste narzędzi pozwala klientowi widoczne pod paskiem narzędzi.Do tworzenia narzędzi przezroczyste, należy używać obu TBSTYLE_FLAT i TBSTYLE_TRANSPARENT style.Paski przezroczyste funkcji śledzenia gorąco; oznacza to, że podczas przesuwania wskaźnika myszy nad przyciskiem hot na pasku narzędzi zmienia wygląd przycisku.Paski narzędzi utworzone za pomocą tylko na TBSTYLE_FLAT styl będzie zawierać przyciski, które nie są przezroczyste.

Obsługa listy obrazów umożliwia większą elastyczność kontroli zachowanie domyślne, hot obrazów i obrazy wyłączone.Użyj GetImageList, GetHotImageList, i GetDisabledImageList z przezroczyste narzędzi do manipulowania obrazka stanu:

Aby uzyskać więcej informacji na temat używania CToolBarCtrl, zobacz kontroli i Za pomocą CToolBarCtrl.