Struttura DLGTEMPLATEEX

Articolo
06/13/2023

Un modello di finestra di dialogo esteso inizia con un'intestazione DLGTEMPLATEEX che descrive la finestra di dialogo e specifica il numero di controlli nella finestra di dialogo. Per ogni controllo in una finestra di dialogo, un modello di finestra di dialogo esteso include un blocco di dati che usa il formato DLGITEMTEMPLATEEX per descrivere il controllo.

La struttura DLGTEMPLATEEX non è definita in alcun file di intestazione standard. La definizione della struttura viene fornita qui per spiegare il formato di un modello esteso per una finestra di dialogo.

Sintassi

typedef struct {
  WORD      dlgVer;
  WORD      signature;
  DWORD     helpID;
  DWORD     exStyle;
  DWORD     style;
  WORD      cDlgItems;
  short     x;
  short     y;
  short     cx;
  short     cy;
  sz_Or_Ord menu;
  sz_Or_Ord windowClass;
  WCHAR     title[titleLen];
  WORD      pointsize;
  WORD      weight;
  BYTE      italic;
  BYTE      charset;
  WCHAR     typeface[stringLen];
} DLGTEMPLATEEX;

Members

dlgVer

Tipo: WORD

Numero di versione del modello della finestra di dialogo estesa. Questo membro deve essere impostato su 1.

URL REST

Tipo: WORD

Indica se un modello è un modello di finestra di dialogo esteso. Se la firma è 0xFFFF, si tratta di un modello di finestra di dialogo esteso. In questo caso, il membro dlgVer specifica il numero di versione del modello. Se la firma è qualsiasi valore diverso da 0xFFFF, si tratta di un modello di finestra di dialogo standard che usa le strutture DLGTEMPLATE e DLGITEMTEMPLATE.

helpID

Tipo: DWORD

Identificatore del contesto della Guida per la finestra di dialogo. Quando il sistema invia un messaggio di WM_HELP , passa questo valore nel membro wContextId della struttura HELPINFO .

exStyle

Tipo: DWORD

Stili di finestre estese. Questo membro non viene usato durante la creazione di 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 della finestra di dialogo. Questo membro può essere una combinazione di valori di stile finestra e valori di stile della finestra di dialogo.

Se lo stile include lo stile della finestra di dialogo DS_SETFONT o DS_SHELLFONT , l'intestazione DLGTEMPLATEEX del modello della finestra di dialogo estesa contiene quattro membri aggiuntivi ( punti, peso, corsivo e tipoface) che descrivono il tipo di carattere da utilizzare per il testo nell'area client e nei controlli della finestra di dialogo. Se possibile, il sistema crea un carattere in base ai valori specificati in questi membri. Il sistema invia quindi un messaggio WM_SETFONT alla finestra di dialogo e a ogni controllo per fornire un handle al tipo di carattere.

Per altre informazioni, vedere Finestra di dialogo Tipi di carattere.

cDlgItems

Tipo: WORD

Numero di controlli nella finestra di dialogo.

x

Tipo: breve

Coordinata x, nella finestra di dialogo unità, dell'angolo superiore sinistro della finestra di dialogo.

y

Tipo: breve

Coordinata y, nella finestra di dialogo unità, dell'angolo superiore sinistro della finestra di dialogo.

Cx

Tipo: breve

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

Cy

Tipo: breve

Altezza, nelle unità della finestra di dialogo, della finestra di dialogo.

Menu

Tipo: sz_Or_Ord

Matrice a lunghezza variabile di elementi a 16 bit che identifica una risorsa di menu per la finestra di dialogo. Se il primo elemento di questa matrice è 0x0000, la finestra di dialogo non ha alcun menu e la matrice non ha altri elementi. Se il primo elemento è 0xFFFF, la matrice ha un elemento aggiuntivo che specifica il valore ordinale di una risorsa di menu in un file eseguibile. Se il primo elemento ha un altro valore, il sistema considera la matrice come stringa Unicode con terminazione null che specifica il nome di una risorsa di menu in un file eseguibile.

windowClass

Tipo: sz_Or_Ord

Matrice a lunghezza variabile di elementi a 16 bit che identifica la classe di finestra della finestra di dialogo. Se il primo elemento della matrice è 0x0000, il sistema usa la classe della finestra di dialogo predefinita per la finestra di dialogo e la matrice non ha altri elementi. Se il primo elemento è 0xFFFF, la matrice ha un elemento aggiuntivo che specifica il valore ordinale di una classe di finestra di sistema predefinita. Se il primo elemento ha un altro valore, il sistema considera la matrice come stringa Unicode con terminazione null che specifica il nome di una classe di finestra registrata.

title

Tipo: WCHAR[titleLen]

Titolo della finestra di dialogo. Se il primo elemento di questa matrice è 0x0000, la finestra di dialogo non ha titolo e la matrice non ha altri elementi.

pointize

Tipo: WORD

Dimensione punto del tipo di carattere da utilizzare per il testo nella finestra di dialogo e i relativi controlli.