Struttura DLGPAGE (compstui.h)

  • Articolo

La struttura DLGPAGE viene usata per specificare una pagina del foglio delle proprietà nella funzione ComPropSheet di CPSUI . L'indirizzo della struttura è incluso in una struttura COMPROPSHEETUI e tutti i valori membro vengono forniti dal chiamante ComPropSheet .

Sintassi

typedef struct _DLGPAGE {
  WORD      cbSize;
  WORD      Flags;
  DLGPROC   DlgProc;
  LPTSTR    pTabName;
  ULONG_PTR IconID;
  union {
    WORD   DlgTemplateID;
    HANDLE hDlgTemplate;
  } DUMMYUNIONNAME;
} DLGPAGE, *PDLGPAGE;

Members

cbSize

Dimensioni fornite dal chiamante, in byte, della struttura DLGPAGE .

Flags

Flag di bit forniti dal chiamante, come descritto nella tabella seguente.

Flag Definizione
DPF_ICONID_AS_HICON Se impostato, IconID contiene un handle dell'icona. Se non è impostato, IconID contiene un identificatore di risorsa icona.
DPF_USE_HDLGTEMPLATE Se impostato, hDlgTemplate contiene un handle modello. Se non è impostato, DlgTemplateID contiene un identificatore di risorsa modello.

Facoltativo, chiamante fornito dlGPROC-typed puntatore a una finestra di dialogo, usato per elaborare i messaggi inviati dal sistema quando si verificano eventi utente. Se NULL, CPSUI fornisce una procedura della finestra di dialogo. Per altre informazioni, vedere la sezione Osservazioni di seguito.

DlgProc

Definisce il membro DLGPROCDlgProc.

pTabName

Puntatore fornito dal chiamante a una stringa con terminazione NULL da visualizzare nella scheda della pagina.

IconID

Il chiamante fornito può essere uno dei seguenti:

  • Identificatore di risorsa icona. Può essere definito dall'applicazione oppure può essere uno degli identificatori di risorsa dell'icona con prefisso CPSUI fornito da IDI_CPSUI CPSUI.

  • Handle icona. Se viene specificato un handle, DPF_ICONID_AS_HICON deve essere impostato nel membro Flags .

L'icona specificata viene visualizzata nella scheda pagina. Se questo valore è zero, non viene visualizzata un'icona.

DUMMYUNIONNAME

Definisce l'unione DUMMYUNIONNAME .

DUMMYUNIONNAME.DlgTemplateID

Identificatore di risorsa fornito dal chiamante per un modello di finestra di dialogo. Questo può fare riferimento a una risorsa DIALOG fornita dall'applicazione oppure può essere uno dei seguenti identificatori forniti da CPSUI (definiti in compstui.h):

Identificatore Tipo di pagina
DP_STD_DOCPROPPAGE1 Pagina Nontreeview usata per la pagina Layout di un documento di stampa.
DP_STD_DOCPROPPAGE2 Pagina Nontreeview usata per la pagina Carta/Qualità di un documento di stampa.
DP_STD_TREEVIEWPAGE Pagina struttura ad albero generica.

Gli identificatori forniti da CPSUI fanno riferimento a modelli che possono visualizzare i tipi di opzioni CPSUI. Le dimensioni della pagina per tali modelli sono 252 per 216 unità di dialogo. Per altre informazioni, vedere Pagine e modelli forniti da CPSUI.

Questo membro non viene usato se DPF_USE_HDLGTEMPLATE è impostato in Flag.

DUMMYUNIONNAME.hDlgTemplate

Handle fornito dal chiamante a una struttura DLGTEMPLATE .

Usato solo se DPF_USE_HDLGTEMPLATE è impostato in Flag.

Commenti

CPSUI crea una pagina del foglio delle proprietà allocando una struttura PROPSHEETPAGE e passandola a CreatePropertySheetPage. Se il chiamante ha specificato un puntatore a tipo DLGPROC a una finestra di dialogo in DlgProc, questa procedura viene usata per gestire i messaggi della finestra della pagina. Se DlgProc è NULL, vengono usate le procedure della finestra di dialogo personalizzate di CPSUI.

Quando la procedura della finestra di dialogo puntata da DlgProc viene chiamata con un valore di messaggio di WM_INITDIALOG, riceve la struttura PROPSHEETPAGE come input e riceve anche una struttura PSPINFO .

Se una finestra di dialogo fornita dal chiamante gestisce un messaggio, deve restituire un valore diverso da zero. Se la funzione non gestisce il messaggio che deve restituire zero, che causa la gestione del messaggio da parte della CPSUI.

Requisiti

Requisito Valore
Intestazione compstui.h (include Compstui.h)