Partager via


Fonction de rappel PROPENUMPROCA (winuser.h)

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

Syntaxe

PROPENUMPROCA Propenumproca;

BOOL Propenumproca(
  HWND unnamedParam1,
  LPCSTR unnamedParam2,
  HANDLE unnamedParam3
)
{...}

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 : LPCTSTR

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.

Valeur de retour

Type : BOOL

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

Retourne FAUX pour arrêter l’énumération de liste de propriétés.

Remarques

Note

Les paramètres sont définis dans l’en-tête sans nom : typedef BOOL (CALLBACK* PROPENUMPROCA)(HWND, LPCSTR, HANDLE);. Par conséquent, le bloc de syntaxe les répertorie comme unnamedParam1 - unnamedParam3. 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 PROPENUMPROC 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête winuser.h (include Windows.h)

Voir aussi

conceptuelle

propriétés de fenêtre

de référence

EnumProps

RemoveProp

SetProp