macro ListView_GetEditControl (commctrl.h)
Obtient le handle du contrôle d’édition utilisé pour modifier le texte d’un élément d’affichage de liste. Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_GETEDITCONTROL.
Syntaxe
HWND ListView_GetEditControl(
HWND hwndLV
);
Paramètres
hwndLV
Handle du contrôle list-view.
Valeur de retour
Retourne le handle au contrôle d’édition en cas de réussite ou null sinon.
Remarques
Lorsque la modification d’étiquette commence, un contrôle d’édition est créé, positionné et initialisé. Avant de s’afficher, le contrôle d’affichage de liste envoie sa fenêtre parente un code de notification LVN_BEGINLABELEDIT.
Pour personnaliser la modification d’étiquette, implémentez un gestionnaire pour LVN_BEGINLABELEDIT et utilisez-le ListView_GetEditControl pour envoyer un message LVM_GETEDITCONTROL au contrôle d’affichage de liste. Si une étiquette est en cours de modification, la valeur de retour est un handle pour le contrôle d’édition. Utilisez ce handle pour personnaliser le contrôle d’édition en envoyant les messages EM_XXX habituels.
Lorsque l’utilisateur termine ou annule la modification, le contrôle d’édition est détruit et le handle n’est plus valide. Vous pouvez sous-classer le contrôle d’édition, mais vous ne devez pas le détruire. Pour annuler la modification, vous pouvez envoyer au contrôle d’affichage de liste un message WM_CANCELMODE.
L’élément d’affichage de liste en cours de modification est l’élément actuellement axé, c’est-à-dire l’élément dans l’état prioritaire. Pour rechercher un élément en fonction de son état, utilisez le message LVM_GETNEXTITEM.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | commctrl.h |