`CMFCToolBar` Klasa

Artykuł
06/16/2023

Klasa CMFCToolBar przypomina klasę CToolBar Class, ale zapewnia dodatkową obsługę funkcji interfejsu użytkownika. Obejmują one płaskie paski narzędzi, paski narzędzi z gorącymi obrazami, duże ikony, przyciski pagera, zablokowane paski narzędzi, kontrolki paska pomocniczego, tekst pod obrazami, obrazy tła i paski narzędzi z kartami. Klasa CMFCToolBar zawiera również wbudowaną obsługę dostosowywania użytkowników pasków narzędzi i menu, przeciągania i upuszczania między paskami narzędzi i menu, przyciskami pól kombi, przyciskami edycji pól, selektorami kolorów i przyciskami zestawienia.

Aby uzyskać więcej szczegółów, zobacz kod źródłowy znajdujący się w instalacji programu Visual Studio, na przykład %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Składnia

class CMFCToolBar : public CMFCBaseToolBar

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
`CMFCToolBar::CMFCToolBar`	Konstruktor domyślny.
`CMFCToolBar::~CMFCToolBar`	Destruktor.

Metody publiczne

Nazwa/nazwisko	opis
`CMFCToolBar::AddBasicCommand`	Dodaje polecenie menu do listy poleceń, które są zawsze wyświetlane po otwarciu menu przez użytkownika.
`CMFCToolBar::AddCommandUsage`	Zwiększa się o jeden licznik skojarzony z danym poleceniem.
`CMFCToolBar::AddToolBarForImageCollection`	Dodaje obrazy z zasobów interfejsu użytkownika do kolekcji obrazów w aplikacji.
`CMFCToolBar::AdjustLayout`	Oblicza ponownie rozmiar i położenie paska narzędzi. (Przesłonięcia `CBasePane::AdjustLayout`).
`CMFCToolBar::AdjustSize`	Oblicza ponownie rozmiar paska narzędzi.
`CMFCToolBar::AllowChangeTextLabels`	Określa, czy etykiety tekstowe mogą być wyświetlane na obrazach na przyciskach paska narzędzi.
`CMFCToolBar::AreTextLabels`	Określa, czy etykiety tekstowe w obszarze obrazów są obecnie wyświetlane na przyciskach paska narzędzi.
`CMFCToolBar::AutoGrayInactiveImages`	Włącza lub wyłącza automatyczne generowanie nieaktywnych obrazów przycisków.
`CMFCToolBar::ButtonToIndex`	Zwraca indeks określonego `CMFCToolBarButton` obiektu Klasy na tym pasku narzędzi.
`CMFCToolBar::CalcFixedLayout`	Oblicza rozmiar poziomy paska narzędzi. (Przesłania `CBasePane::CalcFixedLayout`).
`CMFCToolBar::CalcSize`	Wywoływana przez platformę w ramach procesu obliczania układu. (Przesłania `CPane::CalcSize`).
`CMFCToolBar::CanHandleSiblings`	Określa, czy pasek narzędzi i jego element równorzędny są umieszczone w tym samym okienku.
`CMFCToolBar::CleanUpImages`	Zwalnia zasoby systemowe przydzielone dla obrazów paska narzędzi.
`CMFCToolBar::CleanUpLockedImages`	Zwalnia zasoby systemowe przydzielone dla zablokowanych obrazów paska narzędzi.
`CMFCToolBar::CanBeClosed`	Określa, czy użytkownik może zamknąć pasek narzędzi. (Przesłania `CBasePane::CanBeClosed`).
`CMFCToolBar::CanBeRestored`	Określa, czy system może przywrócić pasek narzędzi do pierwotnego stanu po dostosowaniu.
`CMFCToolBar::CanFocus`	Określa, czy okienko może odbierać fokus. (Przesłania `CBasePane::CanFocus`).
`CMFCToolBar::CanHandleSiblings`	Określa, czy pasek narzędzi i jego element równorzędny są umieszczone w tym samym okienku.
`CMFCToolBar::CommandToIndex`	Zwraca indeks przycisku na pasku narzędzi z określonym identyfikatorem polecenia.
`CMFCToolBar::Create`	Tworzy obiekt `CMFCToolBar`.
`CMFCToolBar::CreateEx`	Tworzy `CMFCToolBar` obiekt, który używa dodatkowych opcji stylu, takich jak duże ikony.
`CMFCToolBar::Deactivate`	Dezaktywuje pasek narzędzi.
`CMFCToolBar::EnableCustomizeButton`	Włącza lub wyłącza przycisk Dodaj lub Usuń przyciski , który jest wyświetlany na końcu paska narzędzi.
`CMFCToolBar::EnableDocking`	Umożliwia zadokowanie okienka do ramki głównej. (Przesłania `CBasePane::EnableDocking`).
`CMFCToolBar::EnableLargeIcons`	Włącza lub wyłącza duże ikony na przyciskach paska narzędzi.
`CMFCToolBar::EnableQuickCustomization`	Włącza lub wyłącza szybkie dostosowywanie pasków narzędzi, aby użytkownik mógł nacisnąć Alt i przeciągnąć przycisk do nowej lokalizacji.
`CMFCToolBar::EnableReflections`	Włącza lub wyłącza odbicie poleceń.
`CMFCToolBar::EnableTextLabels`	Włącza lub wyłącza etykiety tekstowe w obszarze obrazów przycisków paska narzędzi.
`CMFCToolBar::FromHandlePermanent`	Pobiera wskaźnik do `CMFCToolBar` obiektu zawierającego dany uchwyt okna.
`CMFCToolBar::GetAllButtons`	Zwraca listę przycisków tylko do odczytu na pasku narzędzi.
`CMFCToolBar::GetAllToolbars`	Zwraca listę tylko do odczytu wszystkich pasków narzędzi w aplikacji.
`CMFCToolBar::GetBasicCommands`	Zwraca listę poleceń podstawowych zdefiniowanych w aplikacji w trybie tylko do odczytu.
`CMFCToolBar::GetButton`	Zwraca wskaźnik do `CMFCToolBarButton` obiektu, który ma określony indeks przycisku paska narzędzi.
`CMFCToolBar::GetButtonInfo`	Zwraca identyfikator polecenia, styl i indeks obrazu przycisku w określonym indeksie.
`CMFCToolBar::GetButtonSize`	Zwraca wymiary każdego przycisku na pasku narzędzi.
`CMFCToolBar::GetButtonStyle`	Zwraca bieżący styl przycisku paska narzędzi, który znajduje się w określonym indeksie.
`CMFCToolBar::GetButtonText`	Zwraca etykietę tekstową przycisku, który ma określony indeks.
`CMFCToolBar::GetColdImages`	Zwraca wskaźnik do kolekcji zimnych obrazów przycisków paska narzędzi w aplikacji.
`CMFCToolBar::GetColumnWidth`	Zwraca szerokość przycisków paska narzędzi.
`CMFCToolBar::GetCommandButtons`	Zwraca listę przycisków, które mają określony identyfikator polecenia ze wszystkich pasków narzędzi w aplikacji.
`CMFCToolBar::GetCount`	Zwraca liczbę przycisków i separatorów na pasku narzędzi.
`CMFCToolBar::GetCustomizeButton`	Pobiera wskaźnik do obiektu skojarzonego `CMFCCustomizeButton` z paskiem narzędzi.
`CMFCToolBar::GetDefaultImage`	Zwraca indeks obrazu domyślnego dla przycisku paska narzędzi z określonym identyfikatorem polecenia.
`CMFCToolBar::GetDisabledImages`	Zwraca wskaźnik do kolekcji obrazów używanych dla wyłączonych przycisków paska narzędzi w aplikacji.
`CMFCToolBar::GetDisabledMenuImages`	Zwraca wskaźnik do kolekcji obrazów używanych dla wyłączonych przycisków menu w aplikacji.
`CMFCToolBar::GetDroppedDownMenu`	Pobiera wskaźnik do obiektu przycisku menu, który jest obecnie wyświetlany w menu podrzędnym.
`CMFCToolBar::GetGrayDisabledButtons`	Określa, czy obrazy wyłączonych przycisków są wygaszone wersje zwykłych obrazów przycisków, czy pobrane z kolekcji wyłączonych obrazów przycisków.
`CMFCToolBar::GetHighlightedButton`	Zwraca wskaźnik do przycisku paska narzędzi, który jest obecnie wyróżniony.
`CMFCToolBar::GetHotBorder`	Określa, czy przyciski paska narzędzi są śledzone na gorąco.
`CMFCToolBar::GetHotTextColor`	Zwraca kolor tekstu wyróżnionych przycisków paska narzędzi.
`CMFCToolBar::GetHwndLastFocus`	Zwraca uchwyt do okna z fokusem wejściowym tuż przed wykonaniem paska narzędzi.
`CMFCToolBar::GetIgnoreSetText`	Określa, czy wywołania ustawiania etykiet przycisków są ignorowane.
`CMFCToolBar::GetImageSize`	Zwraca bieżący rozmiar obrazów przycisków paska narzędzi.
`CMFCToolBar::GetImages`	Zwraca wskaźnik do kolekcji domyślnych obrazów przycisków w aplikacji.
`CMFCToolBar::GetImagesOffset`	Zwraca przesunięcie indeksu używane do znajdowania obrazów przycisków paska narzędzi dla tego paska narzędzi na globalnej liście obrazów przycisków paska narzędzi.
`CMFCToolBar::GetInvalidateItemRect`	Pobiera region obszaru klienta, który musi być ponownie rysowane dla przycisku w danym indeksie.
`CMFCToolBar::GetItemID`	Zwraca identyfikator polecenia przycisku paska narzędzi w określonym indeksie.
`CMFCToolBar::GetItemRect`	Zwraca prostokąt ograniczenia przycisku w określonym indeksie.
`CMFCToolBar::GetLargeColdImages`	Zwraca wskaźnik do kolekcji dużych zimnych obrazów przycisków paska narzędzi w aplikacji.
`CMFCToolBar::GetLargeDisabledImages`	Zwraca wskaźnik do kolekcji dużych wyłączonych obrazów przycisków paska narzędzi w aplikacji.
`CMFCToolBar::GetLargeImages`	Zwraca wskaźnik do kolekcji obrazów przycisków dużego paska narzędzi w aplikacji.
`CMFCToolBar::GetLockedColdImages`	Zwraca wskaźnik do kolekcji zablokowanych zimnych obrazów na pasku narzędzi.
`CMFCToolBar::GetLockedDisabledImages`	Zwraca wskaźnik do kolekcji zablokowanych obrazów wyłączonych na pasku narzędzi.
`CMFCToolBar::GetLockedImages`	Zwraca wskaźnik do kolekcji zablokowanych obrazów przycisków na pasku narzędzi.
`CMFCToolBar::GetLockedImageSize`	Zwraca domyślny rozmiar zablokowanych obrazów paska narzędzi.
`CMFCToolBar::GetLockedMenuImages`	Zwraca wskaźnik do kolekcji zablokowanych obrazów menu paska narzędzi na pasku narzędzi.
`CMFCToolBar::GetMenuButtonSize`	Zwraca rozmiar przycisków menu w aplikacji.
`CMFCToolBar::GetMenuImageSize`	Zwraca rozmiar obrazów przycisków menu w aplikacji.
`CMFCToolBar::GetMenuImages`	Zwraca wskaźnik do kolekcji obrazów przycisków menu w aplikacji.
`CMFCToolBar::GetOrigButtons`	Pobiera kolekcję przycisków, które nie są dostosowane na pasku narzędzi.
`CMFCToolBar::GetOrigResetButtons`	Pobiera kolekcję niestandardowych przycisków resetowania paska narzędzi.
`CMFCToolBar::GetResourceID`	Pobiera identyfikator zasobu paska narzędzi.
`CMFCToolBar::GetRouteCommandsViaFrame`	Określa, który obiekt, ramka nadrzędna lub właściciel, wysyła polecenia do paska narzędzi.
`CMFCToolBar::GetRowHeight`	Zwraca wysokość przycisków paska narzędzi.
`CMFCToolBar::GetShowTooltips`	Określa, czy dla przycisków paska narzędzi są wyświetlane porady dotyczące narzędzi.
`CMFCToolBar::GetSiblingToolBar`	Pobiera element równorzędny paska narzędzi.
`CMFCToolBar::GetUserImages`	Zwraca wskaźnik do kolekcji obrazów przycisków paska narzędzi zdefiniowanych przez użytkownika w aplikacji.
`CMFCToolBar::HitTest`	Zwraca indeks przycisku paska narzędzi, który znajduje się w określonej pozycji.
`CMFCToolBar::InsertButton`	Wstawia przycisk na pasku narzędzi.
`CMFCToolBar::InsertSeparator`	Wstawia separator do paska narzędzi.
`CMFCToolBar::InvalidateButton`	Unieważnia obszar klienta przycisku paska narzędzi, który istnieje w podanym indeksie.
`CMFCToolBar::IsAddRemoveQuickCustomize`	Określa, czy użytkownik może dodawać lub usuwać przyciski paska narzędzi przy użyciu opcji menu Dostosuj .
`CMFCToolBar::IsAltCustomizeMode`	Określa, czy szybkie dostosowywanie jest używane do przeciągania przycisku.
`CMFCToolBar::IsAutoGrayInactiveImages`	Określa, czy włączono automatyczne generowanie nieaktywnych (nie wyróżnionych) obrazów przycisków.
`CMFCToolBar::IsBasicCommand`	Określa, czy polecenie znajduje się na liście podstawowych poleceń.
`CMFCToolBar::IsButtonExtraSizeAvailable`	Określa, czy pasek narzędzi może wyświetlać przyciski, które mają rozszerzone obramowania.
`CMFCToolBar::IsButtonHighlighted`	Określa, czy przycisk na pasku narzędzi jest wyróżniony.
`CMFCToolBar::IsCommandPermitted`	Określa, czy polecenie jest dozwolone.
`CMFCToolBar::IsCommandRarelyUsed`	Określa, czy polecenie jest rzadko używane (zobacz `CMFCToolBar::SetCommandUsageOptions`).
`CMFCToolBar::IsCustomizeMode`	Określa, czy struktura paska narzędzi jest w trybie dostosowywania.
`CMFCToolBar::IsDragButton`	Określa, czy przycisk paska narzędzi jest przeciągany.
`CMFCToolBar::IsExistCustomizeButton`	Określa, czy pasek narzędzi zawiera przycisk Dostosuj .
`CMFCToolBar::IsFloating`	Określa, czy pasek narzędzi jest przestawny.
`CMFCToolBar::IsLargeIcons`	Określa, czy paski narzędzi w aplikacji aktualnie wyświetlają duże ikony.
`CMFCToolBar::IsLastCommandFromButton`	Określa, czy ostatnio wykonane polecenie zostało wysłane z określonego przycisku paska narzędzi.
`CMFCToolBar::IsLocked`	Określa, czy pasek narzędzi jest zablokowany.
`CMFCToolBar::IsOneRowWithSibling`	Określa, czy pasek narzędzi i jego równorzędny pasek narzędzi są umieszczone w tym samym wierszu.
`CMFCToolBar::IsUserDefined`	Określa, czy pasek narzędzi jest zdefiniowany przez użytkownika.
`CMFCToolBar::LoadBitmap`	Ładuje obrazy paska narzędzi z zasobów aplikacji.
`CMFCToolBar::LoadBitmapEx`	Ładuje obrazy paska narzędzi z zasobów aplikacji. Zawiera duże obrazy.
`CMFCToolBar::LoadParameters`	Ładuje globalne opcje paska narzędzi z rejestru systemu Windows.
`CMFCToolBar::LoadState`	Ładuje informacje o stanie paska narzędzi z rejestru systemu Windows. (Przesłania `CPane::LoadState`).
`CMFCToolBar::LoadToolBar`	Ładuje pasek narzędzi z zasobów aplikacji.
`CMFCToolBar::LoadToolBarEx`	Ładuje pasek narzędzi z zasobów aplikacji przy użyciu `CMFCToolBarInfo` klasy pomocnika, aby umożliwić aplikacji używanie dużych obrazów.
`CMFCToolBar::OnChangeHot`	Wywoływana przez platformę, gdy użytkownik wybierze przycisk na pasku narzędzi.
`CMFCToolBar::OnFillBackground`	Wywoływana przez strukturę z `CBasePane::DoPaint` , aby wypełnić tło paska narzędzi.
`CMFCToolBar::OnReset`	Przywraca pasek narzędzi do stanu pierwotnego.
`CMFCToolBar::OnSetAccData`	(Przesłania `CBasePane::OnSetAccData`).
`CMFCToolBar::OnSetDefaultButtonText`	Przywraca tekst przycisku paska narzędzi do stanu domyślnego.
`CMFCToolBar::OnUpdateCmdUI`	Używane wewnętrznie.
`CMFCToolBar::RemoveAllButtons`	Usuwa wszystkie przyciski z paska narzędzi.
`CMFCToolBar::RemoveButton`	Usuwa przycisk z określonym indeksem z paska narzędzi.
`CMFCToolBar::RemoveStateFromRegistry`	Usuwa informacje o stanie paska narzędzi z rejestru systemu Windows.
`CMFCToolBar::ReplaceButton`	Zamienia przycisk paska narzędzi na inny przycisk paska narzędzi.
`CMFCToolBar::ResetAll`	Przywraca wszystkie paski narzędzi do ich oryginalnych stanów.
`CMFCToolBar::ResetAllImages`	Czyści wszystkie kolekcje obrazów paska narzędzi w aplikacji.
`CMFCToolBar::RestoreOriginalState`	Przywraca oryginalny stan paska narzędzi.
`CMFCToolBar::SaveState`	Zapisuje informacje o stanie paska narzędzi w rejestrze systemu Windows. (Przesłania `CPane::SaveState`).
`CMFCToolBar::Serialize`	(Przesłania `CBasePane::Serialize`).
`CMFCToolBar::SetBasicCommands`	Ustawia listę poleceń, które są zawsze wyświetlane po otwarciu menu przez użytkownika.
`CMFCToolBar::SetButtonInfo`	Ustawia identyfikator polecenia, styl i identyfikator obrazu przycisku paska narzędzi.
`CMFCToolBar::SetButtonStyle`	Ustawia styl przycisku paska narzędzi w danym indeksie.
`CMFCToolBar::SetButtonText`	Ustawia etykietę tekstową przycisku paska narzędzi.
`CMFCToolBar::SetButtons`	Ustawia przyciski paska narzędzi.
`CMFCToolBar::SetCommandUsageOptions`	Określa, kiedy rzadko używane polecenia nie są wyświetlane w menu aplikacji.
`CMFCToolBar::SetCustomizeMode`	Włącza lub wyłącza tryb dostosowywania dla wszystkich pasków narzędzi w aplikacji.
`CMFCToolBar::SetGrayDisabledButtons`	Określa, czy wyłączone przyciski na pasku narzędzi są wygaszone, czy wyłączone obrazy są używane dla wyłączonych przycisków.
`CMFCToolBar::SetHeight`	Ustawia wysokość paska narzędzi.
`CMFCToolBar::SetHotBorder`	Określa, czy przyciski paska narzędzi są śledzone na gorąco.
`CMFCToolBar::SetHotTextColor`	Ustawia kolor tekstu dla przycisków gorącego paska narzędzi.
`CMFCToolBar::SetLargeIcons`	Określa, czy przyciski paska narzędzi wyświetlają duże ikony.
`CMFCToolBar::SetLockedSizes`	Ustawia rozmiary zablokowanych przycisków i zablokowane obrazy na pasku narzędzi.
`CMFCToolBar::SetMenuSizes`	Ustawia rozmiar przycisków menu paska narzędzi i ich obrazów.
`CMFCToolBar::SetNonPermittedCommands`	Ustawia listę poleceń, których nie można wykonać przez użytkownika.
`CMFCToolBar::SetOneRowWithSibling`	Umieszcza pasek narzędzi i jego element równorzędny w tym samym wierszu.
`CMFCToolBar::SetPermament`	Określa, czy użytkownik może zamknąć pasek narzędzi.
`CMFCToolBar::SetRouteCommandsViaFrame`	Określa, czy ramka nadrzędna, czy właściciel wysyła polecenia do paska narzędzi.
`CMFCToolBar::SetShowTooltips`	Określa, czy platforma wyświetla wskazówki dotyczące narzędzi.
`CMFCToolBar::SetSiblingToolBar`	Określa element równorzędny paska narzędzi.
`CMFCToolBar::SetSizes`	Określa rozmiary przycisków i obrazów na wszystkich paskach narzędzi.
`CMFCToolBar::SetToolBarBtnText`	Określa właściwości przycisku na pasku narzędzi.
`CMFCToolBar::SetTwoRowsWithSibling`	Umieszcza pasek narzędzi i jego element równorzędny w osobnych wierszach.
`CMFCToolBar::SetUserImages`	Ustawia kolekcję obrazów zdefiniowanych przez użytkownika w aplikacji.
`CMFCToolBar::StretchPane`	Rozciąga pasek narzędzi w pionie lub w poziomie. (Przesłania `CBasePane::StretchPane`).
`CMFCToolBar::TranslateChar`	Wykonuje polecenie przycisku, jeśli określony kod klucza odpowiada prawidłowemu skrótowi klawiaturowemu.
`CMFCToolBar::UpdateButton`	Aktualizuje stan określonego przycisku.
`CMFCToolBar::WrapToolBar`	Zmienia położenie przycisków paska narzędzi w obrębie podanych wymiarów.

