Estrutura DLGPAGE (compstui.h)

A estrutura de DLGPAGE é usada para especificar uma página de folha de propriedades para a função de comPropSheet do CPSUI. O endereço da estrutura é incluído em uma estrutura deCOMPROPSHEETUIe 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 de DLGPAGE.

Flags

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

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

Opcional, fornecido pelo chamador DLGPROCponteiro tipado para um procedimento de caixa de diálogo, usado para processar mensagens enviadas pelo sistema quando ocorrem eventos do usuário. Se 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 por NULL a ser exibida na guia 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 fornecidos por CPSUI, com prefixo IDI_CPSUI.

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

O ícone especificado é exibido na guia 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 de DIÁLOGO 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 nontreeview, usada para a página Layout de um documento de impressão.
DP_STD_DOCPROPPAGE2	Página nontreeview, usada para a página Paper/Quality 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 CPSUI-Supplied páginas e modelos.

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

DUMMYUNIONNAME.hDlgTemplate

Identificador fornecido pelo chamador para uma estrutura deDLGTEMPLATE.

Usado somente se DPF_USE_HDLGTEMPLATE estiver definido no sinalizadores de.

Observações

O 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 no DlgProc, esse procedimento será usado para lidar com as mensagens da janela da página. Se DlgProc for NULL, os procedimentos da caixa de diálogo do PRÓPRIO 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 dePSPINFO.

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 faz com que o CPSUI manipule a mensagem.

Requisitos

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