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 Anforderungen für die Erstellung von Windows Vista-Standardsteuerelementen 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"));
}