Metody chronione

Nazwa/nazwisko	opis
`CMFCToolBar::AllowShowOnList`	Określa, czy pasek narzędzi jest wyświetlany na liście w okienku Paski narzędzi okna dialogowego Dostosowywanie .
`CMFCToolBar::CalcMaxButtonHeight`	Oblicza maksymalną wysokość przycisku na pasku narzędzi.
`CMFCToolBar::DoPaint`	Przemaluje pasek narzędzi.
`CMFCToolBar::DrawButton`	Przemaluje przycisk paska narzędzi.
`CMFCToolBar::DrawSeparator`	Przemaluje separator na pasku narzędzi.
`CMFCToolBar::OnUserToolTip`	Wywoływana przez strukturę, gdy etykietka narzędzia przycisku ma być wyświetlana.

Składowe danych

Nazwa/nazwisko	opis
`CMFCToolBar::m_bDontScaleImages`	Określa, czy obrazy paska narzędzi mają być skalowane, czy nie w trybie wysokiej rozdzielczości DPI.
`CMFCToolBar::m_dblLargeImageRatio`	Określa stosunek wymiarów (wysokość lub szerokość) dużych obrazów i wymiar zwykłych obrazów.

Uwagi

Aby dołączyć CMFCToolBar obiekt do aplikacji, wykonaj następujące kroki:

CMFCToolBar Dodaj obiekt do głównego okna ramki.
Podczas przetwarzania komunikatu WM_CREATE dla okna ramki głównej wywołaj CMFCToolBar::Create lub CMFCToolBar::CreateEx , aby utworzyć pasek narzędzi i określić jego styl.
Wywołaj metodę CBasePane::EnableDocking , aby określić styl dokowania.

Aby wstawić przycisk specjalny, taki jak pole kombi lub pasek narzędzi listy rozwijanej, zarezerwuj fikcyjny przycisk w zasobie nadrzędnym i zastąp fikcyjny przycisk w czasie wykonywania za pomocą polecenia CMFCToolBar::ReplaceButton. Aby uzyskać więcej informacji, zobacz Przewodnik: umieszczanie kontrolek na paskach narzędzi.

CMFCToolBarjest klasą bazową klas biblioteki MFC Class, CMFCPopupMenuBar Class i CMFCDropDownToolBar Class.CMFCMenuBar

Przykład

W poniższym przykładzie pokazano, jak używać różnych metod w CMFCToolBar klasie . W przykładzie pokazano, jak ustawić tekst etykiety okna paska narzędzi, ustawić obramowania, ustawić styl okienka i włączyć przycisk Dodaj lub Usuń przyciski wyświetlane na końcu paska narzędzi. Ten fragment kodu jest częścią przykładu pokazu programu IE.

CMFCToolBar m_wndToolBar;

m_wndToolBar.SetWindowText(_T("Standard"));
m_wndToolBar.SetBorders();

//------------------------------------
// Remove toolbar gripper and borders:
//------------------------------------
m_wndToolBar.SetPaneStyle(m_wndToolBar.GetPaneStyle() &
                          ~(CBRS_GRIPPER | CBRS_BORDER_TOP | CBRS_BORDER_BOTTOM | CBRS_BORDER_LEFT | CBRS_BORDER_RIGHT));

m_wndToolBar.EnableCustomizeButton(TRUE, ID_VIEW_CUSTOMIZE, _T("Customize..."));

Wymagania

Nagłówek: afxtoolbar.h

Hierarchia dziedziczenia

CMFCToolBar

`CMFCToolBar::AddBasicCommand`

Dodaje polecenie menu do listy poleceń, które są zawsze wyświetlane po otwarciu menu przez użytkownika.

static void __stdcall AddBasicCommand(UINT uiCmd);

Parametry

uiCmd
[in] Określa polecenie do dodania.

Uwagi

Podstawowe polecenie jest zawsze wyświetlane po otwarciu menu. Ta metoda ma znaczenie, gdy użytkownik zdecyduje się wyświetlić ostatnio używane polecenia.

CMFCToolBar::SetBasicCommands Użyj metody , aby ustawić listę poleceń, które są zawsze wyświetlane po otwarciu menu przez użytkownika. CMFCToolBar::GetBasicCommands Użyj metody , aby pobrać listę podstawowych poleceń używanych przez aplikację.

`CMFCToolBar::AddCommandUsage`

Zwiększa się o jeden licznik skojarzony z danym poleceniem.

static void __stdcall AddCommandUsage(UINT uiCommand);

Parametry

uiCommand
[in] Określa licznik poleceń, aby zwiększać.

Uwagi

Platforma wywołuje tę metodę, gdy użytkownik wybierze element menu.

Platforma używa liczników poleceń do wyświetlania ostatnio używanych elementów menu.

Ta metoda zwiększa licznik poleceń przy użyciu CMFCCmdUsageCount::AddCmd metody .

`CMFCToolBar::AddToolBarForImageCollection`

Dodaje obrazy z zasobów interfejsu użytkownika do kolekcji obrazów w aplikacji.

