Udostępnij za pośrednictwem


Klasa CMFCToolBarButton

Udostępnia funkcje przycisków do pasków narzędzi.

Składnia

class CMFCToolBarButton : public CObject

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko opis
CMFCToolBarButton::CMFCToolBarButton Tworzy i inicjuje CMFCToolBarButton obiekt.
CMFCToolBarButton::~CMFCToolBarButton Destruktor.

Metody publiczne

Nazwa/nazwisko opis
CMFCToolBarButton::CanBeDropped Określa, czy użytkownik może umieścić przycisk na pasku narzędzi lub menu podczas dostosowywania.
CMFCToolBarButton::CanBeStored Określa, czy przycisk może być przechowywany.
CMFCToolBarButton::CanBeStretched Określa, czy użytkownik może rozciągnąć przycisk podczas dostosowywania.
CMFCToolBarButton::CompareWith Porównuje to wystąpienie z podanym CMFCToolBarButton obiektem.
CMFCToolBarButton::CopyFrom Kopiuje właściwości innego przycisku paska narzędzi do bieżącego przycisku.
CMFCToolBarButton::CreateFromOleData Tworzy CMFCToolBarButton obiekt z podanego COleDataObject obiektu.
CMFCToolBarButton::CreateObject Używana przez platformę do tworzenia wystąpienia dynamicznego tego typu klasy.
CMFCToolBarButton::EnableWindow Włącza lub wyłącza wprowadzanie myszy i klawiatury.
CMFCToolBarButton::ExportToMenuButton Kopiuje tekst z przycisku paska narzędzi do menu.
CMFCToolBarButton::GetClipboardFormat Pobiera globalny format schowka dla aplikacji.
CMFCToolBarButton::GetHwnd Pobiera uchwyt okna skojarzony z przyciskiem paska narzędzi.
CMFCToolBarButton::GetImage Pobiera indeks obrazu przycisku.
CMFCToolBarButton::GetInvalidateRect Pobiera region obszaru klienta przycisku, który musi być ponownie rysowane.
CMFCToolBarButton::GetParentWnd Pobiera okno nadrzędne przycisku.
CMFCToolBarButton::GetProtectedCommands Pobiera listę poleceń, których użytkownik nie może dostosować.
CMFCToolBarButton::GetTextSize Pobiera rozmiar tekstu przycisku.
CMFCToolBarButton::HasFocus Określa, czy przycisk ma bieżący fokus danych wejściowych.
CMFCToolBarButton::HaveHotBorder Określa, czy obramowanie przycisku jest wyświetlane, gdy użytkownik wybierze przycisk.
CMFCToolBarButton::IsDrawImage Określa, czy na przycisku jest wyświetlany obraz.
CMFCToolBarButton::IsDrawText Określa, czy etykieta tekstowa jest wyświetlana na przycisku.
CMFCToolBarButton::IsDroppedDown Określa, czy przycisk wyświetla podmenu.
CMFCToolBarButton::IsEditable Określa, czy przycisk można dostosować.
CMFCToolBarButton::IsExtraSize Określa, czy przycisk może być wyświetlany z obramowaniem rozszerzonym.
CMFCToolBarButton::IsFirstInGroup Określa, czy przycisk znajduje się w pierwszej pozycji w grupie przycisków.
CMFCToolBarButton::IsHidden Określa, czy przycisk jest ukryty.
CMFCToolBarButton::IsHorizontal Określa, czy przycisk znajduje się na poziomym pasku narzędzi.
CMFCToolBarButton::IsLastInGroup Określa, czy przycisk znajduje się w ostatniej pozycji w grupie przycisków.
CMFCToolBarButton::IsLocked Określa, czy przycisk znajduje się na zablokowanym (niemożliwym do dostosowania) pasku narzędzi.
CMFCToolBarButton::IsOwnerOf Określa, czy przycisk jest właścicielem dostarczonego uchwytu okna.
CMFCToolBarButton::IsVisible Określa, czy przycisk paska narzędzi jest widoczny.
CMFCToolBarButton::IsWindowVisible Określa, czy podstawowy uchwyt okna przycisku jest widoczny.
CMFCToolBarButton::NotifyCommand Określa, czy przycisk przetwarza komunikat WM_COMMAND .
CMFCToolBarButton::OnAddToCustomizePage Wywoływana przez platformę po dodaniu przycisku do okna dialogowego Dostosowywanie .
CMFCToolBarButton::OnBeforeDrag Określa, czy przycisk można przeciągnąć.
CMFCToolBarButton::OnBeforeDrop Określa, czy użytkownik może usunąć przycisk na docelowym pasku narzędzi.
CMFCToolBarButton::OnCalculateSize Wywoływana przez platformę w celu obliczenia rozmiaru przycisku dla określonego kontekstu urządzenia i stanu dokowania.
CMFCToolBarButton::OnCancelMode Wywoływana przez platformę do obsługi komunikatu WM_CANCELMODE .
CMFCToolBarButton::OnChangeParentWnd Wywoływana przez strukturę po wstawieniu przycisku do nowego paska narzędzi.
CMFCToolBarButton::OnClick Wywoływana przez platformę, gdy użytkownik kliknie przycisk myszy.
CMFCToolBarButton::OnClickUp Wywoływana przez platformę, gdy użytkownik zwalnia przycisk myszy.
CMFCToolBarButton::OnContextHelp Wywoływana przez platformę, gdy nadrzędny pasek narzędzi obsługuje komunikat WM_HELPHITTEST.
CMFCToolBarButton::OnCtlColor Wywoływana przez platformę, gdy nadrzędny pasek narzędzi obsługuje komunikat WM_CTLCOLOR.
CMFCToolBarButton::OnCustomizeMenu Umożliwia przyciskowi modyfikowanie podanego menu, gdy aplikacja wyświetla menu skrótów na nadrzędnym pasku narzędzi.
CMFCToolBarButton::OnDblClk Wywoływana przez platformę, gdy nadrzędny pasek narzędzi obsługuje komunikat WM_LBUTTONDBLCLK .
CMFCToolBarButton::OnDraw Wywoływana przez strukturę w celu narysowania przycisku przy użyciu określonych stylów i opcji.
CMFCToolBarButton::OnDrawOnCustomizeList Wywoływana przez strukturę, aby narysować przycisk w okienku Polecenia okna dialogowego Dostosowywanie .
CMFCToolBarButton::OnGetCustomToolTipText Wywoływana przez strukturę w celu pobrania niestandardowego tekstu etykietki narzędzia dla przycisku.
CMFCToolBarButton::OnGlobalFontsChanged Wywoływana przez platformę, gdy czcionka globalna uległa zmianie.
CMFCToolBarButton::OnMove Wywoływana przez platformę po przesunięciu nadrzędnego paska narzędzi.
CMFCToolBarButton::OnShow Wywoływana przez platformę, gdy przycisk staje się widoczny lub niewidoczny.
CMFCToolBarButton::OnSize Wywoływana przez platformę, gdy nadrzędny pasek narzędzi zmienia rozmiar lub położenie, a ta zmiana wymaga, aby przycisk zmienił rozmiar.
CMFCToolBarButton::OnToolHitTest Wywoływana przez platformę, gdy nadrzędny pasek narzędzi musi określić, czy punkt znajduje się w prostokątze ograniczenia przycisku.
CMFCToolBarButton::OnUpdateToolTip Wywoływana przez strukturę, gdy nadrzędny pasek narzędzi aktualizuje jego tekst etykietki narzędzia.
CMFCToolBarButton::P repareDrag Wywoływana przez platformę, gdy przycisk ma wykonać operację przeciągania i upuszczania.
CMFCToolBarButton::Rect Pobiera prostokąt ograniczenia przycisku.
CMFCToolBarButton::ResetImageToDefault Ustawia wartość domyślną obrazu skojarzonego z przyciskiem .
CMFCToolBarButton::SaveBarState Zapisuje stan przycisku paska narzędzi.
CMFCToolBarButton::Serialize Odczytuje ten obiekt z archiwum lub zapisuje go w archiwum. (Przesłonięcia) CObject::Serialize.)
CMFCToolBarButton::SetACCData Wypełnia podany CAccessibilityData obiekt danymi ułatwień dostępu za pomocą przycisku paska narzędzi.
CMFCToolBarButton::SetClipboardFormatName Zmienia nazwę globalnego formatu schowka.
CMFCToolBarButton::SetImage Ustawia indeks obrazu przycisku.
CMFCToolBarButton::SetProtectedCommands Ustawia listę poleceń, których użytkownik nie może dostosować.
CMFCToolBarButton::SetRadio Wywoływana przez platformę, gdy przycisk zmienia jego stan sprawdzania.
CMFCToolBarButton::SetRect Ustawia prostokąt ograniczenia przycisku.
CMFCToolBarButton::SetStyle Ustawia styl przycisku.
CMFCToolBarButton::SetVisible Określa, czy przycisk jest widoczny.
CMFCToolBarButton::Show Wyświetla lub ukrywa przycisk.

