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