Freigeben über


TreeView_EditLabel Makro (commctrl.h)

Beginnt mit der direkten Bearbeitung des Texts des angegebenen Elements, wobei der Text des Elements durch ein einzeiliges Bearbeitungssteuerelement ersetzt wird, das den Text enthält. Dieses Makro wählt implizit das angegebene Element aus und konzentriert es. Sie können dieses Makro verwenden oder die TVM_EDITLABEL Nachricht explizit senden.

Syntax

HWND TreeView_EditLabel(
   HWND      hwnd,
   HTREEITEM hitem
);

Parameter

hwnd

Typ: HWND-

Behandeln sie das Strukturansichtssteuerelement.

hitem

Typ: HTREEITEM-

Behandeln sie das zu bearbeitende Element.

Rückgabewert

Typ: HWND-

Gibt das Handle an das Bearbeitungssteuerelement zurück, das verwendet wird, um den Elementtext zu bearbeiten, falls erfolgreich, oder NULL andernfalls.

Bemerkungen

Dieses Makro sendet einen TVN_BEGINLABELEDIT Benachrichtigungscode an das übergeordnete Element des Strukturansicht-Steuerelements.

Wenn der Benutzer die Bearbeitung abgeschlossen oder abbricht, wird das Bearbeitungssteuerelement zerstört, und der Handle ist nicht mehr gültig. Sie können das Bearbeitungssteuerelement unterklassen, aber nicht zerstören.

Das Steuerelement muss den Fokus haben, bevor Sie dieses Makro aufrufen. Der Fokus kann mithilfe der SetFocus--Funktion festgelegt werden.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Zielplattform- Fenster
Header- commctrl.h