Klasa CMFCToolBarButton

Artykuł
06/10/2015

Udostępnia funkcje przycisków na paskach narzędzi.

class CMFCToolBarButton : public CObject

Członkowie

Publiczne konstruktory

Nazwa	Opis
CMFCToolBarButton::CMFCToolBarButton	Konstrukcje i inicjuje CMFCToolBarButton obiektu.
CMFCToolBarButton::~CMFCToolBarButton	Destruktor.

Metody publiczne

Nazwa	Opis
CMFCToolBarButton::CanBeDropped	Określa, czy podczas dostosowywania użytkownika można umieścić przycisk na pasku narzędzi lub menu.
CMFCToolBarButton::CanBeStored	Określa, czy przycisk mogą być przechowywane.
CMFCToolBarButton::CanBeStretched	Określa, czy użytkownik może rozciągnąć podczas dostosowywania przycisku.
CMFCToolBarButton::CompareWith	Porównuje to wystąpienie z dołączonym CMFCToolBarButton obiektu.
CMFCToolBarButton::CopyFrom	Kopiuje bieżącego przycisku właściwości innego przycisku paska narzędzi.
CMFCToolBarButton::CreateFromOleData	Tworzy CMFCToolBarButton obiektu z dołączonym COleDataObject obiektu.
CMFCToolBarButton::CreateObject	Używane w ramach do tworzenia dynamicznych wystąpienie tego typu klasy.
CMFCToolBarButton::EnableWindow	Włącza lub wyłącza myszy i klawiatury.
CMFCToolBarButton::ExportToMenuButton	Tekst jest kopiowany z przycisku paska narzędzi do menu.
CMFCToolBarButton::GetClipboardFormat	Pobiera format schowka globalnego dla aplikacji.
CMFCToolBarButton::GetHwnd	Pobiera uchwyt okna, który jest skojarzony z przycisku paska narzędzi.
CMFCToolBarButton::GetImage	Pobiera indeks obrazu przycisku.
CMFCToolBarButton::GetInvalidateRect	Pobiera regionu obszaru klienckiego przycisku, który musi zostać odświeżone.
CMFCToolBarButton::GetParentWnd	Pobiera okno nadrzędne przycisku.
CMFCToolBarButton::GetProtectedCommands	Pobiera listę poleceń, które użytkownik nie można dostosować.
CMFCToolBarButton::GetTextSize	Pobiera rozmiar tekstu przycisku.
CMFCToolBarButton::HasFocus	Określa, czy przycisk ma fokus bieżącego.
CMFCToolBarButton::HaveHotBorder	Określa, czy obramowania przycisku jest wyświetlany, gdy użytkownik zaznaczy przycisk.
CMFCToolBarButton::IsDrawImage	Określa, czy obraz jest wyświetlany na przycisku.
CMFCToolBarButton::IsDrawText	Określa, czy tekst etykiety jest wyświetlany 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 mogą być wyświetlane z rozszerzonych obramowanie.
CMFCToolBarButton::IsFirstInGroup	Określa, czy przycisk jest na pierwszym miejscu w swojej grupie przycisku.
CMFCToolBarButton::IsHidden	Określa, czy przycisk zostanie ukryty.
CMFCToolBarButton::IsHorizontal	Określa, czy przycisk znajduje się na poziomym pasku narzędzi.
CMFCToolBarButton::IsLastInGroup	Określa, czy przycisk w ostatniej pozycji w grupie przycisku.
CMFCToolBarButton::IsLocked	Określa, czy przycisk jest zablokowane paska narzędzi (nie można go dostosowywać).
CMFCToolBarButton::IsOwnerOf	Określa, czy przycisk jest właścicielem uchwyt okna dostarczone.
CMFCToolBarButton::IsVisible	Określa, czy przycisk paska narzędzi jest widoczny.
CMFCToolBarButton::IsWindowVisible	Określa, czy podstawowej uchwyt okna przycisk jest widoczny.
CMFCToolBarButton::NotifyCommand	Określa, czy przycisk procesów WM_COMMAND wiadomości.
CMFCToolBarButton::OnAddToCustomizePage	Wywoływana przez ramy, gdy przycisk zostanie dodany do Dostosuj okno dialogowe.
CMFCToolBarButton::OnBeforeDrag	Określa, czy przycisk można przeciągać.
CMFCToolBarButton::OnBeforeDrop	Określa, czy użytkownik można upuścić przycisku na pasku narzędzi docelowego.
CMFCToolBarButton::OnCalculateSize	Wywołana przez ramy do obliczania rozmiaru przycisku dla określonego urządzenia kontekstu i stan dokowania.
CMFCToolBarButton::OnCancelMode	Wywołana w ramach obsługi WM_CANCELMODE wiadomości.
CMFCToolBarButton::OnChangeParentWnd	Wywołana w ramach przycisku jest wstawiane do nowego paska narzędzi.
CMFCToolBarButton::OnClick	Wywołana przez ramy, gdy użytkownik kliknie przycisk myszy.
CMFCToolBarButton::OnClickUp	Wywołana przez ramy, gdy użytkownik zwolni przycisk myszy.
CMFCToolBarButton::OnContextHelp	Wywołana w ramach narzędzi nadrzędnego obsługując WM_HELPHITTEST wiadomości.
CMFCToolBarButton::OnCtlColor	Wywołana w ramach narzędzi nadrzędnego obsługując WM_CTLCOLOR wiadomości.
CMFCToolBarButton::OnCustomizeMenu	Umożliwia przycisk, aby modyfikować dostarczonego menu, gdy aplikacja wyświetla menu skrótów na pasku narzędzi nadrzędnej.
CMFCToolBarButton::OnDblClk	Wywołana w ramach narzędzi nadrzędnego obsługując WM_LBUTTONDBLCLK wiadomości.
CMFCToolBarButton::OnDraw	Wywołana przez ramy rysowanie przy użyciu określonych stylów i opcje przycisku.
CMFCToolBarButton::OnDrawOnCustomizeList	Wywoływany przez rysowanie przycisku ramach polecenia okienka Dostosuj okno dialogowe.
CMFCToolBarButton::OnGetCustomToolTipText	Wywołana przez RAM, aby pobrać tekst niestandardowa etykietka narzędzia dla przycisku.
CMFCToolBarButton::OnGlobalFontsChanged	Wywołana w ramach po zmianie czcionki globalnego.
CMFCToolBarButton::OnMove	Wywołana w ramach po nadrzędnej paska narzędziowego.
CMFCToolBarButton::OnShow	Wywoływane w ramach, gdy przycisk stanie się widoczny lub niewidoczny.
CMFCToolBarButton::OnSize	Wywołana w ramach narzędzi nadrzędnego zmienia jego rozmiar lub położenie i zmiana ta wymaga przycisk aby zmienić rozmiar.
CMFCToolBarButton::OnToolHitTest	Wywołana w ramach podczas narzędzi nadrzędny musi określić, czy punkt jest prostokątem ograniczającym przycisku.
CMFCToolBarButton::OnUpdateToolTip	Wywołana w ramach podczas narzędzi nadrzędnego aktualizuje jego tekst etykietki narzędzia.
CMFCToolBarButton::PrepareDrag	Wywoływane w ramach, gdy przycisk jest wykonywanie operacji przeciągania i upuszczania.
CMFCToolBarButton::Rect	Pobiera prostokąta obwiedni przycisku.
CMFCToolBarButton::ResetImageToDefault	Ustawia domyślną wartość obrazu, który jest skojarzony z przyciskiem.
CMFCToolBarButton::SaveBarState	Zapisuje stan przycisku paska narzędzi.
CMFCToolBarButton::Serialize	Odczytuje ten obiekt z archiwum lub zapisuje je do archiwum.(Zastępuje CObject::Serialize.)
CMFCToolBarButton::SetACCData	Wypełnia przewidziano CAccessibilityData obiekt z dostępności danych z przycisku paska narzędzi.
CMFCToolBarButton::SetClipboardFormatName	Zmienia format schowka globalnego.
CMFCToolBarButton::SetImage	Ustawia indeks obrazu przycisku.
CMFCToolBarButton::SetProtectedCommands	Ustawia listę poleceń, które użytkownik nie można dostosować.
CMFCToolBarButton::SetRadio	Wywołana w ramach przycisk Zmiana stanu zaznaczenia.
CMFCToolBarButton::SetRect	Ustawia prostokąta obwiedni przycisku.
CMFCToolBarButton::SetStyle	Ustawia styl przycisku.
CMFCToolBarButton::SetVisible	Określa, czy przycisk jest widoczny.
CMFCToolBarButton::Show	Pokazuje lub ukrywa przycisk.

