Partager via


CHeaderCtrl::SetFocusedItem

Place le focus à un élément d'en-tête spécifié dans le contrôle header actuel.

BOOL SetFocusedItem(
     int iItem
);

Paramètres

Paramètre

Description

[in] iItem

Index de base zéro d'un élément d'en-tête.

Valeur de retour

true si cette méthode est réussie ; sinon, false.

Notes

Cette méthode envoie le message de HDM_SETFOCUSEDITEM , qui est décrit dans Kit de développement logiciel Windows.

Configuration requise

en-tête : afxcmn.h

Cette méthode est prise en Windows Vista et versions ultérieures.

Les spécifications supplémentaires pour cette méthode sont décrites dans Spécifications pour la génération des contrôles communs Windows Vista.

Exemple

l'exemple de code suivant définit la variable, m_headerCtrl, qui est utilisée pour accéder au contrôle header actuel. Cette variable est utilisée dans l'exemple suivant.

  CHeaderCtrl m_headerCtrl;
    CSplitButton m_splitButton;

L'exemple de code suivant illustre les méthodes SetFocusedItem et GetFocusedItem. Dans la première section de code, nous avons créé un contrôle header avec cinq colonnes. Toutefois, vous pouvez faire glisser un séparateur de colonne afin que la colonne n'est pas visible. L'exemple suivant définit puis confirme la dernière en-tête de colonne en tant qu'élément de focus.

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

Voir aussi

Référence

CHeaderCtrl, classe

Graphique de la hiérarchie

HDM_SETFOCUSEDITEM

CHeaderCtrl::GetFocusedItem