Udostępnij za pośrednictwem


CMFCToolBar Klasa

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:

  1. CMFCToolBar Dodaj obiekt do głównego okna ramki.

  2. 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.

  3. 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

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

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;

Parametry

nIndex
[in] Indeks przycisku paska narzędzi.

rString
[out] Tekst etykiety przycisku paska narzędzi.

Wartość zwracana

Tekst etykiety przycisku paska narzędzi.

Uwagi

Wywołaj CMFCToolBar::SetButtonText lub CMFCToolBar::SetToolBarBtnText ustaw etykietę tekstową.

CMFCToolBar::GetColdImages

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

static CMFCToolBarImages* GetColdImages();

Wartość zwracana

Wskaźnik do kolekcji zimnych obrazów przycisków paska narzędzi.

Uwagi

Zimne obrazy to obrazy, które są używane, gdy użytkownik nie wchodzi w interakcję z przyciskami paska narzędzi. Wywołaj CMFCToolBar::LoadBitmapEx lub CMFCToolBar::LoadBitmap załaduj zimne obrazy.

CMFCToolBar::GetColumnWidth

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

virtual int GetColumnWidth() const;

Wartość zwracana

Wartość określająca szerokość przycisków paska narzędzi.

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ą szerokość kolumny dla paska narzędzi.

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

uiID
[in] Określa identyfikator polecenia przycisku.

Wartość zwracana

Indeks obrazu paska narzędzi na udostępnionej liście obrazów.

Uwagi

Użyj tej metody udostępnionej, aby pobrać indeks domyślnego obrazu dla przycisku paska narzędzi z określonym identyfikatorem polecenia. Wartość zwracana jest indeksem w udostępnionej kolekcji obrazów przycisków paska narzędzi dla wszystkich pasków narzędzi w aplikacji. Wywołaj metodę CMFCToolBar::GetImages , aby uzyskać wskaźnik do tej kolekcji.

CMFCToolBar::GetDisabledImages

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

static CMFCToolBarImages* __stdcall GetDisabledImages();

Wartość zwracana

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

Uwagi

Załaduj obrazy wyłączonych przycisków paska narzędzi przy użyciu CMFCToolBarEditBoxButton klasy i CMFCToolBar::LoadBitmap metod.

CMFCToolBar::GetDisabledMenuImages

Zwraca wskaźnik do kolekcji obrazów używanych dla wyłączonych przycisków menu w aplikacji.

static CMFCToolBarImages* __stdcall GetDisabledMenuImages();

Wartość zwracana

Wskaźnik do kolekcji wyłączonych obrazów menu.

Uwagi

Załaduj wyłączone obrazy przy użyciu CMFCToolBarEditBoxButton metody Class .

CMFCToolBar::GetDroppedDownMenu

Pobiera wskaźnik do obiektu przycisku menu, który jest obecnie wyświetlany w menu podrzędnym.

CMFCToolBarMenuButton* GetDroppedDownMenu(int* pIndex = NULL) const;

Parametry

pIndex
[out] Odbiera indeks przycisku w kolekcji przycisków paska narzędzi.

Wartość zwracana

Wskaźnik do obiektu przycisku menu, który wyświetla jego pod menu lub NULL jeśli żadne menu nie wyświetla jego podmenu.

Uwagi

Jeśli ta metoda zwraca wartość inną niż null i pIndex nie NULLma wartości , wartość wskazywana przez pIndex element jest ustawiona na indeks przycisku menu w kolekcji przycisków paska narzędzi.

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.

BOOL GetGrayDisabledButtons() const;

Wartość zwracana

TRUE aby przyciemnić obrazy wyłączonych przycisków; FALSE w celu uzyskania obrazów z kolekcji wyłączonych obrazów.

Uwagi

Służy CMFCToolBar::SetGrayDisabledButtons do przełączania się między wygaszone obrazy a obrazami z kolekcji wyłączonych obrazów.

CMFCToolBar::GetHighlightedButton

Zwraca wskaźnik do przycisku paska narzędzi, który jest obecnie wyróżniony.

CMFCToolBarButton* GetHighlightedButton() const;

Wartość zwracana

Wskaźnik do obiektu przycisku paska narzędzi; lub NULL jeśli przycisk nie jest wyróżniony.

Uwagi

Przycisk paska narzędzi jest wyróżniony, jeśli ma fokus klawiatury. Przycisk paska narzędzi jest również wyróżniony, jeśli przyciski paska narzędzi są śledzone w tej aplikacji (aby uzyskać więcej informacji, zobacz CMFCToolBar::GetHotBorder i CMFCToolBar::SetHotBorder), a mysz wskazuje na nie, gdy przycisk paska narzędzi lub element menu nie ma fokusu klawiatury.

CMFCToolBar::GetHotBorder

Określa, czy przyciski paska narzędzi są śledzone na gorąco. Jeśli przycisk jest śledzony na gorąco, jest wyróżniony, gdy mysz porusza się po nim.

BOOL GetHotBorder() const;

Wartość zwracana

TRUE jeśli przyciski paska narzędzi są śledzone na gorąco; w przeciwnym razie, FALSE.

Uwagi

Domyślnie przyciski paska narzędzi są śledzone na gorąco.

CMFCToolBar::GetHotTextColor

Zwraca kolor tekstu wyróżnionych przycisków paska narzędzi.

static COLORREF GetHotTextColor();

Wartość zwracana

COLORREF Wartość reprezentująca bieżący wyróżniony kolor tekstu.

Uwagi

Wywołaj metodę CMFCToolBar::SetHotTextColor , aby ustawić nowy kolor tekstu dla wyróżnionych przycisków paska narzędzi.

CMFCToolBar::GetHwndLastFocus

Zwraca uchwyt do okna z fokusem wejściowym tuż przed wykonaniem paska narzędzi.

HWND GetHwndLastFocus() const;

Wartość zwracana

Uchwyt do okna, który nie pochodzi z CMFCBaseToolBar klasy, który wcześniej miał fokus wejściowy; lub NULL jeśli nie ma takiego okna.

Uwagi

Gdy kontrolka CMFCToolBar odbiera fokus danych wejściowych, przechowuje uchwyt do okna, które straciło fokus, aby można było przywrócić go później.

CMFCToolBar::GetIgnoreSetText

Określa, czy wywołania ustawiania etykiet przycisków są ignorowane.

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.

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 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.

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.

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.

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 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