CHeaderCtrl::GetItemDropDownRect

Articolo
03/05/2013

Ottiene il rettangolo di delimitazione del pulsante a discesa per una voce di intestazione nel controllo intestazione corrente.

BOOL GetItemDropDownRect(
     int iItem, 
     LPRECT lpRect
) const;

Parametri

Parametro	Descrizione
[in] iItem	Indice in base zero di una voce di intestazione con lo stile è HDF_SPLITBUTTON.Per ulteriori informazioni, vedere il membro fmt della struttura HDITEM.
[out] lpRect	Puntatore a una struttura RECT ricevere informazioni sul rettangolo di delimitazione.

Valore restituito

true se la funzione ha esito positivo; in caso contrario, false.

Note

Questo metodo invia il messaggio HDM_GETITEMDROPDOWNRECT, come descritto in Windows SDK.

Requisiti

intestazione: afxcmn.h

Questo metodo è supportato in Windows Vista e versioni successive.

i requisiti aggiuntivi per questo metodo sono descritti in Requisiti di compilazione per i controlli comuni di Windows Vista.

Esempio

Nell'esempio di codice seguente viene definita la variabile, m_headerCtrl, utilizzata per accedere al controllo intestazione corrente.Questa variabile viene utilizzata nell'esempio seguente.

    CHeaderCtrl m_headerCtrl;
    CSplitButton m_splitButton;

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo del metodo GetItemDropDownRect.In una sezione precedente del codice, creato un controllo intestazione con cinque colonne.Nell'esempio di codice consente di disegnare un rettangolo intorno 3D nella posizione della prima colonna che è riservata per il pulsante a discesa dell'intestazione.

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