SetProp

La funzione SetProp aggiunge una nuova voce o modifica una voce esistente nell'elenco proprietà della finestra specificata. La funzione aggiunge una nuova voce all'elenco, se la stringa di caratteri specificato non esiste già nell'elenco. La nuova voce contiene la stringa e la maniglia. In caso contrario, la funzione sostituisce handle corrente della stringa con l'handle specificato.

(BOOL SetProp HWND  hWnd, / / handle di finestraLPCTSTRlpString, / / atomo o indirizzo di stringaGestirehData / / handle di dati);
 

Parametri

hWnd

Gestire alla finestra cui elenco proprietà riceve la nuova voce.

lpString

Puntatore a una stringa con terminazione null o contiene un atomo che identifica una stringa. Se questo parametro è un atomo, deve essere un atomo globale creato da una precedente chiamata alla GlobalAddAtom funzione. L'atomo, un valore di 16 bit, deve essere collocato nella parola significativi di lpString; la parola di ordine superiore deve essere zero.

hData

Gestire i dati da copiare l'elenco delle proprietà. La maniglia di dati in grado di identificare qualsiasi valore utile all'applicazione.

Valori restituiti

Se l'handle di dati e la stringa vengono aggiunti all'elenco di proprietà, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Prima di distruggere una finestra (che è, prima di elaborare la WM_DESTROY messaggio), un'applicazione deve rimuovere tutte le voci ha aggiunto all'elenco di proprietà. L'applicazione deve utilizzare la funzione RemoveProp per rimuovere le voci.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in winuser.
Importare librerie:Utilizzare user32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Cenni preliminari sulle proprietà di finestra, finestra Proprietà funzioni, EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index