static BOOL __stdcall AddToolBarForImageCollection(
    UINT uiResID,
    UINT uiBmpResID=0,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parametry

uiResID
[in] Identyfikator zasobu paska narzędzi z obrazami do załadowania.

uiBmpResID
[in] Identyfikator zasobu mapy bitowej z obrazami paska narzędzi.

uiColdResID
[in] Identyfikator zasobu mapy bitowej z obrazami paska narzędzi "zimny".

uiMenuResID
[in] Identyfikator zasobu mapy bitowej z obrazami menu.

uiDisabledResID
[in] Identyfikator zasobu mapy bitowej z wyłączonymi obrazami paska narzędzi.

uiMenuDisabledResID
[in] Identyfikator zasobu mapy bitowej z wyłączonymi obrazami menu.

Wartość zwracana

TRUE jeśli metoda powiedzie się; FALSE jeśli uiResID lub uiBmpResID nie określisz prawidłowych zasobów lub wystąpi inny błąd.

Uwagi

Wywołaj tę metodę, aby załadować mapę bitową z obrazami paska narzędzi i dodać ją do kolekcji obrazów paska narzędzi. Ta metoda tworzy tymczasowy obiekt paska narzędzi i wywołuje metodę CMFCToolBar::LoadToolBar.

`CMFCToolBar::AdjustLayout`

Oblicza ponownie rozmiar i położenie paska narzędzi.

virtual void AdjustLayout();

Uwagi

Wywołaj tę metodę, gdy pasek narzędzi został utworzony, aby ponownie obliczyć jego rozmiar i położenie.

Struktura wywołuje tę metodę za każdym razem, gdy należy zmienić układ paska narzędzi. Na przykład układ musi ulec zmianie, gdy użytkownik przenosi inny pasek sterowania, zmienia rozmiar okna aplikacji lub dostosowuje pasek narzędzi.

Zastąpij tę metodę, aby udostępnić własny układ dynamiczny w klasach pochodzących z klasy CMFCToolbar.

`CMFCToolBar::AdjustSize`

Oblicza ponownie rozmiar paska narzędzi.

void AdjustSize();

Uwagi

Ta metoda zapewnia, że pasek narzędzi mieści się w granicach ramki nadrzędnej. Ta metoda nic nie robi, jeśli pasek narzędzi nie ma ramki nadrzędnej.

Metoda CMFCToolBar::AdjustLayout wywołuje tę metodę, aby ponownie obliczyć rozmiar, jeśli element nadrzędny paska narzędzi nie jest obiektem CMFCReBar .

`CMFCToolBar::AllowChangeTextLabels`

Określa, czy etykiety tekstowe mogą być wyświetlane na obrazach na przyciskach paska narzędzi.

virtual BOOL AllowChangeTextLabels() const;

Wartość zwracana

TRUE jeśli może wyświetlać etykiety tekstowe poniżej obrazów; w przeciwnym razie FALSE.

Uwagi

Ta metoda jest wywoływana przez okno dialogowe dostosowywania, aby określić, czy włączyć pole wyboru Pokaż etykiety tekstowe na stronie Paski narzędzi dla wybranego paska narzędzi.

Domyślna implementacja zwraca wartość TRUE.

Zastąp tę metodę w obiekcie pochodzącym z CMFCToolBar obiektu i zwracanym FALSE , gdy nie chcesz, aby użytkownik zdecydował, czy etykiety tekstowe są wyświetlane na przyciskach paska narzędzi pod obrazami.

`CMFCToolBar::AllowShowOnList`

Określa, czy pasek narzędzi jest wyświetlany na liście pasków narzędzi w okienku Paski narzędzi okna dialogowego Dostosowywanie.

virtual BOOL AllowShowOnList() const;

Wartość zwracana

TRUE jeśli obiekt paska narzędzi można wyświetlić w polu listy na stronie dostosowywania paska narzędzi; w przeciwnym razie FALSE.

Uwagi

Ta metoda jest wywoływana przez strukturę w celu określenia, czy lista na stronie dostosowywania paska narzędzi powinna zawierać określony obiekt pochodzący z CMFCToolBar.

Domyślna implementacja zawsze zwraca wartość TRUE. Zastąpij tę metodę, gdy pasek narzędzi nie ma być wyświetlany na liście pasków narzędzi w oknie dialogowym dostosowywania.

`CMFCToolBar::AreTextLabels`

Określa, czy etykiety tekstowe w obszarze obrazów są obecnie wyświetlane na przyciskach paska narzędzi.

BOOL AreTextLabels() const;

Wartość zwracana

TRUE jeśli przyciski paska narzędzi wyświetlają etykiety tekstowe poniżej obrazów; w przeciwnym razie FALSE.

Uwagi

Użyj CMFCToolBar::EnableTextLabels polecenia , aby określić, czy tekst jest wyświetlany. Domyślna wartość to FALSE. Wywołaj metodę CMFCToolBar::AllowChangeTextLabels , aby określić, czy użytkownik może zmienić to ustawienie w oknie dialogowym dostosowywania.

`CMFCToolBar::AutoGrayInactiveImages`

Włącza lub wyłącza automatyczne generowanie nieaktywnych obrazów przycisków.

static void AutoGrayInactiveImages(
    BOOL bEnable=TRUE,
    int nGrayImagePercentage=0,
    BOOL bRedrawAllToolbars=TRUE);

Parametry

bEnable
[in] Wartość logiczna określająca, czy mają być przyciemnione nieaktywne obrazy. Jeśli ten parametr to TRUE, nieaktywne obrazy są wygaszone. W przeciwnym razie nieaktywne obrazy nie są wygaszone.

nGrayImagePercentage
[in] Określa procent luminacji dla nieaktywnych obrazów. Jeśli bEnable wartość to FALSE, ta wartość jest ignorowana.

bRedrawAllToolbars
[in] Wartość logiczna określająca, czy mają być ponownie rysowane wszystkie paski narzędzi w aplikacji. Jeśli ten parametr to TRUE, ta metoda ponownie rysuje wszystkie paski narzędzi.

Uwagi

Jeśli bEnable jest to TRUE, struktura używa nGrayImagePercentage metody do generowania nieaktywnych obrazów na podstawie zwykłych obrazów. W przeciwnym razie należy podać zestaw nieaktywnych obrazów przy użyciu CMFCToolBar::GetColdImages metody . Domyślnie ta opcja jest wyłączona.

Aby uzyskać więcej informacji na temat parametru nGrayImagePercentage , zobacz CMFCToolBarImages::GrayImages.

`CMFCToolBar::ButtonToIndex`

Zwraca indeks określonego CMFCToolBarButton obiektu Klasy na tym pasku narzędzi.

int ButtonToIndex(const CMFCToolBarButton* pButton) const;

Parametry

pButton
[in] Wskaźnik do obiektu przycisku paska narzędzi.

Wartość zwracana

Indeks na pButton wewnętrznej liście przycisków paska narzędzi; lub -1, jeśli określony przycisk nie znajduje się na tym pasku narzędzi.

`CMFCToolBar::CalcFixedLayout`

Oblicza rozmiar poziomy paska narzędzi.

virtual CSize CalcFixedLayout(
    BOOL bStretch,
    BOOL bHorz);

Parametry

bStretch
[in] TRUE aby rozciągnąć pasek narzędzi do rozmiaru ramki nadrzędnej.

bHorz
[in] TRUE w celu orientacji paska narzędzi w poziomie; FALSE w celu orientacji paska narzędzi w pionie.

Wartość zwracana

CSize Obiekt określający rozmiar paska narzędzi.

Uwagi

Ta metoda oblicza rozmiar paska narzędzi przy użyciu CMFCToolBar::CalcLayout metody . Przekazuje flagę parametru LM_STRETCH dwMode , jeśli bStretch ma wartość TRUE. Przekazuje flagę LM_HORZ , jeśli bHorz ma TRUEwartość .

Zobacz przykład VisualStudioDemo, aby zapoznać się z przykładem, który używa tej metody.

`CMFCToolBar::CalcMaxButtonHeight`

Oblicza maksymalną wysokość przycisków na pasku narzędzi.

virtual int CalcMaxButtonHeight();

Wartość zwracana

Maksymalna wysokość przycisków.

Uwagi

Ta metoda oblicza maksymalną wysokość wszystkich przycisków paska narzędzi na pasku narzędzi. Wysokość może się różnić w zależności od czynników, takich jak bieżący stan dokowania paska narzędzi.

Zastąp tę metodę w klasie pochodnej, CMFCToolBar aby zapewnić własne obliczenie wysokości.

`CMFCToolBar::CalcSize`

Wywoływana przez platformę w ramach procesu obliczania układu.

virtual CSize CalcSize(BOOL bVertDock);

Parametry

bVertDock
[in] TRUE aby określić, że pasek narzędzi jest zadokowany w pionie; FALSE aby określić, że pasek narzędzi jest zadokowany w poziomie.

Wartość zwracana

CSize Obiekt określający ogólny rozmiar przycisków na pasku narzędzi.

Uwagi

Ta metoda uwzględnia atrybuty wpływające na rozmiar każdego przycisku, takie jak obszar etykiety tekstowej i rozmiar obramowania.

Jeśli pasek narzędzi nie zawiera przycisków, ta metoda zwraca zarezerwowany rozmiar pojedynczego przycisku przy użyciu CMFCToolBar::GetButtonSize metody .

`CMFCToolBar::CanBeClosed`

Określa, czy użytkownik może zamknąć pasek narzędzi.

virtual BOOL CanBeClosed() const;

Wartość zwracana

TRUE jeśli pasek narzędzi może zostać zamknięty przez użytkownika; w przeciwnym razie FALSE.

Uwagi

Struktura wywołuje tę metodę, aby określić, czy użytkownik może zamknąć pasek narzędzi. Jeśli metoda zwróci TRUEwartość , platforma włącza SC_CLOSE polecenie w menu systemowym paska narzędzi, a użytkownik może zamknąć pasek narzędzi za pomocą pola wyboru na liście pasków narzędzi w oknie dialogowym dostosowywania.

Domyślna implementacja zwraca wartość TRUE. Zastąp tę metodę w klasie pochodzącej z CMFCToolBar , aby obiekty paska narzędzi, których nie można zamknąć przez użytkownika.

`CMFCToolBar::CanBeRestored`

Określa, czy system może przywrócić pasek narzędzi do pierwotnego stanu po dostosowaniu.

virtual BOOL CanBeRestored() const;

Wartość zwracana

TRUE jeśli pasek narzędzi można przywrócić z zasobów aplikacji; w przeciwnym razie FALSE.

Uwagi

Struktura wywołuje tę metodę, aby określić, czy pasek narzędzi może zostać zwrócony do pierwotnego stanu po dostosowaniu. Oryginalny stan jest ładowany z zasobów aplikacji.

Jeśli CanBeRestored zwraca TRUEwartość , strona Paski narzędzi okna dialogowego dostosowywania włącza przycisk Resetuj dla wybranego paska narzędzi.

Domyślna implementacja zwraca TRUE wartość, jeśli oryginalny identyfikator zasobu paska narzędzi, gdy został załadowany, jest inny niż zero. Zazwyczaj nie można przywrócić tylko pasków narzędzi zdefiniowanych przez użytkownika.

Możesz zastąpić metodę CanBeRestored , aby dostosować to zachowanie w klasach pochodnych.

`CMFCToolBar::CanFocus`

Określa, czy okienko może odbierać fokus.

virtual BOOL CanFocus() const;

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Ta metoda zastępuje implementację klasy bazowej , CBasePane::CanFocusponieważ obiekty paska narzędzi nie mogą odbierać fokusu.

`CMFCToolBar::CanHandleSiblings`

Określa, czy pasek narzędzi i jego element równorzędny są umieszczone w tym samym okienku.

BOOL CanHandleSiblings();

Wartość zwracana

TRUE jeśli pasek narzędzi ma element równorzędny, a pasek narzędzi i jego element równorzędny są umieszczone w tym samym okienku; w przeciwnym razie FALSE.

Uwagi

Metoda wewnętrzna CMFCCustomizeButton::CreatePopupMenu wywołuje tę metodę, aby określić sposób wyświetlania menu podręcznego Dostosowywanie . Jeśli ta metoda zwraca TRUEwartość , platforma wyświetla przyciski Pokaż przyciski w jednym wierszu lub Pokaż przyciski w dwóch wierszach .

Zazwyczaj nie trzeba używać tej metody. Aby włączyć przycisk Dostosuj wyświetlany na pasku narzędzi, wywołaj metodę CMFCToolBar::EnableCustomizeButton . Aby włączyć przyciski Pokaż w jednym wierszu lub Pokaż przyciski w dwóch wierszach , wywołaj metodę CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::CleanUpImages`

Zwalnia zasoby systemowe przydzielone dla obrazów paska narzędzi.

static void CMFCToolBar::CleanUpImages();

Uwagi

Platforma wywołuje tę metodę, gdy aplikacja zostanie zamknięta.

`CMFCToolBar::CleanUpLockedImages`

Zwalnia zasoby systemowe przydzielone dla zablokowanych obrazów paska narzędzi.

void CleanUpLockedImages();

Uwagi

Wywołaj tę metodę, gdy zmieni się styl wizualny aplikacji. Zobacz przykład VisualStudioDemo, aby zapoznać się z przykładem, który używa tej metody.

`CMFCToolBar::CommandToIndex`

Zwraca indeks przycisku na pasku narzędzi z określonym identyfikatorem polecenia.

int CommandToIndex(
    UINT nIDFind,
    int iIndexFirst=0) const;

Parametry

nIDFind
[in] Określa identyfikator polecenia.

iIndexFirst
[in] Określa początkowy indeks do rozpoczęcia od.

Wartość zwracana

Jeśli metoda zakończyła się pomyślnie, indeks paska narzędzi zakończył się zerowym indeksem; -1, jeśli nie ma przycisku o określonym identyfikatorze.

Uwagi

Obiekt CMFCToolBar utrzymuje wewnętrzną listę przycisków na pasku narzędzi. Wywołaj tę funkcję, aby pobrać indeks przycisku na liście, biorąc pod uwagę identyfikator polecenia przycisku.

Jeśli iIndex wartość jest większa niż 0, ta metoda ignoruje dowolny przycisk na pasku narzędzi, który ma indeks mniejszy niż iIndex.

`CMFCToolBar::Create`

Tworzy obiekt CMFCToolBar.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    UINT nID=AFX_IDW_TOOLBAR);

Parametry

pParentWnd
[in] Wskaźnik do okna nadrzędnego paska narzędzi.

dwStyle
[in] Styl paska narzędzi. Aby uzyskać listę stylów, zobacz Style kontrolek i przycisków paska narzędzi w zestawie Windows SDK.

nID
[in] Identyfikator okna podrzędnego paska narzędzi.

Wartość zwracana

TRUE jeśli ta metoda powiedzie się; w przeciwnym razie FALSE.

Uwagi

Ta metoda tworzy pasek sterowania i dołącza go do paska narzędzi. Tworzy pasek sterowania z stylem TBSTYLE_FLAT. Wywołaj metodę CMFCToolBar::CreateEx , jeśli chcesz użyć innego stylu paska sterowania.

`CMFCToolBar::CreateEx`

Tworzy CMFCToolBar obiekt, który używa dodatkowych opcji stylu, takich jak duże ikony.

virtual BOOL CreateEx(
    CWnd* pParentWnd,
    DWORD dwCtrlStyle=TBSTYLE_FLAT,
    DWORD dwStyle=AFX_DEFAULT_TOOLBAR_STYLE,
    CRect rcBorders=CRect(1,
    1,
    1,
    1),
    UINT nID=AFX_IDW_TOOLBAR);

Parametry

pParentWnd
[in] Wskaźnik do okna nadrzędnego paska narzędzi.

dwCtrlStyle
[in] Dodatkowe style tworzenia osadzonego obiektu paska sterowania.

dwStyle
[in] Styl paska narzędzi. Aby uzyskać listę odpowiednich stylów, zobacz Kontrolka paska narzędzi i Style przycisków.

rcBorders
[in] CRect Obiekt określający szerokość obramowania okna paska narzędzi.

nID
[in] Identyfikator okna podrzędnego paska narzędzi.

Wartość zwracana

Nonzero, jeśli ta metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Ta metoda tworzy pasek sterowania i dołącza go do paska narzędzi.

Wywołaj tę metodę zamiast CMFCToolBar::Create , jeśli chcesz podać określone style. Na przykład ustaw wartość dwCtrlStyle na , aby TBSTYLE_FLAT | TBSTYLE_TRANSPARENT utworzyć pasek narzędzi podobny do pasków narzędzi używanych przez program Internet Explorer 4.

Przykład

W poniższym przykładzie pokazano, jak używać CreateEx metody CMFCToolBar klasy . Ten fragment kodu jest częścią przykładu pokazu programu IE.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::Deactivate`

Dezaktywuje pasek narzędzi.

virtual void Deactivate();

Uwagi

Ta metoda dezaktywuje pasek narzędzi, usuwając fokus z wyróżnionego przycisku paska narzędzi. Struktura wywołuje tę metodę, gdy pasek narzędzi traci fokus lub jest niszczony.

`CMFCToolBar::DoPaint`

Przemaluje pasek narzędzi.

virtual void DoPaint(CDC* pDC);

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

Uwagi

Ta metoda jest wywoływana przez platformę, gdy część paska narzędzi musi zostać przemalowana.

Zastąp tę metodę, aby dostosować wygląd obiektu pochodzącego z CMFCToolBarklasy .

`CMFCToolBar::DrawButton`

Przemaluje przycisk paska narzędzi.

virtual BOOL DrawButton(
    CDC* pDC,
    CMFCToolBarButton* pButton,
    CMFCToolBarImages* pImages,
    BOOL bHighlighted,
    BOOL bDrawDisabledImages);

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

pButton
[in] Wskaźnik do narysowania przycisku.

pImages
[in] Wskaźnik do obrazów paska narzędzi.

bHighlighted
[in] TRUE jeśli przycisk jest wyróżniony; w przeciwnym razie FALSE.

bDrawDisabledImages
[in] TRUE jeśli wyłączone przyciski są wygaszone; w przeciwnym razie FALSE.

Wartość zwracana

TRUE jeśli przycisk został przemalowany; FALSE jeśli przycisk jest ukryty.

Uwagi

Metoda CMFCToolBar::DrawButton wywołuje tę metodę, gdy przycisk paska narzędzi musi zostać przemalowany.

Zastąpi tę metodę, jeśli chcesz dostosować wygląd przycisków na pasku narzędzi.

`CMFCToolBar::DrawSeparator`

Przemaluje separator na pasku narzędzi.

virtual void DrawSeparator(
    CDC* pDC,
    const CRect& rect,
    BOOL bHorz);

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

rect
[in] Prostokąt ograniczenia lokalizacji, w której jest rysowany separator, w pikselach.

bHorz
[in] TRUE jeśli separator jest poziomy, FALSE jeśli separator jest pionowy.

Uwagi

CMFCToolBar::DoPaint Wywołuje tę metodę dla każdego CMFCToolBar::DrawSeparator obiektu, który ma TBBS_SEPARATOR styl, zamiast wywoływać CMFCToolBar::DrawButton dla tych przycisków.

Zastąp tę metodę w klasie pochodnej w CMFCToolBar celu dostosowania wyglądu separatorów na pasku narzędzi. Domyślne wywołania CMFCVisualManager::OnDrawSeparator implementacji do rysowania separatora, którego wygląd jest określany przez bieżącego menedżera wizualizacji.

`CMFCToolBar::EnableCustomizeButton`

Włącza lub wyłącza przycisk Dostosuj wyświetlany na pasku narzędzi.

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    const CString& strCustomizeText,
    BOOL bQuickCustomize=TRUE);

void EnableCustomizeButton(
    BOOL bEnable,
    int iCustomizeCmd,
    UINT uiCustomizeTextResId,
    BOOL bQuickCustomize=TRUE);

Parametry

bEnable
[in] Włącza lub wyłącza przycisk Dostosuj.

iCustomizeCmd
[in] Identyfikator polecenia przycisku Dostosuj.

strCustomizeText
[in] Etykieta tekstowa przycisku Dostosuj.

uiCustomizeTextResId
[in] Identyfikator ciągu zasobu etykiety przycisku Dostosuj.

bQuickCustomize
[in] Włącza lub wyłącza opcję Dodaj lub Usuń przyciski w menu rozwijanych z przycisku.

Uwagi

Jeśli iCustomizeCmd wartość to -1, platforma wyświetla przycisk Dostosuj, gdy wiele przycisków paska narzędzi nie pasuje do obszaru paska narzędzi. Przycisk wyświetla podwójną strzałkę wskazującą lewą stronę lub strzałkę, która wskazuje, że istnieje więcej przycisków.

Jeśli iCustomizeCmd określa prawidłowy identyfikator polecenia i bEnable ma TRUEwartość , przycisk Dostosuj jest zawsze wyświetlany. Przycisk ma małą strzałkę w dół i otwiera menu zawierające polecenie. To polecenie używa etykiety tekstowej określonej przez strCustomizeText. Jeśli bQuickCustomize parametr to również TRUE, w menu zostanie wyświetlona opcja Dodaj lub Usuń przyciski .

Platforma dynamicznie dodaje do menu wszystkie przyciski, które nie mieszczą się w obszarze paska narzędzi przed elementem określonym przez iCustomizeCmdelement . Cudzysłów jest wyświetlany obok strzałki w dół.

`CMFCToolBar::EnableDocking`

Umożliwia zadokowanie okienka do ramki głównej.

virtual void EnableDocking(DWORD dwAlignment);

Parametry

dwAlignment
[in] Określa wyrównanie dokowania, aby włączyć.

Uwagi

Ta metoda rozszerza implementację klasy bazowej , CBasePane::EnableDockingustawiając CBasePane::m_dwControlBarStyle element członkowski danych na AFX_CBRS_FLOAT. Ta metoda następnie przekazuje dwAlignment do implementacji klasy bazowej.

`CMFCToolBar::EnableLargeIcons`

Włącza lub wyłącza duże ikony na przyciskach paska narzędzi.

void EnableLargeIcons(BOOL bEnable);

Parametry

bEnable
[in] TRUE aby włączyć duże ikony, FALSE aby wyłączyć duże ikony.

Uwagi

Domyślnie duże ikony są włączone.

`CMFCToolBar::EnableQuickCustomization`

Włącza lub wyłącza szybkie dostosowywanie pasków narzędzi, aby użytkownik mógł nacisnąć Alt i przeciągnąć przycisk do nowej lokalizacji.

static void EnableQuickCustomization(BOOL bEnable=TRUE);

Parametry

bEnable
[in] TRUE aby włączyć szybkie dostosowywanie, FALSE aby wyłączyć szybkie dostosowywanie.

`CMFCToolBar::EnableReflections`

Włącza lub wyłącza odbicie poleceń.

void EnableReflections(BOOL bEnable = TRUE);

Parametry

bEnable
[in] TRUE w celu włączenia odbicia polecenia; FALSE aby wyłączyć odbicie polecenia.

Uwagi

Wywołaj tę metodę, aby włączyć odbicie poleceń dla przycisków paska narzędzi zawierających osadzone kontrolki, takie jak pola kombi.

Aby uzyskać więcej informacji na temat odbicia poleceń, zobacz TN062: Odbicie komunikatu dla kontrolek systemu Windows.

`CMFCToolBar::EnableTextLabels`

Włącza lub wyłącza etykiety tekstowe w obszarze obrazów przycisków paska narzędzi.