Składowe danych

Nazwa/nazwisko opis
CMFCToolBarButton::m_bImage Określa, czy na przycisku jest wyświetlany obraz.
CMFCToolBarButton::m_bText Określa, czy etykieta tekstowa jest wyświetlana na przycisku.
CMFCToolBarButton::m_bTextBelow Określa, czy etykieta tekstowa jest wyświetlana pod obrazem na przycisku.
CMFCToolBarButton::m_bUserButton Określa, czy przycisk ma obraz zdefiniowany przez użytkownika.
CMFCToolBarButton::m_bWholeText Określa, czy przycisk wyświetla pełną etykietę tekstową, nawet jeśli nie pasuje do prostokąta ograniczenia.
CMFCToolBarButton::m_bWrap Określa, czy przycisk obok separatora zostanie umieszczony w następnym wierszu.
CMFCToolBarButton::m_bWrapText Określa, czy są włączone etykiety tekstowe wielowierszowe.
CMFCToolBarButton::m_nID Identyfikator polecenia przycisku.
CMFCToolBarButton::m_nStyle Styl przycisku.
CMFCToolBarButton::m_strText Etykieta tekstowa przycisku.

Uwagi

CMFCToolbarButton Obiekt to kontrolka, która znajduje się na pasku narzędzi. Jego zachowanie przypomina zwykły przycisk. Do tego obiektu można przypisać obraz i etykietę tekstową. Przycisk paska narzędzi może również mieć identyfikator polecenia. Gdy użytkownik kliknie przycisk paska narzędzi, platforma wykonuje polecenie określone przez ten identyfikator.

Zazwyczaj przyciski paska narzędzi można dostosować: użytkownik może przeciągać przyciski z jednego paska narzędzi do innego, a następnie kopiować, wklejać, usuwać i edytować etykiety tekstowe i obrazy. Aby uniemożliwić użytkownikowi dostosowywanie paska narzędzi, możesz zablokować pasek narzędzi na jeden z dwóch sposobów. Po wywołaniu bLocked CMFCToolBar::LoadToolBar lub dodaj identyfikator polecenia pojedynczego przycisku do globalnej listy chronionych poleceń przy użyciu metody CMFCToolBarButton::SetProtectedCommands.

CMFCToolBarButton obiekty wyświetlają obrazy z globalnych kolekcji obrazów paska narzędzi w aplikacji. Te kolekcje są obsługiwane przez nadrzędny pasek narzędzi CMFCToolBar Class. Aby uzyskać więcej informacji, zobacz KLASA CMFCToolBarImages.

Gdy użytkownik kliknie przycisk paska narzędzi, jego nadrzędny pasek narzędzi przetwarza komunikat myszy i przekazuje odpowiednie akcje do przycisku. Jeśli przycisk ma prawidłowy identyfikator polecenia, nadrzędny pasek narzędzi wysyła komunikat WM_COMMAND do ramki nadrzędnej.

Klasa CMFCToolBarButton jest klasą bazową dla innych klas przycisków paska narzędzi, takich jak klasa CMFCToolBarMenuButton, klasa CMFCToolBarEditBoxButton i klasa CMFCToolBarComboBoxButton.

Przykład

W poniższym przykładzie pokazano, jak skonfigurować CMFCToolBarButton obiekt przy użyciu różnych metod w CMFCToolBarButton klasie. W przykładzie pokazano, jak włączyć wprowadzanie myszy i klawiatury, ustawić indeks obrazu przycisku, ustawić prostokąt ograniczenia przycisku i ustawić przycisk widoczny. Ten fragment kodu jest częścią przykładu Kontrolka karty.

CMFCToolBarButton *pOffice2007 = NULL;
int nIndex = -1;

for (UINT uiCmd = ID_VIEW_APPLOOK_2007_1; uiCmd <= ID_VIEW_APPLOOK_2007_4; uiCmd++)
{
   // CMFCToolBar m_wndToolBarTheme
   nIndex = m_wndToolBarTheme.CommandToIndex(uiCmd);

   CMFCToolBarButton *pButton = m_wndToolBarTheme.GetButton(nIndex);

   if (pButton != NULL)
   {
      pOffice2007 = pButton;
      break;
   }
}
pOffice2007->EnableWindow();
pOffice2007->SetImage(1);
pOffice2007->SetRect(CRect(1, 1, 1, 1));
pOffice2007->SetVisible();
pOffice2007->Show(true);

Hierarchia dziedziczenia

Obiekt CObject

CMFCToolBarButton

Wymagania

Nagłówek: afxtoolbarbutton.h

CMFCToolBarButton::CanBeDropped

Określa, czy użytkownik może umieścić przycisk na pasku narzędzi lub menu podczas dostosowywania.

virtual BOOL CanBeDropped(CMFCToolBar* pToolbar);

Parametry

pToolbar
[in] Nieużywane.

Wartość zwracana

Ta metoda zwraca wartość TRUE.

Uwagi

Domyślnie przycisk paska narzędzi można porzucić na każdym dostosowywalnym pasku narzędzi (czyli bez blokady).

Domyślna implementacja tej metody zwraca wartość TRUE. Zastąpi tę metodę i zwróć wartość FALSE, jeśli chcesz uniemożliwić użytkownikowi zmiana położenia przycisku.

CMFCToolBarButton::CanBeStored

Określa, czy przycisk może być przechowywany.

virtual BOOL CanBeStored() const;

Wartość zwracana

Ta metoda zwraca wartość TRUE.

Uwagi

Struktura używa tej metody, aby określić, czy przycisk może uczestniczyć w operacji przeciągania i upuszczania.

Domyślna implementacja zwraca wartość TRUE. Zastąpi tę metodę, jeśli przycisk nie może być przechowywany w ramach operacji przeciągania i upuszczania. Aby uzyskać więcej informacji na temat operacji przeciągania i upuszczania, zobacz Przeciąganie i upuszczanie OLE.

CMFCToolBarButton::CanBeStretched

Określa, czy użytkownik może rozciągnąć przycisk podczas dostosowywania.

virtual BOOL CanBeStretched() const;

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Ta metoda jest używana przez platformę do określenia, czy przycisk można rozciągnąć w trybie dostosowywania.

Domyślna implementacja tej metody zwraca wartość FALSE. Zastąpi tę metodę, aby zwrócić wartość TRUE dla kontrolki o zmiennej szerokości, takiej jak pole kombi lub suwak.

Aby uzyskać więcej informacji na temat trybu dostosowywania, zobacz CMFCToolBar::SetCustomizeMode.

CMFCToolBarButton::CMFCToolBarButton

Tworzy i inicjuje CMFCToolBarButton obiekt.

CMFCToolBarButton(
    UINT uiID,
    int iImage,
    LPCTSTR lpszText=NULL,
    BOOL bUserButton=FALSE,
    BOOL bLocked=FALSE);

