estrutura PROPSHEETHEADERA_V2 (prsht.h)

Define o quadro e as páginas de uma folha de propriedades.

Observação

Essa estrutura não se destina a ser usada diretamente em seu código. Em vez disso, use a estrutura PROPSHEETHEADER .

Sintaxe

typedef struct _PROPSHEETHEADERA_V2 {
  union {
    HBITMAP hbmWatermark;
    LPCSTR  pszbmWatermark;
  } DUMMYUNIONNAME4;
  HPALETTE hplWatermark;
  union {
    HBITMAP hbmHeader;
    LPCSTR  pszbmHeader;
  } DUMMYUNIONNAME5;
} PROPSHEETHEADERA_V2, *LPPROPSHEETHEADERA_V2;

Membros

DUMMYUNIONNAME4

DUMMYUNIONNAME4.hbmWatermark

Tipo: HBITMAP

Versão 5.80 ou posterior. Manipule para o bitmap de marca d'água. Se o membro dwFlags não incluir PSH_USEHBMWATERMARK, esse membro será ignorado.

DUMMYUNIONNAME4.pszbmWatermark

Tipo: LPCTSTR

Versão 5.80 ou posterior. Recurso de bitmap a ser usado como marca d'água. Esse membro pode especificar o identificador do recurso bitmap ou o endereço da cadeia de caracteres que especifica o nome do recurso bitmap. Se o membro dwFlags incluir PSH_USEHBMWATERMARK, esse membro será ignorado.

hplWatermark

Tipo: HPALETTE

Versão 5.80 ou posterior. Estrutura HPALETTE usada para desenhar o bitmap de marca d'água e/ou bitmap de cabeçalho. Se o membro dwFlags não incluir PSH_USEHPLWATERMARK, esse membro será ignorado.

DUMMYUNIONNAME5

DUMMYUNIONNAME5.hbmHeader

Tipo: HBITMAP

Versão 5.80 ou posterior. Manipule para o bitmap de cabeçalho. Se o membro dwFlags não incluir PSH_USEHBMHEADER, esse membro será ignorado.

DUMMYUNIONNAME5.pszbmHeader

Tipo: LPCSTR

Versão 5.80 ou posterior. Recurso de bitmap a ser usado como cabeçalho. Esse membro pode especificar o identificador do recurso bitmap ou o endereço da cadeia de caracteres que especifica o nome do recurso bitmap. Se o membro dwFlags incluir PSH_USEHBMHEADER, esse membro será ignorado.

Comentários

Se o usuário escolher uma configuração como Fontes Grandes, que amplia a caixa de diálogo, a marca d'água pintada nas páginas de início e término também será ampliada. O tamanho e a posição do bitmap original permanecerão os mesmos. A área adicional será preenchida com a cor do pixel no canto superior esquerdo do bitmap.

Observe que vários membros dessa estrutura só têm suporte para Comctl32.dll versões 4.71 e posteriores. Você pode habilitar esses membros incluindo um dos seguintes em seu cabeçalho.

#define _WIN32_IE 0x0400 // For version 4.71

ou

#define _WIN32_IE 0x0500 // For version 5.80

No entanto, você deve inicializar a estrutura com seu tamanho. Se você usar o tamanho da estrutura definida no momento, o aplicativo poderá não ser executado com as versões anteriores do Comctl32.dll, que esperam uma estrutura menor. Isso inclui todos os sistemas com o Windows 95 ou o Microsoft Windows NT 4.0 que não têm a Internet Explorer 4.0 ou posterior instalada. Você pode executar seu aplicativo em versões anteriores à 4.71 do Comctl32.dll definindo o número de versão apropriado. No entanto, isso poderá causar problemas se seu aplicativo também precisar ser executado em sistemas com versões mais recentes.

Você pode permanecer compatível com todas as versões Comctl32.dll usando os arquivos de cabeçalho atuais e definindo o tamanho da estrutura PROPSHEETHEADER adequadamente. Antes de inicializar a estrutura, use a função DllGetVersion para determinar qual Comctl32.dll versão está instalada no sistema. Se for a versão 4.71 ou superior, use

psh.dwSize = sizeof(PROPSHEETHEADER);

para inicializar o membro dwSize . Para versões anteriores, o tamanho da estrutura pré-4.71 é dado pela constante PROPSHEETHEADER_V1_SIZE. Uso

psh.dwSize = PROPSHEETHEADER_V1_SIZE;

Os estilos PSH_WIZARD, PSH_WIZARD97 e PSH_WIZARD_LITE são mutuamente incompatíveis. Apenas um desses sinalizadores de estilo deve ser definido. PSH_AEROWIZARD deve ser combinado com PSH_WIZARD.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	prsht.h