void EnableTextLabels(BOOL bEnable=TRUE);

Parametry

bEnable
TRUE jeśli etykiety tekstowe są wyświetlane pod obrazami przycisków paska narzędzi; w przeciwnym razie FALSE.

Uwagi

Jeśli etykiety tekstowe są włączone, wszystkie przyciski na pasku narzędzi są powiększane, aby zapewnić miejsce na etykiety, które mają być wyświetlane pod obrazami. Okno dialogowe dostosowywania ma pole wyboru Pokaż etykietę tekstową na stronie Paski narzędzi. Gdy użytkownik wybierze pasek narzędzi i sprawdzi tę opcję, platforma wywołuje EnableTextLabels wybrany pasek narzędzi. Możesz wyłączyć pole wyboru dla obiektu pochodzącego z CMFCToolBar obiektu, zwracając polecenie FALSE z CMFCToolBar::AllowChangeTextLabels .

`CMFCToolBar::FromHandlePermanent`

Pobiera wskaźnik do CMFCToolBar obiektu zawierającego dany uchwyt okna.

static CMFCToolBar* __stdcall FromHandlePermanent(HWND hwnd);

Parametry

hwnd
[in] Uchwyt okna do wyszukania.

Wartość zwracana

Wskaźnik do CMFCToolBar obiektu, który zawiera dany uchwyt okna lub NULL jeśli nie istnieje odpowiedni CMFCToolBar obiekt.

Uwagi

Ta metoda udostępniona sprawdza każdy pasek narzędzi w aplikacji dla CMFCToolBar obiektu zawierającego dany uchwyt okna.

`CMFCToolBar::GetAllButtons`

Zwraca listę przycisków tylko do odczytu na pasku narzędzi.

const CObList& GetAllButtons() const;

Wartość zwracana

Stałe odwołanie do CObList obiektu Class , który zawiera kolekcję CMFCToolBarButton obiektów Klasy .

`CMFCToolBar::GetAllToolbars`

Zwraca listę tylko do odczytu wszystkich pasków narzędzi w aplikacji.

static const CObList& GetAllToolbars();

Wartość zwracana

Odwołanie const do CObList obiektu Class , który zawiera kolekcję CMFCToolBar obiektów.

`CMFCToolBar::GetBasicCommands`

Zwraca listę poleceń podstawowych zdefiniowanych w aplikacji w trybie tylko do odczytu.

static const CList<UINT,UINT>& GetBasicCommands();

Wartość zwracana

Odwołanie const do CList obiektu Class , który zawiera kolekcję podstawowych poleceń.

Uwagi

Dodaj podstawowe polecenia, wywołując polecenie CMFCToolBar::AddBasicCommand lub CMFCToolBar::SetBasicCommands.

`CMFCToolBar::GetButton`

Zwraca wskaźnik do CMFCToolBarButton obiektu Class w określonym indeksie.

CMFCToolBarButton* GetButton(int iIndex) const;

Parametry

iIndex
[in] Określa indeks przycisku do zwrócenia.

Wartość zwracana

Wskaźnik do przycisku paska narzędzi, jeśli istnieje; lub NULL jeśli nie ma takiego przycisku.

`CMFCToolBar::GetButtonInfo`

Zwraca identyfikator polecenia, styl i indeks obrazu przycisku w określonym indeksie.

void GetButtonInfo(
    int nIndex,
    UINT& nID,
    UINT& nStyle,
    int& iImage) const;

Parametry

nIndex
[in] Określa indeks przycisku na liście przycisków na pasku narzędzi.

nID
[out] Identyfikator polecenia przycisku.

nStyle
[out] Styl przycisku.

iImage
[out] Indeks obrazu dla przycisku.

Uwagi

Metoda GetButtonInfo znajduje przycisk paska narzędzi w określonym indeksie i pobiera identyfikator polecenia, styl i indeks obrazu przycisku.

Jeśli przycisk w określonym indeksie nie istnieje, platforma ustawia wartości nID i nStyle na 0, a iImage do -1, gdy metoda zwraca.

`CMFCToolBar::GetButtonSize`

Zwraca wymiary każdego przycisku na pasku narzędzi.

CSize GetButtonSize() const;

Wartość zwracana

CSize Obiekt Klasy, który określa wymiary każdego przycisku na pasku narzędzi.

Uwagi

Wywołaj CMFCToolBar::SetSizes metodę lub CMFCToolBar::SetLockedSizes ustaw wymiary każdego przycisku na pasku narzędzi.

`CMFCToolBar::GetButtonStyle`

Zwraca bieżący styl przycisku paska narzędzi, który znajduje się w określonym indeksie.

UINT GetButtonStyle(int nIndex) const;

Parametry

nIndex
[in] Określa indeks przycisku paska narzędzi.

Wartość zwracana

Wartość określająca styl przycisku paska narzędzi. . Aby uzyskać listę możliwych stylów, zobacz ToolBar Control Styles (Style kontrolek ToolBar).

Uwagi

Wywołanie CMFCToolBar::SetButtonStyle w celu ustawienia stylu przycisku paska narzędzi

`CMFCToolBar::GetButtonText`

Zwraca etykietę tekstową przycisku, który ma określony indeks.

CString GetButtonText(int nIndex) const;

void GetButtonText(
    int nIndex,
    CString& rString) const;

`CMFCToolBar::GetCommandButtons`

Zwraca listę przycisków, które mają określony identyfikator polecenia ze wszystkich pasków narzędzi w aplikacji.

static int GetCommandButtons(
    UINT uiCmd,
    CObList& listButtons);

Parametry

uiCmd
[in] Identyfikator polecenia przycisków.

listButtons
[out] Odwołanie do CObList obiektu Class , który odbiera listę przycisków paska narzędzi.

Wartość zwracana

Liczba przycisków z określonym identyfikatorem polecenia.

`CMFCToolBar::GetCount`

Zwraca liczbę przycisków i separatorów na pasku narzędzi.

int GetCount() const;

Wartość zwracana

Liczba przycisków i separatorów na pasku narzędzi.

`CMFCToolBar::GetCustomizeButton`

Pobiera wskaźnik do obiektu skojarzonego CMFCCustomizeButton z paskiem narzędzi.

CMFCCustomizeButton* GetCustomizeButton();

Wartość zwracana

Wskaźnik do CMFCCustomizeButton obiektu skojarzonego z paskiem narzędzi.

Uwagi

Ta metoda pobiera przycisk Dostosuj wyświetlany na końcu paska narzędzi. CMFCToolBar::EnableCustomizeButton Użyj metody , aby dodać przycisk Dostosuj do paska narzędzi.

Metodę CMFCToolBar::IsExistCustomizeButton można wywołać, aby określić, czy pasek narzędzi zawiera prawidłowy CMFCCustomizeButton obiekt.

`CMFCToolBar::GetDefaultImage`

Zwraca indeks obrazu domyślnego dla przycisku paska narzędzi z określonym identyfikatorem polecenia.

static int GetDefaultImage(UINT uiID);

Parametry

BOOL GetIgnoreSetText() const;

Wartość zwracana

TRUE jeśli wywołania ustawiania etykiet przycisków są ignorowane; w przeciwnym razie, FALSE.

Uwagi

`CMFCToolBar::GetImages`

Zwraca wskaźnik do kolekcji domyślnych obrazów przycisków w aplikacji.

static CMFCToolBarImages* GetImages();

Wartość zwracana

Wskaźnik do CMFCToolBarImages obiektu Class , który zawiera kolekcję domyślnych obrazów dla wszystkich pasków narzędzi w aplikacji.

Uwagi

Ta metoda udostępniona zapewnia dostęp do kolekcji wszystkich domyślnych obrazów paska narzędzi dla aplikacji. Wywołaj metodę , CMFCToolBar::LoadBitmap aby dodać obrazy do kolekcji.

`CMFCToolBar::GetImageSize`

Zwraca bieżący rozmiar obrazów przycisków paska narzędzi.

CSize GetImageSize() const;

Wartość zwracana

CSize Obiekt Klasy reprezentujący bieżący rozmiar obrazów przycisków paska narzędzi.

`CMFCToolBar::GetImagesOffset`

Zwraca przesunięcie indeksu używane do znajdowania obrazów przycisków paska narzędzi dla tego paska narzędzi na globalnej liście obrazów przycisków paska narzędzi.

int GetImagesOffset() const;

Wartość zwracana

Przesunięcie indeksu obrazów paska narzędzi.

Uwagi

Wszystkie obrazy domyślne paska narzędzi są przechowywane na globalnej CMFCToolBarImages liście Klas . Obrazy dla każdego przycisku na pasku narzędzi są przechowywane kolejno na tej liście. Aby obliczyć indeks obrazu, dodaj indeks przycisku na pasku narzędzi do przesunięcia początku listy obrazów dla tego przycisku paska narzędzi.

Wywołaj metodę CMFCToolBar::ButtonToIndex w celu uzyskania indeksu przycisku paska narzędzi przy użyciu wskaźnika do przycisku.

Wywołaj metodę CMFCToolBar::GetImages w celu uzyskania wskaźnika do kolekcji obrazów paska narzędzi.

`CMFCToolBar::GetInvalidateItemRect`

Pobiera region obszaru klienta, który musi być ponownie rysowane dla przycisku w danym indeksie.

virtual void GetInvalidateItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametry

nIndex
[in] Indeks przycisku, dla którego ma być pobierany obszar klienta.

lpRect
[out] Wskaźnik do RECT obiektu, który odbiera region obszaru klienta.

Uwagi

Parametr lpRect nie może mieć wartości NULL. Jeśli w podanym indeksie nie istnieje przycisk, lpRect otrzyma RECT obiekt zainicjowany do zera.

`CMFCToolBar::GetItemID`

Zwraca identyfikator polecenia przycisku paska narzędzi w określonym indeksie.

UINT GetItemID(int nIndex) const;

Parametry

nIndex
[in] Określa indeks przycisku paska narzędzi.

Wartość zwracana

Identyfikator polecenia przycisku paska narzędzi; lub zero, jeśli przycisk z określonym indeksem nie istnieje.

`CMFCToolBar::GetItemRect`

Zwraca prostokąt ograniczenia przycisku w określonym indeksie.

virtual void GetItemRect(
    int nIndex,
    LPRECT lpRect) const;

Parametry

nIndex
[in] Określa indeks przycisku paska narzędzi.

lpRect
[out] Wskaźnik do CRect obiektu, który odbiera współrzędne prostokąta ograniczenia obrazu.

Uwagi

CRect Obiekt, dla którego lpRect punktów ustawiono wartość 0, jeśli przycisk w określonym indeksie nie istnieje.

Przykład

W poniższym przykładzie pokazano, jak używać GetItemRect metody CMFCToolBar klasy . Ten fragment kodu jest częścią przykładu pokazu programu IE.

CMFCToolBar m_wndToolBar;

CRect rectToolBar;
m_wndToolBar.GetItemRect(0, &rectToolBar);

`CMFCToolBar::GetLargeColdImages`

Zwraca wskaźnik do kolekcji dużych zimnych obrazów przycisków paska narzędzi w aplikacji.

static CMFCToolBarImages* GetLargeColdImages();

Wartość zwracana

Wskaźnik do kolekcji dużych zimnych obrazów.

Uwagi

Zimne obrazy to obrazy, które są używane, gdy użytkownik nie wchodzi w interakcję z przyciskami paska narzędzi. Wywołaj metodę CMFCToolBar::LoadBitmapEx ładowania dużych zimnych obrazów.

`CMFCToolBar::GetLargeDisabledImages`

Zwraca wskaźnik do kolekcji dużych wyłączonych obrazów przycisków paska narzędzi w aplikacji.

static CMFCToolBarImages* GetLargeDisabledImages();

Wartość zwracana

Wskaźnik do kolekcji dużych wyłączonych obrazów przycisków paska narzędzi.

Uwagi

Duże obrazy to duże wersje zwykłych obrazów przycisków paska narzędzi. Wywołaj CMFCToolBar::LoadBitmapEx lub CMFCToolBar::LoadBitmap załaduj duże obrazy.

`CMFCToolBar::GetLargeImages`

Zwraca wskaźnik do kolekcji obrazów przycisków dużego paska narzędzi w aplikacji.

static CMFCToolBarImages* GetLargeImages();

Wartość zwracana

Wskaźnik do kolekcji dużych obrazów przycisków paska narzędzi.

Uwagi

Duże obrazy to duże wersje zwykłych obrazów przycisków paska narzędzi. Wywołaj metodę CMFCToolBar::LoadBitmapEx ładowania dużych obrazów.

`CMFCToolBar::GetLockedColdImages`

Zwraca wskaźnik do kolekcji zablokowanych zimnych obrazów na pasku narzędzi.

CMFCToolBarImages* GetLockedColdImages();

Wartość zwracana

Wskaźnik do kolekcji zablokowanych zimnych obrazów lub NULL jeśli pasek narzędzi nie jest zablokowany.

Uwagi

Zablokowane obrazy to wersje zwykłych obrazów przycisków paska narzędzi używanych przez platformę, gdy użytkownik nie może dostosować paska narzędzi. Zimne obrazy to obrazy, które są używane, gdy użytkownik nie wchodzi w interakcję z przyciskami paska narzędzi.

Ta metoda zwraca wartość NULL , jeśli pasek narzędzi nie jest zablokowany. Ta metoda generuje również błąd asercji w kompilacjach debugowania, jeśli pasek narzędzi nie jest zablokowany. Aby uzyskać więcej informacji na temat zablokowanych pasków narzędzi, zobacz CMFCToolBar::IsLocked.

Wywołaj metodę , CMFCToolBar::LoadBitmapEx aby załadować zablokowane zimne obrazy.

`CMFCToolBar::GetLockedDisabledImages`

Zwraca wskaźnik do kolekcji zablokowanych obrazów wyłączonych na pasku narzędzi.

CMFCToolBarImages* GetLockedDisabledImages();

Wartość zwracana

Wskaźnik do kolekcji zablokowanych wyłączonych obrazów lub NULL jeśli pasek narzędzi nie jest zablokowany.

Uwagi

Zablokowane obrazy to wersje zwykłych obrazów przycisków paska narzędzi używanych przez platformę, gdy użytkownik nie może dostosować paska narzędzi. Wyłączone obrazy to obrazy używane przez platformę, gdy przycisk ma TBBS_DISABLED styl.

Wywołaj metodę , CMFCToolBar::LoadBitmapEx aby załadować zablokowane wyłączone obrazy.

`CMFCToolBar::GetLockedImages`

Zwraca wskaźnik do kolekcji zablokowanych obrazów przycisków na pasku narzędzi.

CMFCToolBarImages* GetLockedImages();

Wartość zwracana

Wskaźnik do kolekcji zablokowanych obrazów przycisków paska narzędzi lub NULL jeśli pasek narzędzi nie jest zablokowany.

Uwagi

Zablokowane obrazy to wersje zwykłych obrazów przycisków paska narzędzi używanych przez platformę, gdy użytkownik nie może dostosować paska narzędzi.

`CMFCToolBar::GetLockedImageSize`

Zwraca domyślny rozmiar zablokowanych obrazów paska narzędzi.

CSize GetLockedImageSize() const;

Wartość zwracana

Struktura CSize określająca rozmiar zablokowanych obrazów paska narzędzi lub pustą CSize strukturę, jeśli pasek narzędzi nie jest zablokowany.

Uwagi

Zablokowane obrazy to wersje zwykłych obrazów przycisków paska narzędzi używanych przez platformę, gdy użytkownik nie może dostosować paska narzędzi.

Ta metoda zwraca strukturę o zerowej CSize szerokości i zerowej wysokości, jeśli pasek narzędzi nie jest zablokowany. Ta metoda generuje również błąd asercji w kompilacjach debugowania, jeśli pasek narzędzi nie jest zablokowany. Aby uzyskać więcej informacji na temat zablokowanych pasków narzędzi, zobacz CMFCToolBar::IsLocked.

Wywołaj metodę , CMFCToolBar::SetLockedSizes aby określić zablokowany rozmiar obrazu.

`CMFCToolBar::GetLockedMenuImages`

Zwraca wskaźnik do kolekcji zablokowanych obrazów menu paska narzędzi na pasku narzędzi.

CMFCToolBarImages* GetLockedMenuImages();

Wartość zwracana

Wskaźnik do kolekcji zablokowanych obrazów menu paska narzędzi lub NULL jeśli pasek narzędzi nie jest zablokowany.

Uwagi

Zablokowane obrazy to wersje zwykłych obrazów menu paska narzędzi używanych przez platformę, gdy użytkownik nie może dostosować paska narzędzi.