Parametry

identyfikator uiID
[in] Identyfikator polecenia przycisku.

iImage
[in] Indeks obrazu przycisku w kolekcji obrazów.

lpszText
[in] Etykieta tekstowa przycisku. Może mieć wartość NULL.

bUserButton
[in] Wartość logiczna określająca, czy przycisk jest zdefiniowany przez użytkownika. Jeśli ten parametr ma wartość TRUE, przycisk jest zdefiniowany przez użytkownika. W przeciwnym razie obraz przycisku jest ładowany z zasobu.

Zablokowany
[in] Wartość logiczna określająca, czy można dostosować przycisk. Jeśli ten parametr ma wartość TRUE, nie można dostosować przycisku. W przeciwnym razie można dostosować przycisk.

CMFCToolBarButton::CompareWith

Porównuje to wystąpienie z podanym CMFCToolBarButton obiektem.

virtual BOOL CompareWith(const CMFCToolBarButton& other) const;

Parametry

inny
[in] Odwołanie do obiektu do porównania z tym wystąpieniem.

Wartość zwracana

Nonzero, jeśli podany obiekt jest równy wartości tego wystąpienia; w przeciwnym razie, 0.

Uwagi

Domyślna implementacja określa, czy identyfikator polecenia podanego obiektu jest równy identyfikatorowi polecenia tego wystąpienia. Zastąpi tę metodę, jeśli musisz wykonać dodatkowe przetwarzanie, aby określić, czy dwa CMFCToolBarButton obiekty są równe.

CMFCToolBarButton::CopyFrom

Kopiuje właściwości innego przycisku paska narzędzi do bieżącego przycisku.

virtual void CopyFrom(const CMFCToolBarButton& src);

Parametry

Src
[in] Odwołanie do przycisku źródłowego, z którego chcesz skopiować.

Uwagi

Wywołaj tę metodę, aby skopiować inny przycisk paska narzędzi do tego przycisku paska narzędzi.

CMFCToolBarButton::CreateFromOleData

Tworzy CMFCToolBarButton obiekt z podanego COleDataObject obiektu.

static CMFCToolBarButton* __stdcall CreateFromOleData(COleDataObject* pDataObject);

Parametry

pDataObject
[in] Źródłowy obiekt danych OLE.

Wartość zwracana

Utworzony obiekt CMFCToolBarButton.

Uwagi

Ta metoda jest używana przez platformę do przeprowadzania transferu danych w różnych formatach. Na przykład CMFCOutlookBarPane::OnDragOver metoda używa tej metody do wykonywania operacji przeciągania i upuszczania.

CMFCToolBarButton::EnableWindow

Włącza lub wyłącza wprowadzanie myszy i klawiatury.

virtual void EnableWindow(BOOL bEnable = TRUE);

Parametry

bEnable
[in] Ustaw ten parametr na wartość TRUE, aby włączyć wprowadzanie danych wejściowych lub wartość FALSE, aby wyłączyć dane wejściowe.

Uwagi

Ta metoda wywołuje funkcję w celu włączenia EnableWindow lub wyłączenia danych wejściowych. Aby uzyskać więcej informacji, zobacz EnableWindow in the Windows SDK (Włączanie systemu Windows w zestawie SDK systemu Windows).

CMFCToolBarButton::ExportToMenuButton

Kopiuje tekst z przycisku paska narzędzi do menu.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

Parametry

menuButton
[in] Odwołanie do przycisku menu docelowego.

Wartość zwracana

Ta metoda zwraca wartość TRUE.

Uwagi

Struktura wywołuje tę metodę, aby skopiować tekst z przycisku paska narzędzi do przycisku menu. Domyślna implementacja kopiuje etykietę tekstową przycisku. Jeśli etykieta tekstowa jest pusta, ta metoda kopiuje tekst etykietki narzędzia przycisku.

Domyślna implementacja tej metody zwraca wartość TRUE. Zastąp tę metodę, jeśli chcesz wykonać dodatkowe akcje, gdy struktura konwertuje obiekt pochodzący z CMFCToolbarButton na przycisk menu.

CMFCToolBarButton::GetClipboardFormat

Pobiera globalny format schowka dla aplikacji.

static CLIPFORMAT __stdcall GetClipboardFormat();

Wartość zwracana

Globalna wartość CLIPFORMAT dla aplikacji.

Uwagi

Struktura wywołuje tę metodę w celu pobrania formatu schowka dla operacji transferu danych OLE. Na przykład metoda CMFCToolBarButton::CreateFromOleData używa tej metody do kopiowania danych ze źródłowego obiektu danych OLE.

Ta metoda ustawia globalną wartość CLIPFORMAT przy pierwszym wywołaniu tej metody. Wszystkie kolejne wywołania tej metody zwracają tę wartość.

Aby umożliwić wykonywanie operacji przeciągania i upuszczania między aplikacjami, wywołaj metodę CMFCToolBarButton::SetClipboardFormatName .

Aby uzyskać więcej informacji na temat schowków w MFC, zobacz Schowek.

CMFCToolBarButton::GetHwnd

Pobiera uchwyt okna skojarzony z przyciskiem paska narzędzi.

virtual HWND GetHwnd();

Wartość zwracana

Uchwyt okna skojarzony z przyciskiem paska narzędzi lub wartością NULL, jeśli przycisk paska narzędzi nie ma skojarzonego uchwytu okna.

Uwagi

Domyślna implementacja tej metody zwraca wartość NULL. Zastąpi tę metodę, aby zwrócić uchwyt okna określonej kontrolki.

CMFCToolBarButton::GetImage

Pobiera indeks obrazu przycisku.

int GetImage() const;

Wartość zwracana

Indeks obrazu skojarzonego z tym przyciskiem.

Uwagi

Jeśli przycisk ma obraz zdefiniowany przez użytkownika (czyli jeśli bUserButton miał wartość TRUE w konstruktorze), zwracany indeks określa obraz w kolekcji obrazów zdefiniowanych przez użytkownika (zobacz CMFCToolBar::GetUserImages). W przeciwnym razie indeks określa obraz w kolekcji obrazów ładowanych z pliku zasobu (zobacz CMFCToolBar::GetImages). Aby uzyskać więcej informacji na temat plików zasobów, zobacz Praca z plikami zasobów.

CMFCToolBarButton::GetInvalidateRect

Pobiera region obszaru klienta przycisku, który musi być ponownie rysowane.

virtual const CRect GetInvalidateRect() const;

Wartość zwracana

CRect Obiekt określający region, który musi zostać ponownie narysowane.

Uwagi

Domyślna implementacja tej metody zwraca cały obszar klienta. Zastąpij tę metodę, jeśli chcesz, aby inny obszar był ponownie rysowane.

CMFCToolBarButton::GetParentWnd

Pobiera okno nadrzędne przycisku.

CWnd* GetParentWnd() const;

Wartość zwracana

Okno nadrzędne przycisku.

CMFCToolBarButton::GetProtectedCommands

Pobiera listę poleceń, których użytkownik nie może dostosować.

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

Wartość zwracana

Lista chronionych poleceń.

Uwagi

W trybie dostosowywania platforma wyłącza polecenia przycisku paska narzędzi, które są chronione. Użytkownik nie może wykonywać operacji przeciągania i upuszczania oraz edytowania na wyłączonych przyciskach paska narzędzi.

Użyj metody CMFCToolBarButton::SetProtectedCommands, aby zdefiniować listę chronionych poleceń.

CMFCToolBarButton::GetTextSize

Pobiera rozmiar tekstu przycisku.

SIZE GetTextSize() const;

Wartość zwracana

Obiekt SIZE zawierający rozmiar w pikselach tekstu przycisku.

CMFCToolBarButton::HasFocus

Określa, czy przycisk ma bieżący fokus danych wejściowych.

