ListView_GetEditControl Makro (commctrl.h)
Ruft das Handle für das Bearbeitungssteuerelement ab, das zum Bearbeiten des Texts eines Listenansichtselements verwendet wird. Sie können dieses Makro verwenden oder die LVM_GETEDITCONTROL Nachricht explizit senden.
Syntax
HWND ListView_GetEditControl(
HWND hwndLV
);
Parameter
hwndLV
Typ: HWND-
Ein Handle für das Listenansicht-Steuerelement.
Rückgabewert
Typ: HWND-
Gibt das Handle an das Bearbeitungssteuerelement zurück, falls erfolgreich, oder NULL- andernfalls.
Bemerkungen
Wenn die Bearbeitung von Bezeichnungen beginnt, wird ein Bearbeitungssteuerelement erstellt, positioniert und initialisiert. Bevor es angezeigt wird, sendet das Listenansicht-Steuerelement das übergeordnete Fenster an einen LVN_BEGINLABELEDIT Benachrichtigungscode.
Um die Bearbeitung von Bezeichnungen anzupassen, implementieren Sie einen Handler für LVN_BEGINLABELEDIT und verwenden sie ListView_GetEditControl, um eine LVM_GETEDITCONTROL Nachricht an das Listenansichtssteuerelement zu senden. Wenn eine Bezeichnung bearbeitet wird, ist der Rückgabewert ein Handle für das Bearbeitungssteuerelement. Verwenden Sie dieses Handle, um das Bearbeitungssteuerelement anzupassen, indem Sie die üblichen EM_XXX Nachrichten senden.
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, sollten es jedoch nicht zerstören. Um die Bearbeitung abzubrechen, können Sie das Listenansicht-Steuerelement eine WM_CANCELMODE Nachricht senden.
Das bearbeitete Listenansichtselement ist das aktuell fokussierte Element, d. h. das Element im fokussierten Zustand. Um ein Element basierend auf seinem Status zu suchen, verwenden Sie die LVM_GETNEXTITEM Nachricht.
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 |