Wywołaj metodę , CMFCToolBar::LoadBitmapEx aby załadować zablokowane obrazy menu.

`CMFCToolBar::GetMenuButtonSize`

Zwraca rozmiar przycisków menu w aplikacji.

static CSize GetMenuButtonSize();

Wartość zwracana

CSize Obiekt reprezentujący rozmiar przycisków menu w pikselach.

Uwagi

Rozmiar przycisków menu na paskach narzędzi jest utrzymywany jako zmienna globalna i można go pobrać za pomocą tej metody statycznej.

Wywołaj metodę CMFCToolBar::SetMenuSizes , aby ustawić tę zmienną globalną.

`CMFCToolBar::GetMenuImages`

Zwraca wskaźnik do kolekcji obrazów przycisków menu w aplikacji.

static CMFCToolBarImages* GetMenuImages();

Wartość zwracana

Wskaźnik do kolekcji obrazów menu.

Uwagi

Wywołaj metodę , CMFCToolBar::LoadBitmapEx aby załadować obrazy menu.

Wywołaj metodę , CMFCToolBar::SetMenuSizes aby ustawić rozmiar przycisków i ich obrazów.

`CMFCToolBar::GetMenuImageSize`

Zwraca rozmiar obrazów przycisków menu w aplikacji.

static CSize GetMenuImageSize();

Wartość zwracana

CSize Obiekt reprezentujący rozmiar obrazów menu.

Uwagi

Ta metoda zwraca rozmiar obrazów na przyciskach menu paska narzędzi, które są zachowywane jako zmienna globalna. Wywołaj metodę CMFCToolBar::SetMenuSizes , aby ustawić tę zmienną globalną.

`CMFCToolBar::GetOrigButtons`

Pobiera kolekcję przycisków, które nie są dostosowane na pasku narzędzi.

const CObList& GetOrigButtons() const;

Wartość zwracana

Odwołanie do listy przycisków, które nie są dostosowane na pasku narzędzi.

Uwagi

Platforma tworzy kopię przycisków paska narzędzi przed ich dostosowaniem przez użytkownika. Metoda CMFCToolBar::SetButtons dodaje kopię każdego przycisku w podanej tablicy do listy oryginalnych przycisków. Metoda CMFCToolBar::RestoreOriginalState przywraca oryginalny stan paska narzędzi, ładując go z pliku zasobu.

Aby ustawić listę oryginalnych przycisków dla paska narzędzi, wywołaj metodę CMFCToolBar::SetOrigButtons .

`CMFCToolBar::GetOrigResetButtons`

Pobiera kolekcję niestandardowych przycisków resetowania paska narzędzi.

const CObList& GetOrigResetButtons() const;

Wartość zwracana

Odwołanie do listy nieustosowanych przycisków resetowania paska narzędzi.

Uwagi

Gdy użytkownik wybierze przycisk Resetuj w trybie dostosowywania, struktura używa tej metody do przywracania przycisków usuniętych z paska narzędzi.

Metoda CMFCToolBar::SetButtons dodaje kopię każdego przycisku paska narzędzi do listy oryginalnych przycisków resetowania po wywołaniu CMFCToolBar::OnReset metody . Możesz zastąpić metodę CMFCToolBar::OnReset , aby dostosować wygląd przycisków po naciśnięciu przez użytkownika przycisku Resetuj.

`CMFCToolBar::GetResourceID`

Pobiera identyfikator zasobu paska narzędzi.

UINT GetResourceID() const;

Wartość zwracana

Identyfikator zasobu paska narzędzi.

Uwagi

Wywołaj metodę CMFCToolBar::LoadToolBarEx , aby ustawić identyfikator zasobu paska narzędzi.

`CMFCToolBar::GetRouteCommandsViaFrame`

Określa, który obiekt, ramka nadrzędna lub właściciel, wysyła polecenia do paska narzędzi.

BOOL GetRouteCommandsViaFrame();

Wartość zwracana

Nonzero, jeśli ramka nadrzędna wysyła polecenia do paska narzędzi; 0, jeśli właściciel wysyła polecenia do paska narzędzi.

Uwagi

Domyślnie ramka nadrzędna wysyła polecenia do paska narzędzi. Wywołaj metodę CMFCToolBar::SetRouteCommandsViaFrame , aby zmienić to zachowanie.

Jeśli ta metoda zwraca wartość niezerową, możesz pobrać wskaźnik do obiektu ramki nadrzędnej przy użyciu CMFCToolBar::GetCommandTarget metody . Zobacz przykład VisualStudioDemo, aby zapoznać się z przykładem, który używa tej metody.

`CMFCToolBar::GetRowHeight`

Zwraca wysokość przycisków paska narzędzi.

virtual int GetRowHeight() const;

Wartość zwracana

Wysokość przycisków paska narzędzi w pikselach.

Uwagi

Struktura wywołuje tę metodę w celu obliczenia układu paska narzędzi. Zastąp tę metodę w klasie pochodnej, aby określić inną wysokość paska narzędzi.

`CMFCToolBar::GetShowTooltips`

Określa, czy dla przycisków paska narzędzi są wyświetlane porady dotyczące narzędzi.

static BOOL GetShowTooltips();

Wartość zwracana

TRUE jeśli wskazówki dotyczące narzędzi są wyświetlane dla przycisków paska narzędzi; w przeciwnym razie FALSE.

Uwagi

Domyślnie są wyświetlane porady dotyczące narzędzi. Tę flagę statyczną można zmienić, wywołując metodę CMFCToolBar::SetShowTooltips.

`CMFCToolBar::GetSiblingToolBar`

Pobiera element równorzędny paska narzędzi.

CMFCToolBar* GetSiblingToolBar();

Wartość zwracana

Wskaźnik do paska narzędzi elementu równorzędnego.

Uwagi

