Funzione di callback PROPENUMPROCA (winuser.h)

Articolo
11/20/2024

Funzione di callback definita dall'applicazione usata con la funzione EnumProps. La funzione riceve le voci di 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à. Si tratta della 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à.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winuser.h (include Windows.h)