Członkowie danych

Nazwa	Opis
CMFCToolBarButton::m_bImage	Określa, czy obraz jest wyświetlany na przycisku.
CMFCToolBarButton::m_bText	Określa, czy tekst etykiety jest wyświetlany na przycisku.
CMFCToolBarButton::m_bTextBelow	Określa, czy tekst etykiety jest wyświetlane pod spodem obraz na przycisku.
CMFCToolBarButton::m_bUserButton	Określa, czy przycisk ma obraz zdefiniowany przez użytkownika.
CMFCToolBarButton::m_bWholeText	Określa, czy przycisk wyświetla jego pełny tekst etykiety, nawet jeśli nie mieści się w obwiedni prostokąta.
CMFCToolBarButton::m_bWrap	Określa, czy przycisk separator zostanie wprowadzony w następnym wierszu.
CMFCToolBarButton::m_bWrapText	Określa, czy włączone są etykiety tekstu wielowierszowego.
CMFCToolBarButton::m_nID	Identyfikator polecenia przycisku.
CMFCToolBarButton::m_nStyle	Styl przycisku.
CMFCToolBarButton::m_strText	Etykieta tekstu przycisku.

Uwagi

A CMFCToolbarButton obiekt jest formant, który znajduje się na pasku narzędzi.Jego działanie przypomina zwykły przycisk.Obraz i etykietę tekstową można przypisać do tego obiektu.Przycisk paska narzędzi może mieć również identyfikator poleceniaPo kliknięciu przycisku paska narzędzi ramach wykonuje polecenie, które określa ten identyfikator.

