CHeaderCtrl::GetItemDropDownRect

Artigo
08/25/2010

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

BOOL GetItemDropDownRect(
          int iItem, 
          LPRECT lpRect
) const;

Parâmetros

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

Valor de retorno

true Se essa função for bem-sucedida; caso contrário, false.

Comentários

Esse método envia o HDM_GETITEMDROPDOWNRECT mensagem, que é descrita no Windows SDK.

Requisitos

Cabeçalho: afxcmn.h

Este método é suportado no Windows Vista e mais recente.

Requisitos adicionais para este método são descritos em compilação Requisitos para controles comuns do Windows Vista.

Exemplo

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

    CHeaderCtrl m_headerCtrl;
    CSplitButton m_splitButton;

O exemplo de código a seguir demonstra o GetItemDropDownRect método. Em uma seção do código anterior, criamos um controle de cabeçalho com cinco colunas.O exemplo de código a seguir desenha um retângulo 3D em todo o local na primeira coluna que está reservada para o botão drop-down de 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));
    }
}