CHeaderCtrl::GetItemDropDownRect

Artykuł
02/27/2013

Pobiera prostokąta obwiedni przycisk rozwijanej dla elementu nagłówka bieżącego formantu nagłówka.

BOOL GetItemDropDownRect(
     int iItem, 
     LPRECT lpRect
) const;

Parametry

Parametr	Opis
[w]iItem	Indeksu elementu nagłówek, którego styl jest HDF_SPLITBUTTON.Aby uzyskać więcej informacji, zobacz fmt członek HDITEM struktury.
[out]lpRect	Wskaźnik RECT strukturę, aby otrzymywać informacje prostokąta obwiedni.

Wartość zwracana

trueJeśli ta funkcja jest pomyślne; w przeciwnym razie false.

Uwagi

Metoda ta wysyła HDM_GETITEMDROPDOWNRECT wiadomości, która jest opisana w Windows SDK.

Wymagania

Nagłówek: afxcmn.h

Ta metoda jest obsługiwana w Windows Vista i później.

Dodatkowe wymagania dla tej metody opisane w Budowanie wymagania dla systemu Windows Vista wspólnej kontroli.

Przykład

Poniższy przykład kodu definiuje zmienną, m_headerCtrl, czyli umożliwiające dostęp do bieżącego nagłówka formantu.Ta zmienna jest używana w następnym przykładzie.

    CHeaderCtrl m_headerCtrl;
    CSplitButton m_splitButton;

Poniższy przykład kodu pokazuje GetItemDropDownRect metody.W przypadku wcześniejszych sekcji kodu stworzyliśmy nagłówka formantu z pięciu kolumn.Poniższy kod rysuje prostokąt 3D wokół położenie w pierwszej kolumnie, zarezerwowaną dla przycisku rozwijanej nagłówka.

void CNVC_MFC_CHeaderCtrl_s4Dlg::OnXGetitemdropdownrect()
{
    if (controlCreated == FALSE) {
        MessageBox(_T("Header control has not been created yet."));
        return;
    }

// Get the dropdown rect for the first column.
    CRect rect;
    BOOL bRetVal = m_headerCtrl.GetItemDropDownRect(0, &rect);
    if (bRetVal == TRUE) {
    // Draw around the dropdown rect a rectangle that has red 
    // left and top sides, and blue right and bottom sides.
        CDC* pDC = m_headerCtrl.GetDC();
        pDC->Draw3dRect(rect, RGB(255, 0, 0), RGB(0, 0, 255));
    }
}