Aby uzyskać więcej informacji na temat włączania przycisków Pokaż w jednym wierszu i Pokaż przyciski w dwóch wierszach , zobacz CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::GetUserImages`

Zwraca wskaźnik do kolekcji obrazów przycisków paska narzędzi zdefiniowanych przez użytkownika w aplikacji.

static CMFCToolBarImages* GetUserImages();

Wartość zwracana

Wskaźnik do kolekcji obrazów przycisków paska narzędzi zdefiniowanych przez użytkownika dla wszystkich pasków narzędzi w aplikacji.

Uwagi

Wywołaj metodę CMFCToolBar::SetUserImages , aby ustawić kolekcję obrazów zdefiniowanych przez użytkownika w aplikacji.

`CMFCToolBar::HitTest`

Zwraca indeks przycisku paska narzędzi, który znajduje się w określonej pozycji.

virtual int HitTest(CPoint point);

Parametry

point
[in] Punkt do przetestowania we współrzędnych klienta.

Wartość zwracana

Indeks przycisku znajdującego się na określonej pozycji lub -1, jeśli nie ma takiego przycisku lub przycisk jest separatorem.

`CMFCToolBar::InsertButton`

Wstawia przycisk na pasku narzędzi.

virtual int InsertButton(
    const CMFCToolBarButton& button,
    INT_PTR iInsertAt=-1);

virtual int InsertButton(
    CMFCToolBarButton* pButton,
    int iInsertAt=-1);

Parametry

button
[in] Określa przycisk do wstawienia.

iInsertAt
[in] Określa pozycję opartą na zerach, aby wstawić przycisk.

Wartość zwracana

Położenie, w którym przycisk został wstawiony lub -1, jeśli wystąpi błąd.

Uwagi

Jeśli iInsertAt wartość to -1, ta metoda dodaje przycisk na końcu listy przycisków paska narzędzi.

Wywołaj metodę , CMFCToolBar::InsertSeparator aby wstawić separator do paska narzędzi.

`CMFCToolBar::InsertSeparator`

Wstawia separator do paska narzędzi.

virtual int InsertSeparator(INT_PTR iInsertAt=-1);

Parametry

iInsertAt
[in] Określa położenie na podstawie zera, aby wstawić separator w. Ten parametr musi być większy niż 0.

Wartość zwracana

Położenie, w którym separator został wstawiony lub -1, jeśli wystąpi błąd.

Uwagi

Wywołaj tę metodę, aby wstawić separator między dwoma istniejącymi przyciskami. Jeśli iInsertAt wartość to -1, ta metoda dodaje separator na końcu listy przycisków paska narzędzi.

Nie można użyć tej metody, aby dodać separator do pustego paska narzędzi.

Wywołaj metodę , CMFCToolBar::InsertButton aby wstawić przycisk na pasku narzędzi.

`CMFCToolBar::InvalidateButton`

Unieważnia obszar klienta przycisku paska narzędzi, który istnieje w podanym indeksie.

CMFCToolBarButton* InvalidateButton(int nIndex);

Parametry

nIndex
[in] Indeks zera przycisku na pasku narzędzi.

Wartość zwracana

Wskaźnik do CMFCToolBarButton obiektu, który istnieje w podanym indeksie lub NULL jeśli taki obiekt nie istnieje.

Uwagi

Struktura wywołuje tę metodę, gdy aktualizuje obszar klienta skojarzony z przyciskiem paska narzędzi. Wywołuje metodę CWnd::InvalidateRect z prostokątem CMFCToolBarButton klienta obiektu, który istnieje w podanym indeksie.

`CMFCToolBar::IsAddRemoveQuickCustomize`

Określa, czy użytkownik może dodawać lub usuwać przyciski paska narzędzi przy użyciu opcji menu Dostosuj .

BOOL IsAddRemoveQuickCustomize();

Wartość zwracana

TRUEjeśli użytkownik może użyć opcji menu Dostosuj, aby zmodyfikować pasek narzędzi; w przeciwnym razie . FALSE

Uwagi

`CMFCToolBar::IsAltCustomizeMode`

Określa, czy szybkie dostosowywanie jest używane do przeciągania przycisku. Po włączeniu szybkiego dostosowywania użytkownik może nacisnąć i trzymać Alt i przeciągnąć przycisk do nowej lokalizacji.

static BOOL __stdcall IsAltCustomizeMode();

Wartość zwracana

TRUE jeśli szybkie dostosowywanie jest używane do przeciągania przycisku; w przeciwnym razie, FALSE.

Uwagi

`CMFCToolBar::IsAutoGrayInactiveImages`

Określa, czy włączono automatyczne generowanie nieaktywnych (nie wyróżnionych) obrazów przycisków.

static BOOL IsAutoGrayInactiveImages();

Wartość zwracana

TRUE jeśli opcja automatycznego przyciemnienia nieaktywnych obrazów jest włączona; w przeciwnym razie FALSE.

Uwagi

Możesz włączyć lub wyłączyć automatyczne wygaszone obrazy nieaktywne, wywołując funkcję CMFCToolBar::AutoGrayInactiveImages.

`CMFCToolBar::IsBasicCommand`

Określa, czy polecenie znajduje się na liście podstawowych poleceń.

static BOOL IsBasicCommand(UINT uiCmd);

Parametry

uiCmd
[in] Określa polecenie do sprawdzenia.

Wartość zwracana

TRUE jeśli określone polecenie należy do listy podstawowych poleceń; w przeciwnym razie FALSE.

Uwagi

Ta metoda statyczna określa, czy polecenie określone przez uiCmd element należy do globalnej listy podstawowych poleceń. Listę podstawowych poleceń można zmienić, wywołując polecenie CMFCToolBar::AddBasicCommand lub CMFCToolBar::SetBasicCommands.

`CMFCToolBar::IsButtonExtraSizeAvailable`

Określa, czy pasek narzędzi może wyświetlać przyciski, które mają rozszerzone obramowania.

virtual BOOL IsButtonExtraSizeAvailable() const;

Wartość zwracana

TRUE jeśli pasek może wyświetlać przyciski o dodatkowym rozmiarze obramowania; w przeciwnym razie FALSE.

Uwagi

Obiekt paska narzędzi zwraca TRUE , jeśli może wyświetlać przyciski z rozszerzonymi obramowaniami. Przycisk paska narzędzi wywołuje tę metodę, gdy obsługuje CMFCToolBarButton::OnChangeParentWnd powiadomienie i odpowiednio ustawi wewnętrzną flagę dodatkowego rozmiaru obramowania. Ta flaga wewnętrzna może zostać pobrana później przez wywołanie metody CMFCToolBarButton::IsExtraSize.

Zastąp tę metodę w klasie pochodnej CMFCToolBar i zwróć, TRUE jeśli pasek może wyświetlać przyciski paska narzędzi z dodatkowym rozmiarem obramowania i zwracać FALSE w przeciwnym razie. Domyślna implementacja zwraca wartość TRUE.

`CMFCToolBar::IsButtonHighlighted`

Określa, czy określony przycisk jest wyróżniony.

BOOL IsButtonHighlighted(int iButton) const;

Parametry

iButton
[in] Określa indeks przycisku paska narzędzi.

Wartość zwracana

TRUE jeśli określony przycisk jest wyróżniony; w przeciwnym razie, FALSE.

Uwagi

`CMFCToolBar::IsCommandPermitted`

Określa, czy polecenie jest dozwolone.

static BOOL IsCommandPermitted(UINT uiCmd);

Parametry

uiCmd
[in] Określa polecenie do sprawdzenia.

Wartość zwracana

TRUE jeśli określone polecenie jest dozwolone; w przeciwnym razie FALSE.

Uwagi

Ta metoda statyczna określa, czy polecenie określone przez uiCmd należy do globalnej listy niedozwolonych poleceń.

Listę niedozwolonych poleceń można zmienić, wywołując polecenie CMFCToolBar::SetNonPermittedCommands.

`CMFCToolBar::IsCommandRarelyUsed`

Określa, czy polecenie jest rzadko używane.

static BOOL IsCommandRarelyUsed(UINT uiCmd);

Parametry

uiCmd
[in] Określa polecenie do sprawdzenia.

Wartość zwracana

TRUE jeśli określone polecenie jest rzadko używane; w przeciwnym razie FALSE.

Uwagi

Metoda IsCommandRarelyUsed zwraca FALSE , gdy wystąpi co najmniej jeden z następujących warunków:

Określone polecenie należy do listy podstawowych poleceń
Określone polecenie jest jednym ze standardowych poleceń
Struktura jest w trybie dostosowywania
Lista podstawowych poleceń jest pusta
Do określonego polecenia jest wywoływanych ponad 20% wywołań poleceń.

`CMFCToolBar::IsCustomizeMode`

Określa, czy struktura paska narzędzi jest w trybie dostosowywania.

static BOOL IsCustomizeMode();

Wartość zwracana

TRUE jeśli struktura jest w trybie dostosowywania; w przeciwnym razie FALSE.

Uwagi

Tryb dostosowywania można przełączać, wywołując polecenie CMFCToolBar::SetCustomizeMode.

Struktura zmienia tryb, gdy użytkownik wywołuje okno dialogowe dostosowywania ( CMFCToolBarsCustomizeDialog Klasa).

`CMFCToolBar::IsDragButton`

Określa, czy przycisk paska narzędzi jest przeciągany.

BOOL IsDragButton(const CMFCToolBarButton* pButton) const;

Parametry

pButton
[in] Wskaźnik do przycisku paska narzędzi.

Wartość zwracana

TRUE jeśli określony przycisk jest przeciągany; w przeciwnym razie, FALSE.

Uwagi

`CMFCToolBar::IsExistCustomizeButton`

Określa, czy pasek narzędzi zawiera przycisk Dostosuj .

BOOL IsExistCustomizeButton();

Wartość zwracana

TRUE jeśli pasek narzędzi zawiera przycisk Dostosuj ; w przeciwnym razie FALSE.

Uwagi

Jeśli ta metoda zwróci TRUEwartość , CMFCToolBar::GetCustomizeButton metoda zwraca wskaźnik do przycisku Dostosuj , który pojawi się na końcu paska narzędzi.

CMFCToolBar::EnableCustomizeButton Użyj metody , aby dodać przycisk Dostosuj do paska narzędzi.

`CMFCToolBar::IsFloating`

Określa, czy pasek narzędzi jest przestawny.

virtual BOOL IsFloating() const;

Wartość zwracana

TRUE jeśli pasek narzędzi jest przestawny; w przeciwnym razie, FALSE.

`CMFCToolBar::IsLargeIcons`

Określa, czy paski narzędzi w aplikacji aktualnie wyświetlają duże ikony.

static BOOL IsLargeIcons();

Wartość zwracana

TRUE jeśli aplikacja używa dużych ikon; w przeciwnym razie FALSE.

Uwagi

Wywołaj przełącznik CMFCToolBar::SetLargeIcons , aby przełączać się między dużymi ikonami i zwykłymi ikonami.

Platforma automatycznie zmienia tryb, gdy użytkownik przełącza pole wyboru Duże ikony na stronie Opcje okna dialogowego Dostosowywanie .

`CMFCToolBar::IsLastCommandFromButton`

Określa, czy ostatnio wykonane polecenie zostało wysłane z określonego przycisku paska narzędzi.

static BOOL IsLastCommandFromButton(CMFCToolBarButton* pButton);

Parametry

pButton
[in] Wskaźnik do przycisku.

Wartość zwracana

TRUE jeśli ostatnie polecenie zostało wysłane z przycisku, który pButton określa; w przeciwnym razie FALSE.

Uwagi

Ta metoda uzyskuje wskaźnik do struktury, wywołując metodę MSG CWnd::GetCurrentMessage. Następnie porównuje HWND przycisk z elementami MSG::lParam i MSG::hwnd , aby określić, czy przycisk był źródłem polecenia.

`CMFCToolBar::IsLocked`

Określa, czy pasek narzędzi jest zablokowany.

BOOL IsLocked() const;

Wartość zwracana

TRUE jeśli pasek narzędzi jest zablokowany; w przeciwnym razie, FALSE.

Uwagi

Ta metoda zwraca, TRUE gdy użytkownik nie może wykonywać zadań dostosowywania, takich jak zmienia położenie przycisków paska narzędzi.

Zablokowane paski narzędzi używają oddzielnych list obrazów. Aby uzyskać więcej informacji na temat tych list obrazów, zobacz CMFCToolBar::LoadBitmapEx.

`CMFCToolBar::IsOneRowWithSibling`

Określa, czy pasek narzędzi i jego równorzędny pasek narzędzi są umieszczone w tym samym wierszu.

BOOL IsOneRowWithSibling();

Wartość zwracana

TRUE jeśli pasek narzędzi i jego element równorzędny są umieszczone w tym samym wierszu; w przeciwnym razie FALSE.

Uwagi

Metoda CMFCCustomizeButton::CreatePopupMenu wywołuje tę metodę, aby określić sposób wyświetlania menu podręcznego Dostosowywanie . Jeśli ta metoda zwróci TRUEwartość , platforma wyświetli przycisk Pokaż przyciski w jednym wierszu . W przeciwnym razie platforma wyświetla przycisk Pokaż przyciski w dwóch wierszach .

Zazwyczaj nie trzeba używać tej metody. Aby włączyć przyciski Pokaż w jednym wierszu lub Pokaż przyciski w dwóch wierszach , wywołaj metodę CMFCToolBar::SetSiblingToolBar.

`CMFCToolBar::IsResourceChanged`

virtual BOOL IsResourceChanged() const;

Wartość zwracana

Uwagi

`CMFCToolBar::IsSibling`

BOOL IsSibling();

Wartość zwracana

Uwagi

`CMFCToolBar::IsUserDefined`

Określa, czy pasek narzędzi jest zdefiniowany przez użytkownika.

BOOL IsUserDefined() const;

Wartość zwracana

TRUE jeśli pasek narzędzi został utworzony przez użytkownika; w przeciwnym razie FALSE.

`CMFCToolBar::LoadBitmap`

Ładuje obrazy paska narzędzi z zasobów aplikacji.

virtual BOOL LoadBitmap(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0);

Parametry

uiResID
[in] Identyfikator zasobu mapy bitowej odwołujący się do gorących obrazów paska narzędzi.

uiColdResID
[in] Identyfikator zasobu mapy bitowej odwołującej się do zimnych obrazów paska narzędzi.

uiMenuResID
[in] Identyfikator zasobu mapy bitowej odwołujący się do zwykłych obrazów menu.

bLocked
[in] TRUE aby zablokować pasek narzędzi; w przeciwnym razie FALSE.

uiDisabledResID
[in] Identyfikator zasobu mapy bitowej odwołującej się do wyłączonych obrazów paska narzędzi.

uiMenuDisabledResID
[in] Identyfikator zasobu mapy bitowej odwołujący się do wyłączonych obrazów menu.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Metoda CMFCToolBar::LoadToolBarEx wywołuje tę metodę w celu załadowania obrazów skojarzonych z paskiem narzędzi. Zastąpij tę metodę, aby wykonać niestandardowe ładowanie zasobów obrazu.

Wywołaj metodę , LoadBitmapEx aby załadować dodatkowe obrazy po utworzeniu paska narzędzi.

`CMFCToolBar::LoadBitmapEx`

virtual BOOL LoadBitmapEx(
    CMFCToolBarInfo& params,
    BOOL bLocked = FALSE);

Parametry

[in] params
[in] bLocked\

Wartość zwracana

Uwagi

`CMFCToolBar::LoadLargeIconsState`

static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL);

Parametry

[in] lpszProfileName\

Wartość zwracana

Uwagi

`CMFCToolBar::LoadParameters`

Ładuje globalne opcje paska narzędzi z rejestru systemu Windows.

static BOOL LoadParameters(LPCTSTR lpszProfileName=NULL);

Parametry

lpszProfileName
[in] Określa ścieżkę względną klucza rejestru systemu Windows.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Ta metoda ładuje parametry globalne, takie jak typ animacji menu, styl cienia menu i czy mają być wyświetlane duże ikony z rejestru systemu Windows.

Metoda CWinAppEx::LoadState wywołuje tę metodę w ramach procesu inicjowania aplikacji.

`CMFCToolBar::LoadState`

Ładuje informacje o stanie paska narzędzi z rejestru systemu Windows.

virtual BOOL LoadState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametry

lpszProfileName
[in] Określa ścieżkę względną klucza rejestru systemu Windows.

nIndex
[in] Określa identyfikator kontrolki paska narzędzi.

uiID
[in] Określa identyfikator zasobu paska narzędzi.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Struktura wywołuje tę metodę jako część procesu inicjowania aplikacji. Aby uzyskać więcej informacji, zobacz CWinAppEx::LoadState.

`CMFCToolBar::LoadToolBar`

Ładuje pasek narzędzi z zasobów aplikacji.

virtual BOOL LoadToolBar(
    UINT uiResID,
    UINT uiColdResID=0,
    UINT uiMenuResID=0,
    BOOL bLocked=FALSE,
    UINT uiDisabledResID=0,
    UINT uiMenuDisabledResID=0,
    UINT uiHotResID=0);

Parametry

uiResID
[in] Identyfikator zasobu paska narzędzi.

uiColdResID
[in] Identyfikator zasobu mapy bitowej odwołującej się do zimnych obrazów paska narzędzi.

uiMenuResID
[in] Identyfikator zasobu mapy bitowej odwołujący się do zwykłych obrazów menu.

bLocked
[in] Wartość logiczna określająca, czy pasek narzędzi jest zablokowany, czy nie. Jeśli ten parametr to TRUE, pasek narzędzi jest zablokowany. W przeciwnym razie pasek narzędzi nie jest zablokowany.

uiDisabledResID
[in] Identyfikator zasobu mapy bitowej odwołującej się do wyłączonych obrazów paska narzędzi.

uiMenuDisabledResID
[in] Identyfikator zasobu mapy bitowej odwołujący się do wyłączonych obrazów menu.

uiHotResID
[in] Identyfikator zasobu mapy bitowej odwołujący się do gorących obrazów paska narzędzi.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Struktura wywołuje tę metodę podczas inicjowania w celu załadowania obrazów skojarzonych z paskiem narzędzi.

Przykład

W poniższym przykładzie pokazano, jak używać LoadToolBar metody w CMFCToolBar klasie . Ten fragment kodu jest częścią przykładu pokazu programu IE.

CMFCToolBar m_wndToolBar;

// The this pointer points to CMainFrame class which extends the CFrameWnd class.
if (!m_wndToolBar.CreateEx(this, TBSTYLE_TRANSPARENT) ||
    !m_wndToolBar.LoadToolBar(IDR_MAINFRAME, uiToolbarColdID, uiMenuID,
                              FALSE /* Not locked */, 0, 0, uiToolbarHotID))
{
   TRACE0("Failed to create toolbar\n");
   return -1; // fail to create
}

`CMFCToolBar::LoadToolBarEx`

Ładuje pasek narzędzi z zasobów aplikacji przy użyciu CMFCToolBarInfo klasy pomocnika, aby umożliwić aplikacji używanie dużych obrazów.

virtual BOOL LoadToolBarEx(
    UINT uiToolbarResID,
    CMFCToolBarInfo& params,
    BOOL bLocked=FALSE);

Parametry

uiToolbarResID
[in] Identyfikator zasobu paska narzędzi.

params
[in] Odwołanie do CMFCToolBarInfo obiektu zawierającego identyfikatory zasobów dla obrazów paska narzędzi.

bLocked
[in] Wartość logiczna określająca, czy pasek narzędzi jest zablokowany, czy nie. Jeśli ten parametr to TRUE, pasek narzędzi jest zablokowany. W przeciwnym razie pasek narzędzi nie jest zablokowany.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Wywołaj tę metodę, aby załadować obrazy paska narzędzi z zasobów aplikacji.

`CMFCToolBar::m_dblLargeImageRatio`

Określa stosunek wymiarów (wysokość lub szerokość) dużych obrazów i wymiar zwykłych obrazów.

AFX_IMPORT_DATA static double m_dblLargeImageRatio;

Uwagi

Domyślny współczynnik to 2. Tę wartość można zmienić, aby duże obrazy pasków narzędzi było większe lub mniejsze.

Platforma używa tego elementu członkowskiego danych, gdy nie określasz zestawu dużych obrazów. Jeśli na przykład podasz tylko zestaw małych obrazów o rozmiarze 16x16 i chcesz, aby duże obrazy miały rozmiar 24x24, ustaw ten element członkowski danych na 1,5.

`CMFCToolBar::NextMenu`

virtual BOOL NextMenu();

Wartość zwracana

Uwagi

`CMFCToolBar::OnBeforeRemoveButton`

virtual BOOL OnBeforeRemoveButton(
    CMFCToolBarButton* pButton,
    DROPEFFECT dropEffect);

Parametry

pButton
[in] Nieużywane.

dropEffect
[in] Nieużywane.

Wartość zwracana

Uwagi

`CMFCToolBar::OnChangeHot`

Wywoływana przez platformę, gdy użytkownik wybierze przycisk na pasku narzędzi.

virtual void OnChangeHot(int iHot);

Parametry

iHot
[in] Określa indeks zaznaczonego przycisku paska narzędzi; lub -1, jeśli nie wybrano przycisku paska narzędzi.

Uwagi

Zastąpij tę metodę, aby przetwarzać powiadomienia, które użytkownik wybrał przycisk na pasku narzędzi.

`CMFCToolBar::OnChangeVisualManager`

virtual void OnChangeVisualManager();

Uwagi

`CMFCToolBar::OnFillBackground`

Wywoływana przez strukturę z CBasePane::DoPaint , aby wypełnić tło paska narzędzi.

virtual void OnFillBackground(CDC* pDC);

Parametry

pDC
[in] Wskaźnik do kontekstu urządzenia.

Uwagi

CMFCToolBar::DoPaint wywołuje tę metodę, gdy tło paska narzędzi zostało wypełnione. Domyślna implementacja nic nie robi.

Zastąp tę metodę, aby narysować niestandardowe tło w klasach pochodnych.

`CMFCToolBar::OnGlobalFontsChanged`

virtual void OnGlobalFontsChanged();

Uwagi

`CMFCToolBar::OnReset`

Przywraca pasek narzędzi do stanu pierwotnego.

virtual void OnReset();

Uwagi

Zastąpi tę metodę do obsługi powiadomień o zresetowaniu paska narzędzi.

Domyślna implementacja nic nie robi. Przesłonięcia OnReset w klasie pochodzącej od CMFCToolBar momentu, gdy pasek narzędzi ma fikcyjne przyciski, które należy zamienić, gdy pasek narzędzi powróci do pierwotnego stanu.

`CMFCToolBar::OnSetAccData`

virtual BOOL OnSetAccData(long lVal);

Parametry

[in] lVal\

Wartość zwracana

Uwagi

`CMFCToolBar::OnSetDefaultButtonText`

Przywraca tekst przycisku paska narzędzi do stanu domyślnego.

virtual BOOL OnSetDefaultButtonText(CMFCToolBarButton* pButton);

Parametry

pButton
[in] Wskazuje przycisk, którego tekst jest ustawiany.

Wartość zwracana

TRUE jeśli tekst został pomyślnie przywrócony; w przeciwnym razie FALSE.

Uwagi

Zastąpij tę metodę, aby przetworzyć powiadomienia, że tekst przycisku paska narzędzi jest zmieniany na domyślny.

Domyślna implementacja ładuje tekst przycisku z zasobów aplikacji.

`CMFCToolBar::OnUserToolTip`

Wywoływana przez strukturę, gdy etykietka narzędzia przycisku ma być wyświetlana.

virtual BOOL OnUserToolTip(
    CMFCToolBarButton* pButton,
    CString& strTTText) const;

Parametry

pButton
[in] Wskazuje przycisk paska narzędzi, dla którego ma być wyświetlana etykietka narzędzia.

strTTText
[out] Odwołanie do CString obiektu, który odbiera tekst etykietki narzędzia.

Wartość zwracana

TRUE jeśli strTTText został wypełniony tekstem etykietki narzędzia; w przeciwnym razie FALSE.

Uwagi

Struktura wywołuje tę metodę, gdy zostanie wyświetlona etykietka narzędzia dla przycisku paska narzędzi. Jeśli OnUserToolTip funkcja zwraca TRUEwartość , platforma wyświetla etykietkę narzędzia zawierającą tekst zwracany przez OnUserToolTip element w pliku strTTText. W przeciwnym razie etykietka narzędzia zawiera tekst przycisku.

Zastąpij, OnUserToolTip aby dostosować wskazówki dotyczące narzędzi przycisków paska narzędzi. Domyślne wywołania CMFCToolBar::OnUserToolTip implementacji w celu uzyskania tekstu etykietki narzędzia.

`CMFCToolBar::PrevMenu`

virtual BOOL PrevMenu();

Wartość zwracana

Uwagi

`CMFCToolBar::ProcessCommand`

WM_COMMAND Publikuje komunikat w oknie, który jest właścicielem paska narzędzi.

BOOL ProcessCommand(CMFCToolBarButton* pButton);

Parametry

pButton
[in] Wskaźnik do przycisku na pasku narzędzi.

Wartość zwracana

Ta metoda powinna zawsze zwracać wartość TRUE. MFC używa FALSE wartości wewnętrznie.

Uwagi

Ta metoda publikuje WM_COMMAND komunikat w oknie, które jest właścicielem paska narzędzi, wywołując CWnd::PostMessage i przekazując identyfikator polecenia określonego przycisku jako parametr.wParam

Użyj makra ON_COMMAND , aby zamapować komunikat na WM_COMMAND funkcję składową.

`CMFCToolBar::RemoveAllButtons`

Usuwa wszystkie przyciski i separatory z paska narzędzi.

virtual void RemoveAllButtons();

Uwagi

Struktura wywołuje tę metodę podczas ponownego tworzenia lub niszczenia paska narzędzi.

`CMFCToolBar::RemoveButton`

Usuwa z paska narzędzi przycisk, który ma określony indeks.

virtual BOOL RemoveButton(int iIndex);

Parametry

iIndex
[in] Określa indeks zerowy przycisku do usunięcia.

Wartość zwracana

TRUE jeśli metoda powiedzie się lub FALSE określony indeks jest nieprawidłowy lub indeks odwołuje się do przycisku Dostosuj .

Uwagi

Ta metoda aktualizuje dodatkowe atrybuty paska narzędzi, których dotyczy usunięcie przycisku. Na przykład ta metoda usuwa separatory nonessential z paska narzędzi i ponownie kompiluje tabelę skrótów.

Aby uzyskać więcej informacji na temat przycisku Dostosuj , zobacz CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::RemoveStateFromRegistry`

Usuwa informacje o stanie paska narzędzi z rejestru systemu Windows.

