Estrutura DLGPAGE (compstui.h)

A estrutura DLGPAGE é usada para especificar uma página de folha de propriedades para a função ComPropSheet do CPSUI. O endereço da estrutura está incluído em uma estrutura COMPROPSHEETUI e todos os valores de membro são fornecidos pelo chamador ComPropSheet .

Sintaxe

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

Membros

cbSize

Tamanho fornecido pelo chamador, em bytes, da estrutura DLGPAGE .

Flags

Sinalizadores de bits fornecidos pelo chamador, conforme descrito na tabela a seguir.

Sinalizador	Definição
DPF_ICONID_AS_HICON	Se definido, IconID conterá um identificador de ícone. Se não estiver definido, IconID conterá um identificador de recurso de ícone.
DPF_USE_HDLGTEMPLATE	Se definido, hDlgTemplate conterá um identificador de modelo. Se não for definido, DlgTemplateID conterá um identificador de recurso de modelo.

Opcional, ponteiro do tipo DLGPROC fornecido pelo chamador para um procedimento de caixa de diálogo, usado para processar mensagens enviadas pelo sistema quando ocorrem eventos do usuário. Se FOR NULL, o CPSUI fornecerá um procedimento de caixa de diálogo. Para obter mais informações, consulte a seção Comentários abaixo.

DlgProc

Define o membro DLGPROCDlgProc.

pTabName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres terminada em NULL a ser exibida na guia da página.

IconID

Fornecido pelo chamador, pode ser um dos seguintes:

• Um identificador de recurso de ícone. Isso pode ser definido pelo aplicativo ou pode ser um dos identificadores de recurso de ícone com prefixo IDI_CPSUI fornecidos por CPSUI.

• Um identificador de ícone. Se um identificador for especificado, DPF_ICONID_AS_HICON deverá ser definido no membro Flags .

O ícone especificado é exibido na guia da página. Se esse valor for zero, um ícone não será exibido.

DUMMYUNIONNAME

Define a união DUMMYUNIONNAME .

DUMMYUNIONNAME.DlgTemplateID

Identificador de recurso fornecido pelo chamador para um modelo de caixa de diálogo. Isso pode se referir a um recurso DIALOG fornecido pelo aplicativo ou pode ser um dos seguintes identificadores fornecidos por CPSUI (definidos em compstui.h):

Identificador	Tipo de página
DP_STD_DOCPROPPAGE1	Página nãotreeview, usada para a página Layout de um documento de impressão.
DP_STD_DOCPROPPAGE2	Página nãotreeview, usada para a página Papel/Qualidade de um documento de impressão.
DP_STD_TREEVIEWPAGE	Página de visão de árvore genérica.

Os identificadores fornecidos por CPSUI referem-se a modelos que podem exibir tipos de opção CPSUI. O tamanho da página desses modelos é de 252 por 216 unidades de caixa de diálogo. Para obter mais informações, consulte Páginas e modelos fornecidos por CPSUI.

Esse membro não será usado se DPF_USE_HDLGTEMPLATE estiver definido em Sinalizadores.

DUMMYUNIONNAME.hDlgTemplate

Identificador fornecido pelo chamador para uma estrutura DLGTEMPLATE .

Usado somente se DPF_USE_HDLGTEMPLATE estiver definido em Sinalizadores.

Comentários

CPSUI cria uma página de folha de propriedades alocando uma estrutura PROPSHEETPAGE e passando-a para CreatePropertySheetPage. Se o chamador tiver especificado um ponteiro do tipo DLGPROC para um procedimento de caixa de diálogo em DlgProc, esse procedimento será usado para lidar com as mensagens de janela da página. Se DlgProc for NULL, os procedimentos da própria caixa de diálogo do CPSUI serão usados.

Quando o procedimento da caixa de diálogo apontado por DlgProc é chamado com um valor de mensagem de WM_INITDIALOG, ele recebe a estrutura PROPSHEETPAGE como entrada e também recebe uma estrutura PSPINFO .

Se um procedimento de caixa de diálogo fornecido pelo chamador manipular uma mensagem, ele deverá retornar um valor diferente de zero. Se a função não manipular a mensagem, ela deverá retornar zero, o que fará com que o CPSUI manipule a mensagem.

Requisitos

Requisito	Valor
Cabeçalho	compstui.h (inclua Compstui.h)