Condividi tramite

Informazioni sulle proprietà della finestra

  • Articolo

Una proprietà window è qualsiasi dato assegnato a una finestra. Una proprietà della finestra è in genere un handle dei dati specifici della finestra, ma può essere qualsiasi valore. Ogni proprietà della finestra è identificata da un nome stringa. Esistono diverse funzioni che consentono alle applicazioni di usare le proprietà della finestra. Questa panoramica illustra gli argomenti seguenti:

Vantaggi dell'uso delle proprietà della finestra

Le proprietà della finestra vengono in genere usate per associare i dati a una finestra sottoclassata o a una finestra in un'applicazione MDI (Multiple-Document Interface). In entrambi i casi, non è consigliabile usare i byte aggiuntivi specificati nella funzione CreateWindow o nella struttura di classi per i due motivi seguenti:

  • Un'applicazione potrebbe non sapere quanti byte aggiuntivi sono disponibili o come viene usato lo spazio. Usando le proprietà della finestra, l'applicazione può associare i dati a una finestra senza accedere ai byte aggiuntivi.
  • Un'applicazione deve accedere ai byte aggiuntivi usando gli offset. Tuttavia, le proprietà della finestra sono accessibili dai relativi identificatori di stringa, non dagli offset.

Per altre informazioni sulla sottoclasse, vedere Subclassing delle procedure window. Per altre informazioni sulle finestre MDI, vedere Interfaccia a documenti multipli.

Assegnazione delle proprietà della finestra

La funzione SetProp assegna una proprietà window e il relativo identificatore stringa a una finestra. La funzione GetProp recupera la proprietà window identificata dalla stringa specificata. La funzione RemoveProp elimina definitivamente l'associazione tra una finestra e una proprietà window, ma non elimina definitivamente i dati stessi. Per eliminare definitivamente i dati stessi, usare la funzione appropriata per liberare l'handle restituito da RemoveProp.

Enumerazione delle proprietà della finestra

Le funzioni EnumProps e EnumPropsEx enumPropsEx enumera tutte le proprietà di una finestra usando una funzione di callback definita dall'applicazione. Per altre informazioni sulla funzione di callback, vedere PropEnumProc.

EnumPropsEx include un parametro aggiuntivo per i dati definiti dall'applicazione usati dalla funzione di callback. Per altre informazioni sulla funzione di callback, vedere PropEnumProcEx.