Partager via


Fonction de rappel PROPENUMPROCEXA (winuser.h)

Fonction de rappel définie par l’application utilisée avec la fonction EnumPropsEx . La fonction reçoit les entrées de propriété d’une liste de propriétés d’une fenêtre. Le type PROPENUMPROCEX définit un pointeur vers cette fonction de rappel. PropEnumProcEx est un espace réservé pour le nom de la fonction définie par l’application.

Syntaxe

PROPENUMPROCEXA Propenumprocexa;

BOOL Propenumprocexa(
  HWND unnamedParam1,
  LPSTR unnamedParam2,
  HANDLE unnamedParam3,
  ULONG_PTR unnamedParam4
)
{...}

Paramètres

unnamedParam1

Type : HWND

Handle vers la fenêtre dont la liste des propriétés est énumérée. Ce paramètre est généralement nommé hWnd.

unnamedParam2

Type : LPTSTR

Composant de chaîne d’une entrée de liste de propriétés. Il s’agit de la chaîne spécifiée, ainsi qu’un handle de données, lorsque la propriété a été ajoutée à la liste des propriétés de la fenêtre via un appel à la fonction SetProp . Ce paramètre est généralement nommé lpString.

unnamedParam3

Type : HANDLE

Handle pour les données. Ce handle est le composant de données d’une entrée de liste de propriétés. Ce paramètre est généralement nommé hData.

unnamedParam4

Type : ULONG_PTR

Données définies par l’application. Il s’agit de la valeur spécifiée comme paramètre lParam de l’appel à EnumPropsEx qui a lancé l’énumération. Ce paramètre est généralement nommé dwData.

Valeur retournée

Type : BOOL

Retourne TRUE pour continuer l’énumération de liste de propriétés.

Retourne LA valeur FALSE pour arrêter l’énumération de la liste de propriétés.

Remarques

Note

Les paramètres sont définis dans l’en-tête sans nom : typedef BOOL (CALLBACK* PROPENUMPROCEXA)(HWND, LPSTR, HANDLE, ULONG_PTR);. Par conséquent, le bloc de syntaxe les répertorie comme unnamedParam1 - unnamedParam4. Vous pouvez nommer ces paramètres dans votre application. Toutefois, elles sont généralement nommées comme indiqué dans les descriptions des paramètres.

Les restrictions suivantes s’appliquent à cette fonction de rappel :

  • La fonction de rappel peut appeler la fonction RemoveProp . Toutefois, RemoveProp ne peut supprimer que la propriété transmise à la fonction de rappel par le biais des paramètres de la fonction de rappel.
  • La fonction de rappel ne doit pas tenter d’ajouter des propriétés.

Note

L’en-tête winuser.h définit PROPENUMPROCEX comme 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

Requirement Valeur
Client minimum requis Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Fenêtres
Header winuser.h (include Windows.h)

Voir aussi

Conceptuel

Propriétés de la fenêtre

Référence

EnumPropsEx

RemoveProp

SetProp