DLGITEMTEMPLATEEX

La struttura DLGITEMTEMPLATEEX non è definita in ogni file di intestazione standard. La definizione della struttura è fornita qui di spiegare il formato di un modello esteso per un dialogo.

Per ogni controllo in una finestra di dialogo, un modello di finestra di dialogo esteso ha un blocco di dati che utilizza il formato DLGITEMTEMPLATEEX per descrivere il controllo. Per una descrizione del formato di un modello di finestra di dialogo estesa, vedere DLGTEMPLATEEX.

typedef struct {DWORD helpID; 
    DWORD exStyle; 
    Stile DWORD; 
    breve x; 
    y breve; 
    cx breve; 
    cy breve; 
    PAROLA di identificazione; 
    sz_Or_Ord windowClass; / / nome o per ordinale di una classe di finestra
    sz_Or_Ord titolo;       / / titolo stringa o numero ordinale di una risorsa
    WORD extraCount;     / / byte di dati per la creazione di seguito
} DLGITEMTEMPLATEEX 
 

Membri

helpID

Specifica l'identificatore di contesto di aiuto per il controllo. Quando il sistema invia un WM_HELP messaggio, passa il valore helpID nel membro dwContextId i HELPINFO struttura.

dwExtendedStyle

Specifica stili estesi per una finestra. Questo membro non viene utilizzato per creare controlli nelle finestre di dialogo, ma le applicazioni che utilizzano modelli di casella di dialogo possono utilizzarlo per creare altri tipi di windows.

stile

Specifica lo stile del controllo. Questo membro può essere una combinazione di valori di stile finestra (ad esempio WS_BORDER) e uno o più valori di stile di controllo (ad esempio BS_PUSHBUTTON ed ES_LEFT).

x

Specifica la coordinata x, in unità di casella di dialogo, dell'angolo superiore sinistro del controllo. Questa coordinata è sempre rispetto all'angolo superiore sinistro dell'area client della finestra di dialogo.

y

Specifica la coordinata y, in unità di casella di dialogo, dell'angolo superiore sinistro del controllo. Questa coordinata è sempre rispetto all'angolo superiore sinistro dell'area client della finestra di dialogo.

cx

Specifica la larghezza, in unità di casella di dialogo, del controllo.

cy

Specifica l'altezza, in unità di casella di dialogo, del controllo.

identificazione

Specifica l'identificatore del controllo.

windowClass

Specifica una matrice di lunghezza variabile di elementi 16-bit che identifica la classe della finestra del controllo. Se il primo elemento della matrice è un valore diverso da 0xFFFF, il sistema considera la matrice come una stringa Unicode con terminazione null che specifica il nome di una classe finestra registrati.

Se il primo elemento è 0xFFFF, la matrice avrà un ulteriore elemento che specifica il valore ordinale di una classe di sistema predefiniti. Il numero ordinale può essere uno dei seguenti valori di atomo.

Valore	Significato
0x0080	Pulsante
0x0081	Modifica
0x0082	Statica
0x0083	Casella di riepilogo
0x0084	Barra di scorrimento
0x0085	Casella combinata

titolo

Specifica una matrice di lunghezza variabile di elementi 16bit contenente l'identificatore di risorsa o testo iniziale del controllo. Se il primo elemento della matrice è 0xFFFF, la matrice avrà un ulteriore elemento che specifica un valore ordinale che identifica una risorsa, ad esempio un'icona, in un file eseguibile. È possibile utilizzare un identificatore di risorsa per i controlli, ad esempio controlli statici icona, caricare e visualizzare un'icona o altre risorse piuttosto che testo.

Se il primo elemento è un valore diverso da 0xFFFF, il sistema considera la matrice come una stringa Unicode con terminazione null che specifica il testo iniziale.

extraCount

Specifica il numero di byte di dati per la creazione che seguono questo membro. Se questo valore è maggiore di zero, i dati di creazione inizia presso il confine di parola successivo. Dati per la creazione possono essere di qualsiasi dimensione e formato. La routine della finestra del controllo deve essere in grado di interpretare i dati. Quando il sistema crea il controllo, passa un puntatore a questi dati nel parametro lParam del messaggio WM_CREATE inviati al controllo.

Osservazioni

Un modello esteso per una finestra di dialogo è costituito da un'intestazione DLGTEMPLATEEX , seguita da una struttura DLGITEMTEMPLATEEX per ogni controllo nella finestra di dialogo.

Ogni struttura DLGITEMTEMPLATEEX deve essere allineato su un confine DWORD . Le matrici di windowClass e titolo di lunghezza variabile devono essere allineate limiti a parole . La matrice di dati di creazione, se presente, deve essere allineata su un limite di parola.

Se si specificano stringhe di caratteri nelle matrici windowClass e titolo , è necessario utilizzare stringhe Unicode. Per creare codice che funziona su Windows e Windows NT, utilizzare la funzione MultiByteToWideChar per generare queste stringhe Unicode.

I membri x, y, cx, cy e specificano i valori in unità di casella di dialogo. È possibile convertire questi valori in unità schermo (pixel) utilizzando la funzione MapDialogRect.

Descrizione

nbsp; Windows &NT: richiede 3,51 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.

Vedi anche

Panoramica di finestre di dialogo, finestra di dialogo casella strutture, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DLGITEMTEMPLATE, DLGTEMPLATE, DLGTEMPLATEEX, MapDialogRect, MultiByteToWideChar

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

Index