virtual BOOL RemoveStateFromRegistry(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametry

lpszProfileName
[in] Określa klucz rejestru, w którym znajdują się informacje o stanie.

nIndex
[in] Identyfikator kontrolki paska narzędzi.

uiID
[in] Identyfikator zasobu paska narzędzi. Jeśli ten parametr ma wartość -1, ta metoda używa CWnd::GetDlgCtrlID metody do pobrania identyfikatora zasobu.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Struktura wywołuje tę metodę po usunięciu zdefiniowanego przez użytkownika paska narzędzi.

Zastąpi tę metodę, jeśli przechowujesz dodatkowe informacje o stanie w rejestrze systemu Windows.

`CMFCToolBar::ReplaceButton`

Zamienia przycisk paska narzędzi na inny przycisk paska narzędzi.

int ReplaceButton(
    UINT uiCmd,
    const CMFCToolBarButton& button,
    BOOL bAll=FALSE);

Parametry

uiCmd
[in] Identyfikator polecenia przycisku do zastąpienia.

button
[in] Odwołanie do wstawiania CMFCToolBarButton .

bAll
[in] Wartość logiczna określająca, czy zastąpić wszystkie przyciski, które mają identyfikator polecenia określony przez uiCmd. Jeśli ten parametr to TRUE, wszystkie przyciski, które mają określony identyfikator polecenia, zostaną zamienione. W przeciwnym razie pierwszy przycisk zostanie zastąpiony.

Wartość zwracana

Liczba zastąpionych przycisków. Ta metoda zwraca wartość 0, jeśli przycisk z określonym identyfikatorem polecenia nie istnieje na pasku narzędzi.

Uwagi

Wywołaj tę metodę, jeśli chcesz dodać przyciski paska narzędzi, których nie można załadować z zasobów. Przycisk symbolu zastępczego można utworzyć w czasie projektowania i zastąpić ten przycisk przyciskiem niestandardowym podczas inicjowania paska narzędzi. Zobacz przykład VisualStudioDemo, aby zapoznać się z przykładem, który używa tej metody.

Przykład

W poniższym przykładzie pokazano, jak używać ReplaceButton metody w CMFCToolBar klasie . Ten fragment kodu jest częścią przykładu pokazu programu IE.

CMFCToolBar m_wndToolBar;

// CMenu menuHistory
// CString str
m_wndToolBar.ReplaceButton(ID_GO_BACK,
                           CMFCToolBarMenuButton(ID_GO_BACK, menuHistory,
                                                 GetCmdMgr()->GetCmdImage(ID_GO_BACK), str));

`CMFCToolBar::ResetAll`

Przywraca wszystkie paski narzędzi do ich oryginalnych stanów.

static void __stdcall ResetAll();

Uwagi

Ta metoda wywołuje metodę CMFCToolBar::RestoreOriginalState na każdym pasku narzędzi w aplikacji, którą można przywrócić. Używa CMFCToolBar::CanBeRestored metody w celu określenia, czy można przywrócić pasek narzędzi.

`CMFCToolBar::ResetAllImages`

Czyści wszystkie kolekcje obrazów paska narzędzi w aplikacji.

static void __stdcall ResetAllImages();

Uwagi

Ta metoda czyści kolekcje obrazów, które są inicjowane przez CMFCToolBar::LoadToolBar metody i CMFCToolBar::LoadBitmap .

`CMFCToolBar::ResetImages`

virtual void ResetImages();

Uwagi

`CMFCToolBar::RestoreFocus`

virtual void RestoreFocus();

Uwagi

`CMFCToolBar::RestoreOriginalState`

Przywraca oryginalny stan paska narzędzi.

virtual BOOL RestoreOriginalState();

Wartość zwracana

TRUE jeśli metoda powiedzie się lub FALSE jeśli metoda zakończy się niepowodzeniem lub pasek narzędzi jest zdefiniowany przez użytkownika.

Uwagi

Ta metoda ładuje pasek narzędzi z pliku zasobu przy użyciu CMFCToolBar::LoadToolBar metody .

Platforma wywołuje tę metodę, gdy użytkownik wybierze przycisk Resetuj wszystko na stronie Paski narzędzi okna dialogowego dostosowywania.

`CMFCToolBar::SaveParameters`

static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL);

Parametry

[in] lpszProfileName\

Wartość zwracana

Uwagi

`CMFCToolBar::SaveState`

Zapisuje informacje o stanie paska narzędzi w rejestrze systemu Windows.

virtual BOOL SaveState(
    LPCTSTR lpszProfileName=NULL,
    int nIndex=-1,
    UINT uiID=(UINT)-1);

Parametry

lpszProfileName
[in] Określa ścieżkę względną klucza rejestru systemu Windows.

nIndex
[in] Identyfikator kontrolki paska narzędzi.

uiID
[in] Identyfikator zasobu paska narzędzi.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Struktura wywołuje tę metodę podczas zapisywania stanu aplikacji w rejestrze. Aby uzyskać więcej informacji, zobacz CWinAppEx::SaveState.

`CMFCToolBar::SetBasicCommands`

Ustawia listę poleceń, które są zawsze wyświetlane po otwarciu menu przez użytkownika.

static void __stdcall SetBasicCommands(CList<UINT,UINT>& lstCommands);

Parametry

lstCommands
[in] Odwołanie do CList obiektu zawierającego kolekcję poleceń.

Uwagi

Podstawowe polecenie jest zawsze wyświetlane po otwarciu menu. Ta metoda ma znaczenie, gdy użytkownik zdecyduje się wyświetlić ostatnio używane polecenia.

CMFCToolBar::AddBasicCommand Użyj metody , aby dodać polecenie do listy podstawowych poleceń. CMFCToolBar::GetBasicCommands Użyj metody , aby pobrać listę podstawowych poleceń używanych przez aplikację.

Zobacz przykład Eksploratora, aby zapoznać się z przykładem, który używa tej metody.

`CMFCToolBar::SetButtonInfo`

Ustawia identyfikator polecenia, styl i identyfikator obrazu przycisku paska narzędzi.

void SetButtonInfo(
    int nIndex,
    UINT nID,
    UINT nStyle,
    int iImage);

Parametry

nIndex
[in] Indeks na podstawie zera przycisku, którego właściwości są ustawione.

nID
[in] Identyfikator polecenia przycisku.

nStyle
[in] Styl przycisku. Aby uzyskać listę dostępnych stylów przycisków paska narzędzi, zobacz ToolBar Control Styles (Style kontrolek paska narzędzi).

iImage
[in] Indeks obrazu oparty na zera przycisku (czyli indeks w kolekcji obrazów paska narzędzi).

Uwagi

Wywołaj tę metodę, aby ustawić właściwości przycisku paska narzędzi.

W obszarze Kompilacje debugowania ta metoda generuje błąd asercji, jeśli indeks określony przez nIndex jest nieprawidłowy.

Wywołaj metodę CMFCToolBar::SetButtonStyle , aby ustawić tylko styl przycisku.

`CMFCToolBar::SetButtons`

Ustawia przyciski paska narzędzi.

virtual BOOL SetButtons(
    const UINT* lpIDArray,
    int nIDCount,
    BOOL bRemapImages=TRUE);

Parametry

lpIDArray
[in] Wskaźnik do tablicy identyfikatorów poleceń przycisków do wstawienia.

nIDCount
[in] Liczba elementów w elem lpIDArray.

bRemapImages
[in] Wartość logiczna określająca, czy skojarzyć istniejące obrazy przycisków z wstawionym przyciskiem. Jeśli ten parametr to TRUE, obrazy są ponownie mapowane.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0.

Uwagi

Wywołaj tę metodę, aby usunąć istniejące przyciski z paska narzędzi i wstawić kolekcję nowych przycisków.

Ta metoda dodaje przycisk Dostosuj do paska narzędzi i wysyła AFX_WM_RESETTOOLBAR komunikat do okna nadrzędnego paska narzędzi. Aby uzyskać więcej informacji na temat przycisku Dostosuj , zobacz CMFCToolBar::EnableCustomizeButton.

`CMFCToolBar::SetButtonStyle`

Ustawia styl przycisku paska narzędzi w danym indeksie.

virtual void SetButtonStyle(
    int nIndex,
    UINT nStyle);

Parametry

nIndex
[in] Indeks na podstawie zera przycisku paska narzędzi, którego styl ma zostać ustawiony.

nStyle
[in] Styl przycisku. Aby uzyskać listę dostępnych stylów przycisków paska narzędzi, zobacz ToolBar Control Styles (Style kontrolek paska narzędzi).

Uwagi

Ta metoda usuwa styl, TBBS_PRESSED jeśli nStyle jest TBBS_DISABLED , ponieważ użytkownik nie może wybrać wyłączonego przycisku.

`CMFCToolBar::SetButtonText`

Ustawia etykietę tekstową przycisku paska narzędzi.

BOOL SetButtonText(
    int nIndex,
    LPCTSTR lpszText);

Parametry

nIndex
[in] Indeks przycisku paska narzędzi.

lpszText
[in] Etykieta tekstowa przycisku paska narzędzi. Musi mieć wartość inną niż null.

Wartość zwracana

TRUE jeśli metoda powiedzie się; w przeciwnym razie FALSE.

Uwagi

Ta metoda zwraca FALSE wartość, jeśli podany indeks nie odwołuje się do prawidłowego przycisku paska narzędzi.

`CMFCToolBar::SetCommandUsageOptions`

Określa, kiedy rzadko używane polecenia nie są wyświetlane w menu aplikacji.

static BOOL SetCommandUsageOptions(
    UINT nStartCount,
    UINT nMinUsagePercentage=5);

Parametry

nStartCount
[in] Określa liczbę wykonywanych poleceń przed wyświetleniem tylko podstawowych i ostatnio używanych poleceń.

nMinUsagePercentage
[in] Procent razy, w których należy wykonać polecenie, należy uznać za ostatnio używane polecenie.

Wartość zwracana

FALSE jeśli nMinUsagePercentage wartość jest równa lub większa niż 100; w przeciwnym razie TRUE.

Uwagi

Wywołaj tę metodę, aby dostosować algorytm używany przez platformę do określenia, jak są wyświetlane podstawowe i ostatnio używane elementy menu. Aby uzyskać więcej informacji na temat podstawowych poleceń, zobacz CMFCToolBar::AddBasicCommand.

Ta klasa używa CMFCCmdUsageCount klasy do śledzenia liczby poleceń użycia. Aby uzyskać więcej informacji na temat tej klasy, zobacz CMFCCmdUsageCount Klasa.

`CMFCToolBar::SetCustomizeMode`

Włącza lub wyłącza tryb dostosowywania dla wszystkich pasków narzędzi w aplikacji.

static BOOL __stdcall SetCustomizeMode(BOOL bSet=TRUE);

Parametry

bSet
[in] Wartość logiczna określająca, czy włączyć lub wyłączyć tryb dostosowywania. Ustaw ten parametr na wartość , aby TRUE włączyć tryb dostosowywania lub FALSE wyłączyć go.

Wartość zwracana

TRUE jeśli wywołanie tej metody spowoduje zmianę trybu dostosowywania; w przeciwnym razie FALSE.

Uwagi

Ta metoda dostosowuje układ i ponownie rysuje każdy pasek narzędzi w aplikacji. Wywołaj metodę , CMFCToolBar::IsCustomizeMode aby określić, czy aplikacja jest w trybie dostosowywania,

`CMFCToolBar::SetGrayDisabledButtons`

Określa, czy przyciski niedostępne na pasku narzędzi są wygaszone, czy też są używane niedostępne obrazy przycisków.

void SetGrayDisabledButtons(BOOL bGrayDisabledButtons);

Parametry

bGrayDisabledButtons
[in] Wartość logiczna określająca sposób wyświetlania przycisków niedostępnych. Jeśli ten parametr to TRUE, struktura przyciemnia przyciski. W przeciwnym razie platforma używa kolekcji obrazów niedostępnych przycisków.

Uwagi

Domyślnie niedostępne przyciski są wygaszone.

`CMFCToolBar::SetHeight`

Ustawia wysokość paska narzędzi.

void SetHeight(int cyHeight);

Parametry

cyHeight
[in] Wysokość paska narzędzi w pikselach.

Uwagi

Ta metoda ponownie rysuje pasek narzędzi po jego ustawianiu wysokości.

`CMFCToolBar::SetHelpMode`

static void __stdcall SetHelpMode(BOOL bOn = TRUE);

Parametry

[in] bOn\

Uwagi

`CMFCToolBar::SetHot`

BOOL SetHot(CMFCToolBarButton* pMenuButton);

Parametry

[in] pMenuButton\

Wartość zwracana

Uwagi

`CMFCToolBar::SetHotBorder`

Określa, czy przyciski paska narzędzi są śledzone na gorąco.

void SetHotBorder(BOOL bShowHotBorder);

Parametry

bShowHotBorder
[in] Wartość logiczna określająca, czy przyciski paska narzędzi śledzenia na gorąco. Jeśli ten parametr to TRUE, pasek narzędzi śledzi jego przyciski na gorąco. W przeciwnym razie pasek narzędzi nie śledzi przycisków na gorąco.

Uwagi

Jeśli przycisk jest śledzony na gorąco, platforma wyróżnia przycisk, gdy mysz przechodzi przez nią. Domyślnie każdy pasek narzędzi śledzi jego przyciski.

Wywołaj metodę , CMFCToolBar::GetHotBorder aby określić, czy pasek narzędzi śledzi jego przyciski.

`CMFCToolBar::SetHotTextColor`

Ustawia kolor tekstu dla przycisków gorącego paska narzędzi.

static void SetHotTextColor(COLORREF clrText);

Parametry

clrText
[in] Określa kolor tekstu przycisków paska narzędzi, które są śledzone na gorąco.

Uwagi

Aby uzyskać więcej informacji na temat przycisków paska narzędzi śledzonych na gorąco, zobacz CMFCToolBar::GetHotBorder i CMFCToolBar::SetHotBorder.

`CMFCToolBar::SetIgnoreSetText`

void SetIgnoreSetText(BOOL bValue);

Parametry

[in] bValue\

Uwagi

`CMFCToolBar::SetLargeIcons`

Określa, czy przyciski paska narzędzi wyświetlają duże ikony.

static void SetLargeIcons(BOOL bLargeIcons=TRUE);

Parametry

bLargeIcons
[in] Wartość logiczna określająca, które ikony mają być używane. Jeśli ten parametr to TRUE, platforma wyświetla duże ikony. W przeciwnym razie platforma wyświetla zwykłe ikony.

Uwagi

Struktura wywołuje tę metodę, gdy użytkownik zmieni stan pola wyboru Duże ikony na karcie Opcje okna dialogowego Dostosowywanie . Ta metoda zmienia rozmiar wszystkich pasków narzędzi w aplikacji.

Domyślnie platforma wyświetla zwykłe ikony.

Aby uzyskać więcej informacji na temat okna dialogowego Dostosowywanie , zobacz CMFCToolBarsCustomizeDialog Klasa.

`CMFCToolBar::SetLockedSizes`

Ustawia rozmiary zablokowanych przycisków i zablokowane obrazy na pasku narzędzi.

void SetLockedSizes(
    SIZE sizeButton,
    SIZE sizeImage,
    BOOL bDontScale = FALSE);

Parametry

sizeButton
[in] Określa rozmiar zablokowanych przycisków paska narzędzi.

sizeImage
[in] Określa rozmiar zablokowanych obrazów paska narzędzi.

bDontScale
Określa, czy obrazy paska narzędzi mają być skalowane, czy nie są blokowane w trybie wysokiej rozdzielczości DPI.

Uwagi

Domyślny rozmiar zablokowanych przycisków to 23x22 pikseli. Domyślny rozmiar zablokowanych obrazów to 16x15 pikseli.

Wywołaj metodę , CMFCToolBar::GetLockedImageSize aby pobrać rozmiar zablokowanych obrazów. Wywołaj metodę , CMFCToolBar::GetButtonSize aby pobrać rozmiar zablokowanych przycisków paska narzędzi.

`CMFCToolBar::SetMaskMode`

void SetMaskMode(BOOL bMasked);

Parametry

[in] bMasked\

Uwagi

`CMFCToolBar::SetMenuSizes`

Ustawia rozmiar przycisków menu paska narzędzi i ich obrazów.

static void __stdcall SetMenuSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parametry

sizeButton
[in] Określa rozmiar przycisków paska narzędzi w pikselach.

sizeImage
[in] Określa rozmiar obrazów paska narzędzi w pikselach.

Uwagi

Domyślnie przyciski menu i ich obrazy mają niezdefiniowany rozmiar.

Wywołaj metodę , CMFCToolBar::GetMenuButtonSize aby określić rozmiar przycisków menu i CMFCToolBar::GetMenuImageSize metodę w celu określenia rozmiaru obrazów przycisków menu.

Zapoznaj się z przykładami IEDemo i MSMoneyDemo, aby zapoznać się z przykładami korzystającymi z tej metody.

`CMFCToolBar::SetNonPermittedCommands`

Ustawia listę poleceń, których nie można wykonać przez użytkownika.

static void SetNonPermittedCommands(CList<UINT,UINT>& lstCommands);

Parametry

lstCommands
[in] Odwołanie do obiektu zawierającego CList polecenia, których nie można wykonać przez użytkownika.

Uwagi

Wywołaj tę metodę, aby uniemożliwić użytkownikowi wybranie niektórych poleceń. Na przykład możesz uniemożliwić użytkownikowi wybranie określonych poleceń ze względów bezpieczeństwa. Zapoznaj się z przykładami MDITabsDemo i MenuSubSet, aby zapoznać się z przykładami korzystającymi z tej metody.