virtual BOOL HasFocus() const;

Wartość zwracana

Nonzero, jeśli przycisk ma fokus wejściowy; w przeciwnym razie 0.

Uwagi

Domyślna implementacja tej metody zwraca wartość niezerową, jeśli przycisk ma fokus wejściowy lub jest elementem podrzędnym lub oknem potomnym okna z fokusem wejściowym. Tę funkcję można zastąpić, aby dostosować to zachowanie.

CMFCToolBarButton::HaveHotBorder

Określa, czy obramowanie przycisku jest wyświetlane, gdy użytkownik wybierze przycisk.

virtual BOOL HaveHotBorder() const;

Wartość zwracana

Ta metoda zwraca wartość TRUE.

Uwagi

Struktura wywołuje tę metodę, aby określić, czy przycisk paska narzędzi powinien wyświetlać obramowanie po wybraniu go przez użytkownika.

Domyślna implementacja zwraca wartość TRUE. Tę metodę można zastąpić, aby dostosować to zachowanie.

CMFCToolBarButton::IsDrawImage

Określa, czy na przycisku jest wyświetlany obraz.

BOOL IsDrawImage() const;

Wartość zwracana

Nonzero, jeśli obraz jest wyświetlany na przycisku; w przeciwnym razie 0.

Uwagi

Ta metoda zwraca wartość FALSE, jeśli przycisk paska narzędzi nie ma skojarzonego obrazu ( CMFCToolBarButton::GetImage zwraca wartość -1) lub jeśli właściwość CMFCToolBarButton::m_bImage ma wartość FALSE.

CMFCToolBarButton::IsDrawText

Określa, czy etykieta tekstowa jest wyświetlana na przycisku.

BOOL IsDrawText() const;

Wartość zwracana

Nonzero, jeśli jest wyświetlana etykieta tekstowa; w przeciwnym razie 0.

Uwagi

Ta metoda zwraca wartość FALSE, jeśli przycisk paska narzędzi nie ma skojarzonej etykiety tekstowej ( CMFCToolBarButton::m_strText jest pusty) lub właściwość CMFCToolBarButton::m_bText jest ustawiona na WARTOŚĆ FALSE.

CMFCToolBarButton::IsDroppedDown

Określa, czy przycisk wyświetla podmenu.

virtual BOOL IsDroppedDown() const;

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Domyślna implementacja tej metody zwraca wartość FALSE. Zastąpuj tę metodę, aby zwrócić wartość TRUE, jeśli kontrolka wyświetla podmenu.

CMFCToolBarButton::IsEditable

Określa, czy przycisk można dostosować.

virtual BOOL IsEditable() const;

Wartość zwracana

Niezerowe, jeśli przycisk można dostosować przez użytkownika; w przeciwnym razie 0.

Uwagi

Struktura wywołuje tę metodę, aby określić, czy użytkownik może dostosować przycisk paska narzędzi przy użyciu operacji przeciągania i upuszczania, czy edycji.

Domyślna implementacja zwraca wartość FALSE, jeśli identyfikator polecenia przycisku jest standardowym poleceniem (można to określić przez wywołanie IsStandardCommand funkcji) lub jeśli identyfikator polecenia znajduje się na liście chronionych poleceń. Aby uzyskać więcej informacji na temat chronionych poleceń, zobacz CMFCToolBarButton::GetProtectedCommands i CMFCToolBarButton::SetProtectedCommands.

Zastąpij tę metodę, aby dostosować jej zachowanie.

CMFCToolBarButton::IsExtraSize

Określa, czy przycisk może być wyświetlany z obramowaniem rozszerzonym.

virtual BOOL IsExtraSize() const;

Wartość zwracana

Niezerowe, jeśli przycisk paska narzędzi może być wyświetlany z obramowaniem rozszerzonym; w przeciwnym razie 0.

Uwagi

Kilka skórek używa dodatkowego rozmiaru dla obramowań przycisków paska narzędzi (na przykład przycisków okrągłych).

Jeśli użytkownik przenosi ten przycisk z jednego paska narzędzi do innego, struktura wywołuje metodę CMFCToolBarButton::OnChangeParentWnd . Metoda CMFCToolBarButton::OnChangeParentWnd ustawia flagę dodatkowego rozmiaru na nowy nadrzędny pasek narzędzi (aby uzyskać więcej informacji, zobacz CMFCToolBar::IsButtonExtraSizeAvailable).

CMFCToolBarButton::IsFirstInGroup

Określa, czy przycisk znajduje się w pierwszej pozycji w grupie przycisków.

virtual BOOL IsFirstInGroup() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk jest pierwszym przyciskiem w grupie przycisków; w przeciwnym razie FAŁSZ.

Uwagi

Ta metoda definiuje grupę przycisków jako sąsiedni zestaw przycisków, które są umieszczone w tym samym wierszu i są ograniczone przez separatory lub obramowanie paska narzędzi. Ta metoda zwraca wartość FALSE, jeśli przycisk paska narzędzi odwołuje się do przycisku Dostosuj . Aby uzyskać więcej informacji na temat przycisku Dostosuj , zobacz CMFCToolBar::GetCustomizeButton.

Wywołaj metodę CMFCToolBarButton::IsLastInGroup , aby określić, czy przycisk znajduje się w ostatniej pozycji w grupie przycisków.

CMFCToolBarButton::IsHidden

Określa, czy przycisk jest ukryty.

BOOL IsHidden() const;

Wartość zwracana

Nonzero, jeśli przycisk jest ukryty (niewidoczny); w przeciwnym razie 0.

Uwagi

Struktura wywołuje tę metodę, gdy nadrzędny pasek narzędzi jest rozciągnięty, aby określić, czy przycisk paska narzędzi jest widoczny.

Jeśli ustawisz przycisk jako niewidoczny przy użyciu metody CMFCToolBarButton::SetVisible , użyj polecenia CMFCToolBarButton::IsVisible , aby określić, czy przycisk paska narzędzi jest widoczny.

Domyślnie wszystkie przyciski paska narzędzi są widoczne. Użyj metody CMFCToolBarButton::Show, aby ukryć lub pokazać przyciski paska narzędzi.

CMFCToolBarButton::IsHorizontal

Określa, czy przycisk znajduje się na poziomym pasku narzędzi.

BOOL IsHorizontal() const;

Wartość zwracana

Niezerowe, jeśli przycisk paska narzędzi znajduje się na poziomym pasku narzędzi; w przeciwnym razie 0.

Uwagi

Struktura wywołuje tę metodę w celu określenia układu przycisków paska narzędzi.

Ta metoda zwraca element członkowski m_bHorz danych. Wartość m_bHorz domyślna elementu członkowskiego danych to TRUE. Jest ona resetowana przy każdym wywołaniu metody CMFCToolBarButton::OnDraw .

CMFCToolBarButton::IsLastInGroup

Określa, czy przycisk znajduje się w ostatniej pozycji w grupie przycisków.

virtual BOOL IsLastInGroup() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk jest ostatnim przyciskiem w grupie przycisków; w przeciwnym razie FAŁSZ.

Uwagi

Ta metoda definiuje grupę przycisków jako sąsiedni zestaw przycisków, które są umieszczone w tym samym wierszu i są ograniczone przez separatory lub obramowanie paska narzędzi Ta metoda zwraca wartość FALSE, jeśli przycisk paska narzędzi nie ma nadrzędnego paska narzędzi lub przycisk paska narzędzi odwołuje się do przycisku Dostosuj. Aby uzyskać więcej informacji na temat przycisku Dostosuj , zobacz CMFCToolBar::GetCustomizeButton.

Wywołaj metodę CMFCToolBarButton::IsFirstInGroup , aby określić, czy przycisk znajduje się w pierwszej pozycji w grupie przycisków.

CMFCToolBarButton::IsLocked

Określa, czy przycisk znajduje się na zablokowanym (niemożliwym do dostosowania) pasku narzędzi.

