Funzione di callback PROPENUMPROCA (winuser.h)

Articolo
03/04/2024

Funzione di callback definita dall'applicazione usata con la funzione EnumProps . La funzione riceve le voci delle proprietà dall'elenco delle proprietà di una finestra. Il tipo PROPENUMPROC definisce un puntatore a questa funzione di callback. PropEnumProc è un segnaposto per il nome della funzione definita dall'applicazione.

Sintassi

PROPENUMPROCA Propenumproca;

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

Parametri

unnamedParam1

Tipo: HWND

Handle per la finestra di cui è in corso l'enumerazione dell'elenco di proprietà.

unnamedParam2

Tipo: LPCTSTR

Componente stringa di una voce dell'elenco di proprietà. Questa è la stringa specificata, insieme a un handle di dati, quando la proprietà è stata aggiunta all'elenco delle proprietà della finestra tramite una chiamata alla funzione SetProp .

unnamedParam3

Tipo: HANDLE

Handle per i dati. Questo handle è il componente dati di una voce dell'elenco di proprietà.

Valore restituito

Tipo: BOOL

Restituisce TRUE per continuare l'enumerazione dell'elenco delle proprietà.

Restituisce FALSE per arrestare l'enumerazione dell'elenco di proprietà.

Commenti

A questa funzione di callback si applicano le restrizioni seguenti:

La funzione di callback può chiamare la funzione RemoveProp . Tuttavia, RemoveProp può rimuovere solo la proprietà passata alla funzione di callback tramite i parametri della funzione di callback.
La funzione di callback non deve tentare di aggiungere proprietà.

Nota

L'intestazione winuser.h definisce PROPENUMPROC come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)