Zazwyczaj można dostosować przyciski paska narzędzi: użytkownika można przeciągnij przyciski z jednego paska narzędzi do innego i skopiować, wkleić, usuwać i edytować tekst etykiety i obrazy.Aby uniemożliwić użytkownikowi dostosowywanie paska narzędzi, paska narzędzi można zablokować na dwa sposoby.Albo zestawu bLocked flaga TRUE po wywołaniu CMFCToolBar::LoadToolBar, lub dodać identyfikator polecenia poszczególnych przycisku do globalnej listy poleceń chronione za pomocą CMFCToolBarButton::SetProtectedCommands metody.

CMFCToolBarButtonobiekty wyświetlane obrazy z globalnego kolekcji obrazów na pasku narzędzi w aplikacji.Kolekcje te są utrzymywane przez narzędzi nadrzędnej Klasa CMFCToolBar.Aby uzyskać więcej informacji, zobacz Klasa CMFCToolBarImages.

Po kliknięciu przycisku paska narzędzi, jego narzędzi nadrzędnego przetwarza wiadomość myszy i komunikuje się właściwe działania do przycisku.Jeśli przycisk ma identyfikator prawidłowe polecenie, wysyła narzędzi nadrzędnej WM_COMMAND wiadomość do ramki macierzystej.

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

Przykład

Poniższy przykład ilustruje sposób konfigurowania CMFCToolBarButton obiektu za pomocą różnych metod w CMFCToolBarButton klasy.Przykład ilustruje sposób włączyć myszy i klawiatury ustawić indeksu obraz przycisku, ustawić prostokąta obwiedni przycisk i przycisk widoczny.To urywek kodu jest częścią próbka kontrolna kartę.

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