Klasa CSplitButton

Klasa CSplitButton reprezentuje kontrolkę przycisku podziału. Kontrolka przycisku podziału wykonuje domyślne zachowanie, gdy użytkownik kliknie główną część przycisku i wyświetli menu rozwijane, gdy użytkownik kliknie strzałkę listy rozwijanej przycisku.

Składnia

class CSplitButton : public CButton

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
CSplitButton::CSplitButton	CSplitButton Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CSplitButton::Create	Tworzy kontrolkę przycisku podziału z określonymi stylami i dołącza ją do bieżącego CSplitButton obiektu.
CSplitButton::SetDropDownMenu	Ustawia menu rozwijane wyświetlane, gdy użytkownik kliknie strzałkę listy rozwijanej bieżącego formantu przycisku podziału.

Metody chronione

Nazwa/nazwisko	opis
CSplitButton::OnDropDown	Obsługuje powiadomienie BCN_DROPDOWN wysyłane przez system, gdy użytkownik kliknie strzałkę listy rozwijanej bieżącego kontrolki przycisku podziału.

Uwagi

Klasa CSplitButton pochodzi z klasy CButton . Kontrolka przycisku podziału to kontrolka przycisku, której styl jest BS_SPLITBUTTON. Spowoduje to wyświetlenie menu niestandardowego, gdy użytkownik kliknie strzałkę listy rozwijanej. Aby uzyskać więcej informacji, zobacz style BS_SPLITBUTTON i BS_DEFSPLITBUTTON w stylach przycisków.

Na poniższej ilustracji przedstawiono okno dialogowe zawierające kontrolkę pager i kontrolkę przycisku podzielonego (1). Strzałka listy rozwijanej (2) została już kliknięta i zostanie wyświetlona podmenu (3).

Hierarchia dziedziczenia

Cobject

Ccmdtarget

Cwnd

Cbutton

CSplitButton

Wymagania

Nagłówek: afxcmn.h

Ta klasa jest obsługiwana w systemie Windows Vista i nowszych wersjach.

Dodatkowe wymagania dotyczące tej klasy opisano w temacie Build Requirements for Windows Vista Common Controls (Wymagania dotyczące kompilacji dla typowych kontrolek systemu Windows Vista).

CSplitButton::Create

Tworzy kontrolkę przycisku podziału z określonymi stylami i dołącza ją do bieżącego CSplitButton obiektu.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametry

Dwstyle
[in] Kombinacja bitowa (OR) stylów, która ma być stosowana do kontrolki. Aby uzyskać więcej informacji, zobacz Style przycisków.

Rect
[in] Odwołanie do struktury RECT zawierającej położenie i rozmiar kontrolki.

pParentWnd
[in] Wskaźnik o wartości innej niż null do obiektu CWnd , który jest oknem nadrzędnym kontrolki.

Nid
[in] Identyfikator kontrolki.

Wartość zwracana

Wartość TRUE, jeśli ta metoda zakończyła się pomyślnie; w przeciwnym razie, FAŁSZ.

CSplitButton::CSplitButton

CSplitButton Tworzy obiekt. Parametry konstruktora określają podmenu, który jest wyświetlany, gdy użytkownik kliknie strzałkę listy rozwijanej kontrolki przycisku podziału.

CSplitButton();

CSplitButton(
    UINT nMenuId,
    UINT nSubMenuId)
CSplitButton(CMenu* pMenu)

Parametry

nMenuId
[in] Identyfikator zasobu paska menu.

nSubMenuId
[in] Identyfikator zasobu podmenu.

pMenu
[in] Wskaźnik do obiektu CMenu , który określa podmenu. Obiekt CSplitButton usuwa CMenu obiekt i skojarzone z nim jednostki HMENU, gdy CSplitButton obiekt wykracza poza zakres.

Uwagi

Użyj metody CSplitButton::Create, aby utworzyć kontrolkę przycisku podziału i dołączyć ją do CSplitButton obiektu.

CSplitButton::OnDropDown

Obsługuje powiadomienie BCN_DROPDOWN wysyłane przez system, gdy użytkownik kliknie strzałkę listy rozwijanej bieżącego kontrolki przycisku podziału.

afx_msg void OnDropDown(
    NMHDR* pNMHDR,
    LRESULT* pResult);

Parametry

pNMHDR
[in] Wskaźnik do struktury NMHDR zawierającej informacje o powiadomieniu BCN_DROPDOWN .

Presult
[out] (Nieużywana; żadna wartość nie jest zwracana). Wartość zwracana powiadomienia BCN_DROPDOWN .

