CHeaderCtrl::GetItemDropDownRect

Artigo
06/10/2015

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 Requisitos de compilação para 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));
    }
}