Ta metoda czyści poprzednią listę niedozwolonych poleceń. Domyślnie lista niedozwolonych poleceń jest pusta.

`CMFCToolBar::SetOneRowWithSibling`

Umieszcza pasek narzędzi i jego element równorzędny w tym samym wierszu.

void SetOneRowWithSibling();

Uwagi

Platforma wywołuje tę metodę, gdy użytkownik wybierze przycisk Pokaż przyciski w jednym wierszu .

Wywołaj metodę CMFCToolBar::SetSiblingToolBar , aby włączyć przyciski Pokaż w jednym wierszu lub Pokaż przyciski na dwóch wierszach . W przypadku wywołania CMFCToolBar::SetSiblingToolBar tego paska narzędzi równorzędny pasek narzędzi zostanie przeniesiony do wiersza tego paska narzędzi. W przeciwnym razie ten pasek narzędzi zostanie przeniesiony do wiersza elementu równorzędnego.

Platforma wywołuje metodę CMFCToolBar::SetTwoRowsWithSibling , gdy użytkownik wybierze przycisk Pokaż przyciski w dwóch wierszach .

`CMFCToolBar::SetOrigButtons`

void SetOrigButtons(const CObList& lstOrigButtons);

Parametry

[in] lstOrigButtons\

Uwagi

`CMFCToolBar::SetPermament`

Określa, czy użytkownik może zamknąć pasek narzędzi.

void SetPermament(BOOL bPermament=TRUE);

Parametry

bPermament
[in] Wartość logiczna określająca, czy użytkownik może zamknąć pasek narzędzi. Jeśli ten parametr to TRUE, użytkownik nie może zamknąć paska narzędzi. W przeciwnym razie użytkownik może zamknąć pasek narzędzi.

Uwagi

Domyślnie użytkownik może zamknąć każdy pasek narzędzi.

Wywołaj metodę , CMFCToolBar::CanBeClosed aby określić, czy użytkownik może zamknąć pasek narzędzi.

`CMFCToolBar::SetRouteCommandsViaFrame`

Określa, czy ramka nadrzędna, czy właściciel wysyła polecenia do paska narzędzi.

void SetRouteCommandsViaFrame(BOOL bValue);

Parametry

bValue
[in] Jeśli ten parametr to TRUE, ramka nadrzędna wysyła polecenia do paska narzędzi. W przeciwnym razie właściciel wysyła polecenia do paska narzędzi.

Uwagi

Domyślnie ramka nadrzędna wysyła polecenia do paska narzędzi. Wywołaj metodę , CMFCToolBar::GetRouteCommandsViaFrame aby określić, czy ramka nadrzędna, czy właściciel wysyła polecenia do paska narzędzi.

`CMFCToolBar::SetShowTooltips`

Określa, czy platforma wyświetla wskazówki dotyczące narzędzi.

static void SetShowTooltips(BOOL bValue);

Parametry

bValue
[in] Jeśli ten parametr to TRUE, platforma wyświetla wskazówki dotyczące narzędzi. W przeciwnym razie struktura ukrywa wskazówki dotyczące narzędzi.

Uwagi

Domyślnie platforma wyświetla porady dotyczące narzędzi.

Wywołaj metodę , CMFCToolBar::GetShowTooltips aby określić, czy platforma wyświetla wskazówki dotyczące narzędzi.

`CMFCToolBar::SetSiblingToolBar`

Określa element równorzędny paska narzędzi.

void SetSiblingToolBar(CMFCToolBar* pBrotherToolbar);

Parametry

pBrotherToolbar
[in] Wskaźnik do paska narzędzi elementu równorzędnego.

Uwagi

Ta metoda włącza przyciski Pokaż w jednym wierszu lub Pokaż przyciski w dwóch wierszach , które są wyświetlane, gdy użytkownik wyświetli menu podręczne Dostosuj . Wywołaj tę metodę, aby umożliwić użytkownikowi określenie, czy powiązane paski narzędzi są wyświetlane w tym samym wierszu, czy w różnych wierszach.

Wywołaj tę metodę po włączeniu przycisku Dostosuj wyświetlanego na pasku narzędzi. Aby włączyć przycisk Dostosuj , wywołaj metodę CMFCToolBar::EnableCustomizeButton .

Aby pobrać element równorzędny paska narzędzi, wywołaj metodę CMFCToolBar::GetSiblingToolBar.

`CMFCToolBar::SetSizes`

Określa rozmiary przycisków i obrazów na wszystkich paskach narzędzi.

static void __stdcall SetSizes(
    SIZE sizeButton,
    SIZE sizeImage);

Parametry

sizeButton
[in] Rozmiar przycisków paska narzędzi w pikselach.

sizeImage
[in] Rozmiar obrazów przycisków paska narzędzi w pikselach.

Uwagi

Domyślny rozmiar przycisków paska narzędzi to 23x22 pikseli. Domyślny rozmiar obrazów przycisków paska narzędzi to 16x15 pikseli.

Wywołaj metodę , CMFCToolBar::GetImageSize aby pobrać rozmiar obrazów przycisków paska narzędzi. Wywołaj metodę , CMFCToolBar::GetButtonSize aby pobrać rozmiar przycisków paska narzędzi.

`CMFCToolBar::SetToolBarBtnText`

Określa właściwości przycisku na pasku narzędzi.

void SetToolBarBtnText(
    UINT nBtnIndex,
    LPCTSTR szText=NULL,
    BOOL bShowText=TRUE,
    BOOL bShowImage=TRUE);

Parametry

nBtnIndex
[in] Indeks paska narzędzi na podstawie zera na liście przycisków paska narzędzi.

szText
[in] Określa etykietę tekstową przycisku paska narzędzi.

bShowText
[in] Jeśli ten parametr to TRUE, platforma wyświetla etykietę tekstową. W przeciwnym razie struktura ukrywa etykietę tekstową.

bShowImage
[in] Jeśli ten parametr to TRUE, platforma wyświetla obraz przycisku paska narzędzi. W przeciwnym razie struktura ukrywa obraz przycisku paska narzędzi.

Uwagi

Domyślnie platforma wyświetla obrazy przycisków paska narzędzi, ale nie wyświetla etykiety tekstowej przycisków paska narzędzi.

W obszarze Kompilacje debugowania ta metoda generuje błąd asercji, jeśli nBtnIndex nie odwołuje się do prawidłowego przycisku paska narzędzi lub przycisk paska narzędzi jest separatorem.

`CMFCToolBar::SetTwoRowsWithSibling`

Umieszcza pasek narzędzi i jego element równorzędny w osobnych wierszach.

void SetTwoRowsWithSibling();

Uwagi

Platforma wywołuje tę metodę, gdy użytkownik wybierze przycisk Pokaż przyciski w dwóch wierszach .

Wywołaj metodę CMFCToolBar::SetSiblingToolBar , aby włączyć przyciski Pokaż w jednym wierszu lub Pokaż przyciski na dwóch wierszach . W przypadku wywołania CMFCToolBar::SetSiblingToolBar tego paska narzędzi równorzędny pasek narzędzi zostanie przeniesiony do oddzielnego wiersza. W przeciwnym razie ten pasek narzędzi zostanie przeniesiony do oddzielnego wiersza.

Platforma wywołuje metodę CMFCToolBar::SetOneRowWithSibling , gdy użytkownik wybierze przycisk Pokaż przyciski w jednym wierszu .

`CMFCToolBar::SetUserImages`

Ustawia kolekcję obrazów zdefiniowanych przez użytkownika w aplikacji.

static BOOL SetUserImages(CMFCToolBarImages* pUserImages);

Parametry

pUserImages
[in] Wskaźnik do kolekcji obrazów zdefiniowanych przez użytkownika.

Wartość zwracana

Nonzero, jeśli metoda powiedzie się; w przeciwnym razie 0, jeśli określony CMFCToolBarImages obiekt jest nieprawidłowy lub ma rozmiar obrazu, który różni się od domyślnego rozmiaru obrazu paska narzędzi.

Uwagi

Struktura używa obrazów zdefiniowanych przez użytkownika do rysowania przycisków paska narzędzi dostosowanych przez użytkownika. Lista obrazów określona przez pUserImages program jest współdzielona między wszystkimi paskami narzędzi w aplikacji.

Ta metoda generuje błąd asercji w kompilacjach debugowania, jeśli określony CMFCToolBarImages obiekt jest nieprawidłowy lub ma rozmiar obrazu, który różni się od domyślnego rozmiaru obrazu paska narzędzi.

Przykłady OutlookDemo, ToolTipDemo i VisualStudioDemo używają tej metody do ustawiania globalnej kolekcji obrazów zdefiniowanych przez użytkownika. Ładują plik o nazwie UserImages.bmp, który znajduje się w katalogu roboczym aplikacji.

Wywołaj metodę "CMFCToolBar::GetUserImages ", aby pobrać kolekcję obrazów zdefiniowanych przez użytkownika w aplikacji.

`CMFCToolBar::StretchPane`

Rozciąga pasek narzędzi w pionie lub w poziomie i zmienia położenie przycisków w razie potrzeby.

virtual CSize StretchPane(
    int nLength,
    BOOL bVert);

Parametry

nLength
[in] Ilość w pikselach, w których należy rozciągnąć okienko.

bVert
[in] Jeśli TRUEelement , rozciąga okienko w pionie. Jeśli FALSEwartość , rozciąga okienko w poziomie.

Wartość zwracana

CSize Obiekt określający rozmiar obszaru klienta paska narzędzi.

Uwagi

Ta metoda wywołuje polecenie CMFCToolBar::WrapToolBar , aby zmienić położenie przycisków na rozproszony pasek narzędzi.

Wartość zwracana jest określana przez wywołanie metody CMFCToolBar::CalcSize.

`CMFCToolBar::TranslateChar`

Wykonuje polecenie przycisku, jeśli określony kod klucza odpowiada prawidłowemu skrótowi klawiaturowemu.

virtual BOOL TranslateChar(UINT nChar);

Parametry

nChar
[in] Określa kod klucza wirtualnego. Aby uzyskać listę standardowych kodów kluczy wirtualnych, zobacz Winuser.h

Wartość zwracana

FALSE jeśli określony kod klucza jest niedrukowalny lub nie odpowiada prawidłowemu skrótowi klawiaturowemu; TRUE jeśli określony kod klucza odpowiada opcji menu rozwijanego; w przeciwnym razie zwracana wartość z CMFCToolBar::ProcessCommand.

Uwagi

Struktura wywołuje tę metodę, gdy jest naciskany razem z Alt .

`CMFCToolBar::UpdateButton`

Aktualizuje stan określonego przycisku.

void UpdateButton(int nIndex);

Parametry

nIndex
[in] Określa indeks zerowy przycisku do aktualizacji.

Uwagi

`CMFCToolBar::WrapToolBar`

Zmienia położenie przycisków paska narzędzi w obrębie podanych wymiarów.

int WrapToolBar(
    int nWidth,
    int nHeight = 32767,
    CDC* pDC = NULL,
    int nColumnWidth = -1,
    int nRowHeight = -1);

Parametry

nWidth
[in] Maksymalna szerokość paska narzędzi.

nHeight
[in] Maksymalna wysokość paska narzędzi. Nie jest używany, jeśli pasek narzędzi jest przestawny.

pDC
[in] Wskaźnik do kontekstu urządzenia. Jeśli NULLjest używany kontekst urządzenia dla paska narzędzi.

nColumnWidth
[in] Szerokość przycisku. Jeśli wartość -1, używana jest bieżąca szerokość.

[in] m nRowHeight Wysokość przycisku. Jeśli wartość -1, używana jest bieżąca wysokość.

Wartość zwracana

Liczba wierszy przycisków na pasku narzędzi.

Uwagi

Ta metoda zmienia położenie przycisków na pasku narzędzi, zawijając przyciski do dodatkowych wierszy w razie potrzeby.

`CMFCToolBar::m_bDontScaleImages`

Określa, czy obrazy paska narzędzi mają być skalowane w trybie wysokiej rozdzielczości DPI. Ustaw wartość , aby TRUE zapobiec skalowaniu obrazu, gdy rozmiar obrazu nie jest zgodny z rozmiarem przycisku.

AFX_IMPORT_DATA static BOOL m_bDontScaleImages;

Zobacz też

Wykres hierarchii
Klasy
CMFCMenuBar Klasa
CMFCPopupMenuBar Klasa
CMFCDropDownToolBar Klasa
Przewodnik: umieszczanie kontrolek na paskach narzędzi

Udostępnij za pośrednictwem

CMFCToolBar Klasa

Składnia

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Metody chronione

Składowe danych

Uwagi

Przykład

Wymagania

Hierarchia dziedziczenia

CMFCToolBar::AddBasicCommand

Parametry

Uwagi

CMFCToolBar::AddCommandUsage

Parametry

Uwagi

CMFCToolBar::AddToolBarForImageCollection

Parametry

Wartość zwracana

Uwagi

CMFCToolBar::AdjustLayout

Uwagi

CMFCToolBar::AdjustSize

Uwagi

CMFCToolBar::AllowChangeTextLabels

Wartość zwracana

Uwagi

CMFCToolBar::AllowShowOnList

Wartość zwracana

Uwagi

CMFCToolBar::AreTextLabels

Wartość zwracana

Uwagi

CMFCToolBar::AutoGrayInactiveImages

Parametry

Uwagi

CMFCToolBar::ButtonToIndex

Parametry

Wartość zwracana

CMFCToolBar::CalcFixedLayout

Parametry

Wartość zwracana

Uwagi

CMFCToolBar::CalcMaxButtonHeight

Wartość zwracana

Uwagi

CMFCToolBar::CalcSize

Parametry

Wartość zwracana

Uwagi

CMFCToolBar::CanBeClosed

Wartość zwracana

Uwagi

CMFCToolBar::CanBeRestored

Wartość zwracana

Uwagi

CMFCToolBar::CanFocus

Wartość zwracana

Uwagi

CMFCToolBar::CanHandleSiblings

Wartość zwracana

Uwagi

CMFCToolBar::CleanUpImages

Uwagi

CMFCToolBar::CleanUpLockedImages

Uwagi

CMFCToolBar::CommandToIndex

Parametry

Wartość zwracana

Uwagi

CMFCToolBar::Create

Parametry

Wartość zwracana

Uwagi

CMFCToolBar::CreateEx

Parametry

Wartość zwracana

Uwagi

`CMFCToolBar` Klasa

`CMFCToolBar::AddBasicCommand`

`CMFCToolBar::AddCommandUsage`

`CMFCToolBar::AddToolBarForImageCollection`

`CMFCToolBar::AdjustLayout`

`CMFCToolBar::AdjustSize`

`CMFCToolBar::AllowChangeTextLabels`

`CMFCToolBar::AllowShowOnList`

`CMFCToolBar::AreTextLabels`

`CMFCToolBar::AutoGrayInactiveImages`

`CMFCToolBar::ButtonToIndex`

`CMFCToolBar::CalcFixedLayout`

`CMFCToolBar::CalcMaxButtonHeight`

`CMFCToolBar::CalcSize`

`CMFCToolBar::CanBeClosed`

`CMFCToolBar::CanBeRestored`

`CMFCToolBar::CanFocus`

`CMFCToolBar::CanHandleSiblings`

`CMFCToolBar::CleanUpImages`

`CMFCToolBar::CleanUpLockedImages`

`CMFCToolBar::CommandToIndex`

`CMFCToolBar::Create`

`CMFCToolBar::CreateEx`

`CMFCToolBar::Deactivate`

`CMFCToolBar::DoPaint`

`CMFCToolBar::DrawButton`

`CMFCToolBar::DrawSeparator`

`CMFCToolBar::EnableCustomizeButton`

`CMFCToolBar::EnableDocking`

`CMFCToolBar::EnableLargeIcons`

`CMFCToolBar::EnableQuickCustomization`

`CMFCToolBar::EnableReflections`

`CMFCToolBar::EnableTextLabels`

`CMFCToolBar::FromHandlePermanent`

`CMFCToolBar::GetAllButtons`

`CMFCToolBar::GetAllToolbars`

`CMFCToolBar::GetBasicCommands`

`CMFCToolBar::GetButton`

`CMFCToolBar::GetButtonInfo`

`CMFCToolBar::GetButtonSize`

`CMFCToolBar::GetButtonStyle`

`CMFCToolBar::GetButtonText`

`CMFCToolBar::GetColdImages`

`CMFCToolBar::GetColumnWidth`

`CMFCToolBar::GetCommandButtons`

`CMFCToolBar::GetCount`