BOOL IsLocked() const;

Wartość zwracana

Nonzero, jeśli przycisk znajduje się na zablokowanym pasku narzędzi; w przeciwnym razie 0.

Uwagi

Struktura wywołuje tę metodę, aby określić, czy użytkownik może dostosować przycisk paska narzędzi przy użyciu operacji przeciągania i upuszczania, czy edycji. Ustaw zablokowany atrybut na nadrzędnym pasku narzędzi przy użyciu metody CMFCToolBar::LoadToolBar . Struktura przekazuje wartość tego atrybutu do konstruktora każdego przycisku paska narzędzi ( CMFCToolbarButton), który wstawia do nadrzędnego paska narzędzi.

CMFCToolBarButton::IsOwnerOf

Określa, czy przycisk jest właścicielem dostarczonego uchwytu okna.

virtual BOOL IsOwnerOf(HWND hwnd);

Parametry

hwnd
[in] Uchwyt okna.

Wartość zwracana

Nonzero, jeśli przycisk jest właścicielem dostarczonego uchwytu okna; w przeciwnym razie 0.

Uwagi

Ta metoda zwraca wartość niezerową, jeśli element hwnd odwołuje się do uchwytu bezpośredniego okna lub jest elementem podrzędnym uchwytu okna skojarzonego z przyciskiem. Ta metoda zwraca wartość 0, jeśli wartość hwnd ma wartość NULL.

CMFCToolBarButton::IsVisible

Określa, czy przycisk paska narzędzi jest widoczny.

BOOL IsVisible() const;

Wartość zwracana

Niezerowe, jeśli przycisk paska narzędzi jest widoczny; w przeciwnym razie 0.

Uwagi

Przycisk paska narzędzi można pokazać lub ukryć przy użyciu metody CMFCToolBarButton::SetVisible . Wywołaj metodę CPane::AdjustSizeImmediate na nadrzędnym pasku narzędzi po wywołaniu polecenia CMFCToolBarButton::SetVisible , aby ponownie obliczyć układ nadrzędnego paska narzędzi.

CMFCToolBarButton::IsWindowVisible

Określa, czy podstawowy uchwyt okna przycisku jest widoczny.

virtual BOOL IsWindowVisible();

Wartość zwracana

Niezerowe, jeśli podstawowy uchwyt okna przycisku jest widoczny; w przeciwnym razie 0.

Uwagi

Ta metoda zwraca wartość niezerową, jeśli atrybut style bazowego uchwytu okna zawiera styl WS_VISIBLE. Ta metoda zwraca wartość FALSE, jeśli bazowy uchwyt okna przycisku ma wartość NULL.

CMFCToolBarButton::m_bImage

Określa, czy na przycisku jest wyświetlany obraz.

BOOL m_bImage;

Uwagi

Jeśli ten element członkowski danych ma wartość TRUE, platforma wyświetla obraz skojarzony z przyciskiem paska narzędzi; w przeciwnym razie struktura nie wyświetla obrazu. Ten element członkowski ma wpływ na wartość zwracaną metody CMFCToolBarButton::m_bImage .

CMFCToolBarButton::m_bText

Określa, czy etykieta tekstowa jest wyświetlana na przycisku.

BOOL m_bText;

Uwagi

Jeśli ten element członkowski danych ma wartość TRUE, platforma wyświetla etykietę tekstową przycisku paska narzędzi; w przeciwnym razie platforma nie wyświetla etykiety tekstowej. Ten element członkowski ma wpływ na wartość zwracaną metody CMFCToolBarButton::m_bText .

CMFCToolBarButton::m_bTextBelow

Określa, czy etykieta tekstowa jest wyświetlana pod obrazem na przycisku.

BOOL m_bTextBelow;

Uwagi

Jeśli ta zmienna składowa ma wartość TRUE, platforma wyświetla tekst przycisku pod obrazem. Wartość domyślna tego elementu członkowskiego to FALSE.

CMFCToolBarButton::m_bUserButton

Określa, czy przycisk ma obraz zdefiniowany przez użytkownika

BOOL m_bUserButton;

Uwagi

Ten element członkowski danych ma wartość TRUE, gdy przycisk ma skojarzony obraz zdefiniowany przez użytkownika.

CMFCToolBarButton::m_bWholeText

Określa, czy przycisk wyświetla pełną etykietę tekstową, nawet jeśli nie pasuje do prostokąta ograniczenia.

BOOL m_bWholeText;

Uwagi

Jeśli ten element członkowski danych ma wartość TRUE, platforma wyświetla pełną etykietę tekstową, powiększając przycisk. W przeciwnym razie struktura obcina i dołącza wielokropek ( ...) do etykiety tekstowej.

CMFCToolBarButton::m_bWrap

Określa, czy przycisk obok separatora zostanie umieszczony w następnym wierszu.

BOOL m_bWrap;

Uwagi

Platforma ustawia ten element członkowski danych na wartość TRUE, gdy przycisk paska narzędzi nie pasuje do bieżącego wiersza lub po określeniu układu (na przykład określonej liczby przycisków paska narzędzi na wiersz).

Platforma umieszcza ten przycisk w następnym wierszu, jeśli ten element członkowski danych ma wartość TRUE, a pasek narzędzi jest zadokowany w poziomie lub zmienno.

Wartość domyślna tego elementu członkowskiego danych to FALSE.

CMFCToolBarButton::m_bWrapText

Określa, czy są włączone etykiety tekstowe wielowierszowe.

AFX_IMPORT_DATA static BOOL m_bWrapText;

Uwagi

Jeśli ta statyczna zmienna składowa ma wartość TRUE, platforma umożliwia wszystkim paski narzędzi wyświetlanie etykiet tekstowych wielowierszowych na przyciskach paska narzędzi.

Wartość domyślna tego elementu członkowskiego danych to FALSE.

CMFCToolBarButton::m_nID

Identyfikator polecenia przycisku.

UINT m_nID;

Uwagi

Identyfikator polecenia -1 wskazuje, że przycisk jest separatorem. Wszystkie separatory przycisków mają styl TBBS_SEPARATOR. Aby uzyskać więcej informacji na temat stylów przycisków, zobacz CMFCToolBarButton::m_nStyle .

CMFCToolBarButton::m_nStyle

Styl przycisku.

UINT m_nStyle;

Uwagi

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

CMFCToolBarButton::m_strText

Etykieta tekstowa przycisku.

CString m_strText;

Uwagi

Ten element członkowski danych zawiera etykietę tekstową przycisku. Etykieta tekstowa może być pusta.

CMFCToolBarButton::NotifyCommand

Określa, czy przycisk przetwarza komunikat WM_COMMAND .

virtual BOOL NotifyCommand(int iNotifyCode);

Parametry

iNotifyCode
[in] Komunikat powiadomienia skojarzony z poleceniem .

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Struktura wywołuje tę metodę, gdy zostanie wysłany komunikat WM_COMMAND do okna nadrzędnego.

Domyślnie ta metoda zwraca wartość FALSE. Zastąpi tę metodę, aby zwrócić wartość TRUE, jeśli chcesz przetworzyć komunikat WM_COMMAND lub FALSE, aby wskazać, że nadrzędny pasek narzędzi powinien obsługiwać komunikat.

CMFCToolBarButton::OnAddToCustomizePage

Wywoływana przez platformę po dodaniu przycisku do okna dialogowego Dostosowywanie .

virtual void OnAddToCustomizePage();

Uwagi

Domyślna implementacja tej metody nic nie robi. Zastąpi tę metodę, jeśli chcesz wykonać jakąś akcję po dodaniu przycisku do okna dialogowego Dostosowywanie .

CMFCToolBarButton::OnBeforeDrag

Określa, czy przycisk można przeciągnąć.

virtual BOOL OnBeforeDrag() const;

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk można przeciągnąć; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, zanim użytkownik zacznie przeciągać przycisk.

