SetDlgItemTextA, fonction (winuser.h)
Définit le titre ou le texte d’un contrôle dans une boîte de dialogue.
Syntaxe
BOOL SetDlgItemTextA(
[in] HWND hDlg,
[in] int nIDDlgItem,
[in] LPCSTR lpString
);
Paramètres
[in] hDlg
Type : HWND
Handle de la boîte de dialogue qui contient le contrôle.
[in] nIDDlgItem
Type : int
Contrôle avec un titre ou du texte à définir.
[in] lpString
Type : LPCTSTR
Texte à copier dans le contrôle.
Valeur retournée
Type : BOOL
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
La fonction SetDlgItemText envoie un message WM_SETTEXT au contrôle spécifié.
Exemples
Pour obtenir un exemple, consultez Utilisation de zones de liste.
Notes
L’en-tête winuser.h définit SetDlgItemText comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winuser.h (inclure Windows.h) |
| Bibliothèque | User32.lib |
| DLL | User32.dll |
| Ensemble d’API | ext-ms-win-ntuser-dialogbox-l1-1-0 (introduit dans Windows 8) |
Voir aussi
Conceptuel
Référence