Struttura DLGITEMTEMPLATEEX

Blocco di testo usato da un modello di finestra di dialogo esteso per descrivere la finestra di dialogo estesa. Per una descrizione del formato di un modello di finestra di dialogo esteso, vedere DLGTEMPLATEEX.

Sintassi

typedef struct {
  DWORD     helpID;
  DWORD     exStyle;
  DWORD     style;
  short     x;
  short     y;
  short     cx;
  short     cy;
  DWORD     id;
  sz_Or_Ord windowClass;
  sz_Or_Ord title;
  WORD      extraCount;
} DLGITEMTEMPLATEEX;

Members

helpID

Tipo: DWORD

Identificatore del contesto della Guida per il controllo. Quando il sistema invia un messaggio di WM_HELP , passa il valore helpID nel membro dwContextId della struttura HELPINFO .

exStyle

Tipo: DWORD

Stili estesi per una finestra. Questo membro non viene usato per creare controlli nelle finestre di dialogo, ma le applicazioni che usano i modelli di finestra di dialogo possono usarla per creare altri tipi di finestre. Per un elenco di valori, vedere Stili finestra estesi.

style

Tipo: DWORD

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

x

Tipo: breve

Coordinata x, nella finestra di dialogo unità, dell'angolo superiore sinistro del controllo. Questa coordinata è sempre relativa all'angolo superiore sinistro dell'area client della finestra di dialogo.

y

Tipo: breve

Coordinata y, nella finestra di dialogo unità, dell'angolo superiore sinistro del controllo. Questa coordinata è sempre relativa all'angolo superiore sinistro dell'area client della finestra di dialogo.

Cx

Tipo: breve

Larghezza, in unità della finestra di dialogo, del controllo.

Cy

Tipo: breve

Altezza, in unità della finestra di dialogo, del controllo.

id

Tipo: DWORD

Identificatore del controllo.

windowClass

Tipo: sz_Or_Ord

Matrice a lunghezza variabile di elementi a 16 bit che specifica la classe di finestra del controllo. Se il primo elemento di questa matrice è qualsiasi valore diverso da 0xFFFF, il sistema considera la matrice come stringa Unicode con terminazione null che specifica il nome di una classe di finestra registrata.

Se il primo elemento è 0xFFFF, la matrice ha un elemento aggiuntivo che specifica il valore ordinale di una classe di sistema predefinita. L'ordinale può essere uno dei valori atom seguenti.

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

title

Tipo: sz_Or_Ord

Matrice a lunghezza variabile di elementi a 16 bit che contiene il testo iniziale o l'identificatore della risorsa del controllo. Se il primo elemento di questa matrice è 0xFFFF, la matrice ha un elemento aggiuntivo che specifica il valore ordinale di una risorsa, ad esempio un'icona, in un file eseguibile. È possibile usare un identificatore di risorsa per i controlli, ad esempio controlli icona statici, che caricano e visualizzano un'icona o un'altra risorsa anziché testo. Se il primo elemento è qualsiasi valore diverso da 0xFFFF, il sistema considera la matrice come stringa Unicode con terminazione null che specifica il testo iniziale.

extraCount

Tipo: WORD

Numero di byte di dati di creazione che seguono questo membro. Se questo valore è maggiore di zero, i dati di creazione iniziano al limite word successivo. Questi dati di creazione possono essere di qualsiasi dimensione e formato. La procedura 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 che invia al controllo.

Commenti

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 allineata a un limite DWORD . Le matrici di finestre a lunghezza variabileClasse e titolo devono essere allineate ai limiti di WORD . La matrice di dati di creazione, se presente, deve essere allineata a un limite WORD .

Se si specificano stringhe di caratteri nella matrice windowClass e title , è necessario usare stringhe Unicode. Usare la funzione MultiByteToWideChar per generare stringhe Unicode da stringhe ANSI.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]

Vedi anche

Riferimento

CreateDialogIndirect

CreateDialogIndirectParam

CreateWindowEx

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

Informazioni concettuali

Finestre di dialogo

Altre risorse

Multibytetowidechar

WM_HELP