Domyślna implementacja tej metody zwraca wartość TRUE. Zastąpij tę metodę, aby zwrócić wartość FALSE, aby wyłączyć przeciąganie przycisku.

CMFCToolBarButton::OnBeforeDrop

Określa, czy użytkownik może usunąć przycisk na docelowym pasku narzędzi.

virtual BOOL OnBeforeDrop(CMFCToolBar* pTarget);

Parametry

pTarget
[in] Cel operacji przeciągania i upuszczania.

Wartość zwracana

WARTOŚĆ TRUE, jeśli przycisk można upuścić na podanym pasku narzędzi docelowym; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę przed usunięciem przycisku na pasku narzędzi.

Domyślna implementacja tej metody zwraca wartość TRUE. Zastąpi tę metodę, aby zwrócić wartość FALSE, aby wyłączyć operację upuszczania w określonym obiekcie docelowym.

CMFCToolBarButton::OnCalculateSize

Wywoływana przez platformę w celu obliczenia rozmiaru przycisku dla określonego kontekstu urządzenia i stanu dokowania.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

Parametry

PDC
[in] Kontekst urządzenia, w ramach którego jest wyświetlany przycisk.

sizeDefault
[in] Domyślny rozmiar przycisku.

bHorz
[in] Stan docku nadrzędnego paska narzędzi. Ten parametr ma wartość TRUE, jeśli pasek narzędzi jest zadokowany w poziomie lub jest przestawny lub FAŁSZ, jeśli pasek narzędzi jest zadokowany w pionie.

Wartość zwracana

Struktura SIZE zawierająca wymiary przycisku w pikselach.

Uwagi

Struktura wywołuje tę metodę, aby określić rozmiar przycisku paska narzędzi dla określonego kontekstu urządzenia i stanu docku.

Domyślna implementacja uwzględnia rozmiary tekstu i obrazu (jeśli są wyświetlane), położenie tekstu i obrazu (tekst poniżej lub po prawej stronie obrazu) oraz stan docku paska narzędzi.

Zastąp tę metodę, jeśli chcesz podać rozmiar przycisku niestandardowego (na przykład przycisku edytuj).

CMFCToolBarButton::OnCancelMode

Wywoływana przez platformę do obsługi komunikatu WM_CANCELMODE .

virtual void OnCancelMode();

Uwagi

Domyślna implementacja tej metody nic nie robi. Zastąpi tę metodę, jeśli chcesz obsłużyć komunikat WM_CANCELMODE .

CMFCToolBarButton::OnChangeParentWnd

Wywoływana przez strukturę po wstawieniu przycisku do nowego paska narzędzi.

virtual void OnChangeParentWnd(CWnd* pWndParent);

Parametry

pWndParent
[in] Nowe okno nadrzędne.

Uwagi

Przycisk jest wstawiany do paska narzędzi, na przykład gdy użytkownik przeciąga go z jednego paska narzędzi do innego paska narzędzi.

Domyślna implementacja tej metody nic nie robi.

CMFCToolBarButton::OnClick

Wywoływana przez platformę, gdy użytkownik kliknie przycisk myszy.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay=TRUE);

Parametry

pWnd
[in] Okno nadrzędne przycisku paska narzędzi.

bDelay
[in] Wartość TRUE, jeśli komunikat powinien być obsługiwany z opóźnieniem.

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Platforma wywołuje tę metodę, gdy użytkownik kliknie przycisk paska narzędzi.

Domyślna implementacja nic nie robi i zwraca wartość FALSE. Zastąpi tę metodę, aby zwrócić wartość niezerową, jeśli przycisk przetwarza komunikat kliknięcia.

CMFCToolBarButton::OnClickUp

Wywoływana przez platformę, gdy użytkownik zwalnia przycisk myszy.

virtual BOOL OnClickUp();

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Platforma wywołuje tę metodę, gdy użytkownik zwolni przycisk paska narzędzi.

Domyślna implementacja nic nie robi i zwraca wartość FALSE. Zastąpi tę metodę, aby zwrócić wartość niezerową, jeśli przycisk przetwarza komunikat kliknięcia.

CMFCToolBarButton::OnContextHelp

Wywoływana przez platformę, gdy nadrzędny pasek narzędzi obsługuje komunikat WM_HELPHITTEST.

virtual BOOL OnContextHelp(CWnd* pWnd);

Parametry

pWnd
[in] Okno nadrzędne przycisku paska narzędzi.

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Domyślna implementacja tej metody nic nie robi i zwraca wartość FALSE. Zastąpi tę metodę, aby zwrócić wartość niezerową, jeśli przycisk przetwarza komunikat pomocy.

Aby uzyskać więcej informacji na temat komunikatu WM_HELPHITTEST, zobacz TN028: Pomoc kontekstowa z uwzględnieniem kontekstu.

CMFCToolBarButton::OnCtlColor

Wywoływana przez platformę, gdy nadrzędny pasek narzędzi obsługuje komunikat WM_CTLCOLOR.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

Parametry

PDC
[in] Kontekst urządzenia, w ramach którego jest wyświetlany przycisk.

nCtlColor
[in] Powiadomienie o określonym kolorze.

Wartość zwracana

Uchwyt do obiektu pędzla, którego struktura używa do malowania tła przycisku.

Uwagi

Struktura wywołuje tę metodę, gdy nadrzędny pasek narzędzi przetwarza komunikat WM_CTLCOLOR dla przycisku paska narzędzi zawierającego kontrolkę systemu Windows. Struktura nie wywołuje tej metody, jeśli przycisk paska narzędzi jest bez okna.

Struktura wywołuje tę metodę, gdy struktura paska narzędzi jest w trybie dostosowywania, a przycisk paska narzędzi jest odblokowany. Aby uzyskać więcej informacji na temat trybu dostosowywania, zobacz CMFCToolBar::SetCustomizeMode. Aby uzyskać więcej informacji na temat blokowania przycisków paska narzędzi, zobacz CMFCToolBarButton::IsLocked.

Domyślna implementacja nie wykonuje żadnych operacji i zwraca wartość NULL.

CMFCToolBarButton::OnCustomizeMenu

Umożliwia przyciskowi modyfikowanie podanego menu, gdy aplikacja wyświetla menu skrótów na nadrzędnym pasku narzędzi.

virtual BOOL OnCustomizeMenu(CMenu* pMenu);

Parametry

pMenu
[in] Menu do dostosowania.

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Domyślna implementacja nic nie robi i zwraca wartość FALSE. Zastąpi tę metodę i zwróć wartość niezerową, jeśli chcesz zmodyfikować zawartość podanego menu.

CMFCToolBarButton::OnDblClk

Wywoływana przez platformę, gdy nadrzędny pasek narzędzi obsługuje komunikat WM_LBUTTONDBLCLK .

virtual void OnDblClk(CWnd* pWnd);

Parametry

pWnd
[in] — okno nadrzędne przycisku.

Uwagi

Ta metoda jest wywoływana przez metodę CMFCToolBar::OnLButtonDblClk , gdy nadrzędny pasek narzędzi obsługuje komunikat WM_LBUTTONDBLCLK .

Domyślna implementacja tej metody nic nie robi.

CMFCToolBarButton::OnDraw

Wywoływana przez strukturę w celu narysowania przycisku przy użyciu określonych stylów i opcji.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz=TRUE,
    BOOL bCustomizeMode=FALSE,
    BOOL bHighlight=FALSE,
    BOOL bDrawBorder=TRUE,
    BOOL bGrayDisabledButtons=TRUE);

Parametry

PDC
[in] Kontekst urządzenia, w ramach którego jest wyświetlany przycisk.

Rect
[in] Prostokąt ograniczenia przycisku.

pImages
[in] Kolekcja obrazów pasków narzędzi skojarzonych z przyciskiem .

