CHeaderCtrl::GetItemDropDownRect

Artigo
02/25/2013

Obtém o retângulo delimitador do botão drop-down para um item de cabeçalho no controle de cabeçalho atual.

BOOL GetItemDropDownRect(
     int iItem, 
     LPRECT lpRect
) const;

Parâmetros

Parâmetro	Descrição
[in] iItem	Índice com base zero de um item de cabeçalho cujo estilo é HDF_SPLITBUTTON.Para obter mais informações, consulte o membro de fmt estrutura de HDITEM .
[out] lpRect	Ponteiro a estrutura de RECT para receber informação do retângulo delimitador.

Valor de retorno

true se essa função é com êxito; caso contrário, false.

Comentários

Este método envia a mensagem de HDM_GETITEMDROPDOWNRECT , que é descrita em Windows SDK.

Requisitos

Cabeçalho: afxcmn.h

Este método é suportado em Windows Vista e posteriormente.

Os requisitos adicionais para o método são descritos em Criar requisitos de controles comuns do Windows Vista.

Exemplo

O exemplo de código a seguir define a variável, m_headerCtrl, que é usada para acessar o controle de cabeçalho atual.Esta variável é usado no exemplo a seguir.

    CHeaderCtrl m_headerCtrl;
    CSplitButton m_splitButton;

O exemplo de código demonstra o método de GetItemDropDownRect .Em uma seção anterior de código, nós criaremos um controle de cabeçalho com as cinco colunas.O exemplo de código a seguir desenha um retângulo 3D em torno do local na primeira coluna que é permitida para o botão suspenso do cabeçalho.

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