Uwagi

Gdy użytkownik kliknie strzałkę listy rozwijanej w kontrolce przycisku podziału, system wysyła komunikat powiadomienia BCN_DROPDOWN, który OnDropDown obsługuje metoda. CSplitButton Jednak obiekt nie przekazuje powiadomienia BCN_DROPDOWN do kontrolki zawierającej kontrolkę przycisku podziału. W związku z tym kontrolka zawierająca nie może obsługiwać akcji niestandardowej w odpowiedzi na powiadomienie.

Aby zaimplementować akcję niestandardową obsługiwaną przez kontrolkę zawierającą, należy użyć obiektu CButton ze stylem CSplitButton BS_SPLITBUTTON zamiast obiektu. Następnie zaimplementuj procedurę obsługi dla powiadomienia BCN_DROPDOWN w CButton obiekcie . Aby uzyskać więcej informacji, zobacz Style przycisków.

Aby zaimplementować akcję niestandardową obsługiwaną przez samą kontrolkę przycisku podziału, użyj odbicia komunikatu. Utwórz własną klasę z klasy i nadaj CSplitButton jej nazwę, na przykład CMySplitButton. Następnie dodaj następującą mapę komunikatów do aplikacji, aby obsłużyć powiadomienie BCN_DROPDOWN:

BEGIN_MESSAGE_MAP(CMySplitButton,
    CSplitButton)
    ON_NOTIFY_REFLECT(BCN_DROPDOWN, &CMySplitButton::OnDropDown)
END_MESSAGE_MAP()

CSplitButton::SetDropDownMenu

Ustawia menu rozwijane wyświetlane, gdy użytkownik kliknie strzałkę listy rozwijanej bieżącego formantu przycisku podziału.

void SetDropDownMenu(
    UINT nMenuId,
    UINT nSubMenuId);

void SetDropDownMenu(CMenu* pMenu);

Parametry

nMenuId
[in] Identyfikator zasobu paska menu.

nSubMenuId
[in] Identyfikator zasobu podmenu.

pMenu
[in] Wskaźnik do obiektu CMenu , który określa podmenu. Obiekt CSplitButton usuwa CMenu obiekt i skojarzone z nim jednostki HMENU, gdy CSplitButton obiekt wykracza poza zakres.

Uwagi

Parametr nMenuId identyfikuje pasek menu, który jest poziomą listą elementów paska menu. Parametr nSubMenuId jest numerem indeksu zero, który identyfikuje podmenu, który jest listą rozwijaną elementów menu skojarzonych z każdym elementem paska menu. Na przykład typowa aplikacja zawiera menu zawierające elementy paska menu, "Plik", "Edytuj" i "Pomoc". Element paska menu "Plik" zawiera podmenu zawierający elementy menu "Otwórz", "Zamknij" i "Zakończ". Po kliknięciu strzałki listy rozwijanej kontrolki split-button kontrolka wyświetla określony podmenu, a nie pasek menu.

Na poniższej ilustracji przedstawiono okno dialogowe zawierające kontrolkę pager i kontrolkę przycisku podzielonego (1). Strzałka listy rozwijanej (2) została już kliknięta i zostanie wyświetlona podmenu (3).

Przykład

Pierwsza instrukcja w poniższym przykładzie kodu pokazuje metodę CSplitButton::SetDropDownMenu . Utworzyliśmy menu za pomocą edytora zasobów programu Visual Studio, który automatycznie nazwał identyfikator paska menu IDR_MENU1. Parametr nSubMenuId , czyli zero, odnosi się do jedynego podmenu paska menu.

// Initialize the dropdown menu of the splitbutton control.
m_splitButton.SetDropDownMenu(IDR_MENU1, 0);

// Create the pager control.
BOOL nRet;
CRect rect;
GetClientRect(&rect);
nRet = m_pager.Create(
    (WS_VISIBLE | WS_CHILD | PGS_HORZ),
    CRect(rect.Width() / 4, 5, (rect.Width() * 3) / 4, 55),
    this,
    IDC_PAGER1);

m_pager.GetClientRect(&rect);
nRet = m_button.Create(
    _T("This is a very, very long button. 012345678901234567890"),
    (WS_VISIBLE | WS_CHILD), // Do not use CCS_NORESIZE.
    CRect(0, 0, rect.Width(), 30),
    &m_pager, IDC_BUTTON1);

m_pager.SetChild(m_button.m_hWnd);
m_pager.SetButtonSize(20);
m_pager.SetBorder(1);

Zobacz też

Klasa CSplitButton
Wykres hierarchii
Klasa CButton