bHorz
[in] Stan docku nadrzędnego paska narzędzi. Ten parametr ma wartość TRUE, gdy przycisk jest zadokowany poziomo i FALSE, gdy przycisk jest zadokowany w pionie.

bCustomizeMode
[in] Określa, czy pasek narzędzi jest w trybie dostosowywania. Ten parametr ma wartość TRUE, gdy pasek narzędzi jest w trybie dostosowywania i wartość FALSE, gdy pasek narzędzi nie jest w trybie dostosowywania.

bHighlight
[in] Określa, czy przycisk jest wyróżniony. Ten parametr ma wartość TRUE, gdy przycisk jest wyróżniony i WARTOŚĆ FALSE, gdy przycisk nie jest wyróżniony.

bDrawBorder
[in] Określa, czy przycisk powinien wyświetlać obramowanie. Ten parametr ma wartość TRUE, gdy przycisk powinien wyświetlać obramowanie i wartość FALSE, gdy przycisk nie powinien wyświetlać obramowania.

bGrayDisabledButtons
[in] Określa, czy zacienić wyłączone przyciski, czy używać kolekcji wyłączonych obrazów. Ten parametr ma wartość TRUE, gdy wyłączone przyciski powinny być cieniowane i FALSE, gdy ta metoda powinna używać kolekcji wyłączonych obrazów.

Uwagi

Zastąpij tę metodę, aby dostosować rysunek przycisku paska narzędzi.

CMFCToolBarButton::OnDrawOnCustomizeList

Wywoływana przez strukturę, aby narysować przycisk w okienku Polecenia okna dialogowego Dostosowywanie .

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

Parametry

PDC
[in] Kontekst urządzenia, w ramach którego jest wyświetlany przycisk.

Rect
[in] Prostokąt ograniczenia przycisku.

bSelected
[in] Określa, czy przycisk jest zaznaczony. Jeśli ten parametr ma wartość TRUE, zostanie wybrany przycisk . Jeśli ten parametr ma wartość FALSE, przycisk nie jest zaznaczony.

Wartość zwracana

Szerokość przycisku w pikselach w określonym kontekście urządzenia.

Uwagi

Ta metoda jest wywoływana przez okno dialogowe dostosowywania ( karta Polecenia ), gdy przycisk ma być wyświetlany w polu listy właściciel-rysowanie.

Domyślna implementacja tej metody wyświetla obraz i etykietę tekstową przycisku, jeśli są dostępne. Jeśli etykieta tekstowa przycisku jest niedostępna, metoda wyświetla tekst etykietki narzędzia.

Zastąpij tę metodę, aby wykonać rysunek niestandardowy.

CMFCToolBarButton::OnGetCustomToolTipText

Wywoływana przez strukturę w celu pobrania niestandardowego tekstu etykietki narzędzia dla przycisku.

virtual BOOL OnGetCustomToolTipText(CString& strToolTip);

Parametry

strToolTip
[out] CString Obiekt, który odbiera niestandardowy tekst etykietki narzędzia.

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Struktura wywołuje tę metodę, gdy wyświetla etykietkę narzędzia dla przycisku paska narzędzi. Jeśli ta metoda zwraca wartość FALSE, struktura używa domyślnej etykietki narzędzia.

Domyślna implementacja nic nie robi i zwraca wartość FALSE. Zastąpij tę metodę i zwróć wartość niezerową, aby udostępnić niestandardowy tekst etykietki narzędzia dla przycisku paska narzędzi.

CMFCToolBarButton::OnGlobalFontsChanged

Wywoływana przez platformę, gdy czcionka globalna uległa zmianie.

virtual void OnGlobalFontsChanged();

Uwagi

Domyślna implementacja tej metody nic nie robi. Zastąpi tę metodę, aby zaktualizować czcionkę używaną do wyświetlania tekstu przycisku.

CMFCToolBarButton::OnMove

Wywoływana przez platformę po przesunięciu nadrzędnego paska narzędzi.

virtual void OnMove();

Uwagi

Domyślna implementacja tej metody nic nie robi. Zastąpij tę metodę, aby zmienić położenie przycisku po przesunięciu nadrzędnego paska narzędzi.

CMFCToolBarButton::OnShow

Wywoływana przez platformę, gdy przycisk staje się widoczny lub niewidoczny.

virtual void OnShow(BOOL bShow);

Parametry

bShow
[in] Określa, czy przycisk jest widoczny. Jeśli ten parametr ma wartość TRUE, przycisk jest widoczny. W przeciwnym razie przycisk nie jest widoczny.

Uwagi

Domyślna implementacja tej metody nic nie robi. Zastąpi tę metodę, aby zaktualizować widoczność przycisku.

CMFCToolBarButton::OnSize

Wywoływana przez strukturę, gdy nadrzędny pasek narzędzi zmienia rozmiar lub położenie, a ta zmiana powoduje zmianę rozmiaru przycisku.

virtual void OnSize(int iSize);

Parametry

Rozmiar i
[in] Nowa szerokość przycisku.

Uwagi

Domyślna implementacja tej metody nic nie robi. Zastąpij tę metodę, aby zmienić rozmiar przycisku, gdy zmienia się rozmiar lub położenie nadrzędnego paska narzędzi.

CMFCToolBarButton::OnToolHitTest

Wywoływana przez platformę, gdy nadrzędny pasek narzędzi musi określić, czy punkt znajduje się w prostokątze ograniczenia przycisku.

virtual BOOL OnToolHitTest(
    const CWnd* pWnd,
    TOOLINFO* pTI);

Parametry

pWnd
[in] Okno nadrzędne przycisku. Może mieć wartość NULL.

Pti
[in] Struktura zawierająca TOOLINFO informacje o narzędziu w kontrolce etykietki narzędzia.

Wartość zwracana

Wynik OnMenuButtonToolHitTest , jeśli przycisk może pobrać wskaźnik do okna ramki nadrzędnej; w przeciwnym razie FALSE.

Uwagi

Ta metoda wywołuje jedną z następujących metod, jeśli może przekonwertować okno nadrzędne na prawidłowy obiekt ramki:

CMFCToolBarButton::OnUpdateToolTip

Wywoływana przez strukturę, gdy nadrzędny pasek narzędzi aktualizuje jego tekst etykietki narzędzia.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

Parametry

pWndParent
[in] Okno nadrzędne.

iButtonIndex
[in] Zerowy indeks przycisku w kolekcji przycisków nadrzędnych.

wndToolTip
[in] Kontrolka wyświetlającą tekst etykietki narzędzia.

Str
[out] CString Obiekt, który otrzymuje zaktualizowany tekst etykietki narzędzia.

Wartość zwracana

Ta metoda zwraca wartość FALSE.

Uwagi

Domyślna implementacja tej metody nic nie robi i zwraca wartość FALSE. Zastąpi tę metodę, aby zwrócić wartość niezerową, jeśli podasz ciąg tekstowy etykietki narzędzia.

CMFCToolBarButton::P repareDrag

Wywoływana przez platformę, gdy przycisk ma wykonać operację przeciągania i upuszczania.

virtual BOOL PrepareDrag(COleDataSource& srcItem);

Parametry

srcItem
[in] COleDataSource Obiekt, który przechowuje informacje o stanie operacji przeciągania i upuszczania.

Wartość zwracana

Wartość TRUE, jeśli operacja się powiedzie; w przeciwnym razie FAŁSZ.

Uwagi

Struktura wywołuje tę metodę, aby przygotować przycisk paska narzędzi do przechowywania jego stanu w podanym COleDataSource obiekcie. Ta metoda przechowuje swój stan, serializując się do udostępnionego pliku, a następnie przekazując ten plik do metody COleDataSource::CacheGlobalData . Aby uzyskać więcej informacji na temat serializacji przycisków paska narzędzi, zobacz CMFCToolBarButton::Serialize.

