Compartilhar via


CHeaderCtrl::SetFocusedItem

Define o foco para um item de cabeçalho especificado no controle de cabeçalho corrente.

BOOL SetFocusedItem(
          int iItem
);

Parâmetros

Parâmetro

Descrição

[in] iItem

Índice baseado em zero de um item de cabeçalho.

Valor de retorno

true Se esse método for bem-sucedida; caso contrário, false.

Comentários

Esse método envia o HDM_SETFOCUSEDITEM 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 SetFocusedItem e GetFocusedItem métodos. Em uma seção do código anterior, criamos um controle de cabeçalho com cinco colunas.No entanto, você pode arrastar um separador de coluna para que a coluna não fique visível.O exemplo a seguir define e confirma o último cabeçalho da coluna sistema autônomo o item de foco.

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

    // Check that we get the value we set.
    int item = m_headerCtrl.GetItemCount() - 1;
    m_headerCtrl.SetFocusedItem(item);
    int itemGet = m_headerCtrl.GetFocusedItem();
    CString str = _T("Set: focused item = %d\nGet: focused item = %d");
    str.Format(str, item, itemGet);
    MessageBox(str, _T("Set/GetFocused Item"));
}

Consulte também

Referência

Classe CHeaderCtrl

Gráfico de hierarquia

HDM_SETFOCUSEDITEM

CHeaderCtrl::GetFocusedItem

Outros recursos

CHeaderCtrl membros