CHeaderCtrl::SetFocusedItem
Legt den Fokus zu einem angegebenen Headerelement im aktuellen Header-Steuerelement fest.
BOOL SetFocusedItem(
int iItem
);
Parameter
Parameter |
Beschreibung |
---|---|
[in] iItem |
Der nullbasierte Index Headerelements. |
Rückgabewert
true, wenn diese Methode erfolgreich ist; andernfalls false.
Hinweise
Diese Methode sendet die HDM_SETFOCUSEDITEM Meldung, die im Windows SDK beschrieben wird.
Anforderungen
Header: afxcmn.h
Diese Methode wird in Windows Vista und höher unterstützt.
Zusätzliche Anforderungen für diese Methode werden in Build-Anforderungen für Windows Vista-gemeinsame Regelungen beschrieben.
Beispiel
Im folgenden Codebeispiel wird die Variable, m_headerCtrl, die verwendet wird, um auf das aktuelle Header-Steuerelement zuzugreifen.Diese Variable wird im folgenden Beispiel verwendet.
CHeaderCtrl m_headerCtrl;
CSplitButton m_splitButton;
Im folgenden Codebeispiel werden die SetFocusedItem-Methode und die GetFocusedItem-Methode veranschaulicht.In einem früheren Codeabschnitt erstellt haben, wird ein Header-Steuerelement mit fünf Spalten.Sie können jedoch ein Spaltentrennzeichen ziehen, damit die Spalte nicht sichtbar ist.Im folgenden Beispiel legt fest und bestätigt dann den letzten Spaltenheader als das Fokusenelement.
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"));
}