Ta metoda nie wykonuje żadnych operacji i zwraca wartość TRUE, jeśli nie można zapisać przycisku ( metoda CMFCToolBarButton::CanBeStored zwraca wartość FALSE). Zwraca wartość FALSE, jeśli wyjątek występuje podczas serializacji obiektów.

Aby uzyskać więcej informacji na temat operacji przeciągania i upuszczania OLE, zobacz Przeciąganie i upuszczanie OLE.

CMFCToolBarButton::Rect

Pobiera prostokąt ograniczenia przycisku.

const CRect& Rect() const;

Wartość zwracana

CRect Obiekt, który zawiera prostokąt ograniczenia przycisku.

CMFCToolBarButton::ResetImageToDefault

Ustawia wartość domyślną obrazu skojarzonego z przyciskiem .

virtual void ResetImageToDefault();

Uwagi

Ta metoda pobiera obraz domyślny z nadrzędnego paska narzędzi przy użyciu metody CMFCToolBar::GetDefaultImage . Jeśli przycisk nie ma skojarzonego obrazu domyślnego, ta metoda ustawia etykietę tekstową przycisku zgodnie z jego zasobem ciągu przy użyciu metody CStringT::LoadString. Aby uzyskać więcej informacji na temat zasobów ciągów, zobacz Praca z plikami zasobów.

Ta metoda nic nie robi, jeśli przycisk ma obraz zdefiniowany przez użytkownika.

CMFCToolBarButton::SaveBarState

Zapisuje stan przycisku paska narzędzi.

virtual void SaveBarState();

Uwagi

Struktura wywołuje tę metodę podczas tworzenia CMFCToolBarButton obiektu w wyniku operacji przeciągania i upuszczania.

Domyślna implementacja tej metody nic nie robi. Zastąpij tę metodę, aby zapisać stan przycisku paska narzędzi w zewnętrznym źródle danych.

CMFCToolBarButton::Serialize

Odczytuje ten obiekt z archiwum lub zapisuje go w archiwum.

virtual void Serialize(CArchive& ar);

Parametry

Ar
[in] Obiekt CArchive , z którego lub do serializacji.

Uwagi

Ta metoda obsługuje procesy transferu danych, takie jak schowek lub operacje przeciągania i upuszczania. Odczytuje lub zapisuje właściwości przycisku, takie jak identyfikator, etykieta tekstowa i identyfikator obrazu z lub do podanego CArchive obiektu.

Aby zapoznać się z przykładami serializacji, zobacz Serializacja: serializacja obiektu.

CMFCToolBarButton::SetACCData

Wypełnia podany CAccessibilityData obiekt danymi ułatwień dostępu za pomocą przycisku paska narzędzi.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

Parametry

PParent
[in] Okno nadrzędne przycisku paska narzędzi.

data
[in] CAccessibilityData Obiekt wypełniony danymi ułatwień dostępu przycisku paska narzędzi.

Wartość zwracana

Ta metoda zwraca wartość TRUE.

Uwagi

Zastąpi tę metodę, aby zwrócić wartość FALSE, jeśli przycisk paska narzędzi nie udostępnia danych ułatwień dostępu.

CMFCToolBarButton::SetClipboardFormatName

Zmienia nazwę globalnego formatu schowka.

static void __stdcall SetClipboardFormatName(LPCTSTR lpszName);

Parametry

lpszName
[in] Nowa nazwa globalnego formatu schowka. Nie można mieć wartości NULL.

Uwagi

Ta metoda umożliwia wykonywanie operacji przeciągania i upuszczania między wieloma aplikacjami. Każda aplikacja musi podać tę samą nazwę formatu schowka.

Tę metodę należy wywołać przed wywołaniem struktury CMFCToolBarButton::GetClipboardFormat.

CMFCToolBarButton::SetImage

Ustawia indeks obrazu przycisku.

virtual void SetImage(int iImage);

Parametry

iImage
[in] Indeks obrazu w kolekcji obrazów paska narzędzi.

Uwagi

Jeśli przycisk paska narzędzi jest separatorem, iImage odwołuje się do nowej szerokości przycisku separatora.

Jeśli obraz iImage jest mniejszy niż zero, ta metoda wyłącza rysowanie obrazu i umożliwia rysowanie etykiety tekstowej przycisku.

CMFCToolBarButton::SetProtectedCommands

Ustawia listę poleceń, których użytkownik nie może dostosować.

static void SetProtectedCommands(const CList<UINT,UINT>& lstCmds);

Parametry

lstCmds
[in] Lista chronionych poleceń.

Uwagi

W trybie dostosowywania platforma wyłącza polecenia przycisku paska narzędzi, które są chronione. Użytkownik nie może wykonywać operacji przeciągania i upuszczania oraz edytowania na wyłączonych przyciskach paska narzędzi.

Użyj metody CMFCToolBarButton::GetProtectedCommands, aby pobrać listę chronionych poleceń.

CMFCToolBarButton::SetRadio

Wywoływana przez platformę, gdy przycisk zmienia jego stan sprawdzania.

virtual void SetRadio();

Uwagi

Domyślna implementacja tej metody nic nie robi. Zastąpij tę metodę, aby wykonać akcję niestandardową, gdy przycisk zmieni jego stan zaewidencjonowany.

CMFCToolBarButton::SetRect

Ustawia prostokąt ograniczenia przycisku.

void SetRect(const CRect rect);

Parametry

Rect
[in] Nowy prostokąt ograniczenia przycisku.

Uwagi

Ta metoda wywołuje metodę CMFCToolBarButton::OnMove po ustawianiu nowego prostokąta ograniczenia.

CMFCToolBarButton::SetStyle

Ustawia styl przycisku.

virtual void SetStyle(UINT nStyle);

Parametry

nStyle
[in] Nowy styl przycisku.

Uwagi

Domyślna implementacja ustawia element członkowski danych CMFCToolBarButton::m_nStyle na nStyle. Zastąpi tę metodę, jeśli chcesz wykonać dodatkowe przetwarzanie, aby obsłużyć zmianę stylu. Zobacz Style kontrolek ToolBar, aby uzyskać listę prawidłowych flag stylu.

CMFCToolBarButton::SetVisible

Określa, czy przycisk jest widoczny.

void SetVisible(BOOL bShow=TRUE);

Parametry

bShow
[in] Wartość logiczna określająca, czy ma być wyświetlany, czy ukrywany przycisk. Jeśli ten parametr ma wartość TRUE, zostanie wyświetlony przycisk . Jeśli parametr ma wartość FALSE, przycisk jest ukryty.

Uwagi

Ta funkcja służy do ukrywania lub pokazywania określonego przycisku paska narzędzi. Wywołaj metodę CPane::AdjustSizeImmediate po wywołaniu tej metody.

CMFCToolBarButton::Show

Wyświetla lub ukrywa przycisk.

void Show(BOOL bShow);

Parametry

bShow
[in] Wartość logiczna określająca, czy ma być wyświetlany, czy ukrywany przycisk. Jeśli ten parametr ma wartość TRUE, zostanie wyświetlony przycisk . Jeśli parametr ma wartość FALSE, przycisk jest ukryty.

Uwagi

Struktura wywołuje tę metodę, aby zaktualizować widoczność przycisków paska narzędzi po zmianie rozmiaru nadrzędnego paska narzędzi. Struktura wywołuje tę metodę z wartością bShow ustawioną na FALSE, gdy przycisk nie mieści się już w granicach paska narzędzi. Struktura wywołuje tę metodę z wartością bShow ustawioną na wartość TRUE, gdy po ponownym zmianie rozmiaru przycisku mieści się w granicach paska narzędzi.

Użyj metody CMFCToolBarButton::SetVisible, aby ustawić ogólny wgląd przycisku.

Ta metoda wywołuje metodę CMFCToolBarButton::OnShow po zaktualizowaniu stanu widoczności przycisku.

Zobacz też

Wykres hierarchii
Klasy
Klasa CMFCToolBar
Klasa CMFCToolBarImages