Estrutura PROPSHEETPAGE

Define uma página em uma folha de propriedades.

Sintaxe

typedef struct {
    DWORD      dwSize;
    DWORD      dwFlags;
    HINSTANCE  hInstance;
    union {
        LPCSTR                 pszTemplate;
        PROPSHEETPAGE_RESOURCE pResource;
    };
    union {
        HICON  hIcon;
        LPCSTR pszIcon;
    };
    LPCSTR          pszTitle;
    DLGPROC         pfnDlgProc;
    LPARAM          lParam;
    LPFNPSPCALLBACK pfnCallback;
    UINT            *pcRefParent;
    LPCTSTR         pszHeaderTitle;
    LPCTSTR         pszHeaderSubTitle;
    HANDLE          hActCtx;
    union 
    {
        HBITMAP     hbmHeader;
        LPCSTR      pszbmHeader;
    }
} PROPSHEETPAGE, *LPPROPSHEETPAGE;

Membros

dwSize

Tipo: DWORD

Tamanho, em bytes, dessa estrutura.

dwFlags

Tipo: DWORD

Sinalizadores que indicam quais opções usar ao criar a página da folha de propriedades. Esse membro pode ser uma combinação dos valores a seguir.

Valor Significado
PSP_DEFAULT Usa o significado padrão para todos os membros da estrutura. Não há suporte para esse sinalizador ao usar o assistente de estilo Aero (PSH_AEROWIZARD).
PSP_DLGINDIRECT Cria a página do modelo da caixa de diálogo na memória apontada pelo membro pResource . A função PropertySheet pressupõe que o modelo que está na memória não esteja protegido por gravação. Um modelo somente leitura causará uma exceção em algumas versões do Windows.
PSP_HASHELP Habilita o botão Ajuda da folha de propriedades quando a página está ativa. Não há suporte para esse sinalizador ao usar o assistente de estilo Aero (PSH_AEROWIZARD).
PSP_HIDEHEADER Versão 5.80 e posterior. Faz com que a folha de propriedades do assistente oculte a área de cabeçalho quando a página é selecionada. Se uma marca d'água tiver sido fornecida, ela será pintada no lado esquerdo da página. Esse sinalizador deve ser definido para páginas de boas-vindas e de conclusão e omitido para páginas internas. Não há suporte para esse sinalizador ao usar o assistente de estilo Aero (PSH_AEROWIZARD).
PSP_PREMATURE Versão 4.71 ou posterior. Faz com que a página seja criada quando a folha de propriedades é criada. Se esse sinalizador não for especificado, a página não será criada até que seja selecionada pela primeira vez. Não há suporte para esse sinalizador ao usar o assistente de estilo Aero (PSH_AEROWIZARD).
PSP_RTLREADING Inverte a direção na qual pszTitle é exibido. Janelas normais exibem todo o texto, incluindo pszTitle, LTR (esquerda para direita). Para idiomas como hebraico ou árabe que leem da direita para a esquerda (RTL), uma janela pode ser espelhada e todo o texto será exibido RTL. Se PSP_RTLREADING estiver definido, pszTitle lerá RTL em uma janela pai normal e LTR em uma janela pai espelhada.
PSP_USECALLBACK Chama a função especificada pelo membro pfnCallback ao criar ou destruir a página da folha de propriedades definida por essa estrutura.
PSP_USEFUSIONCONTEXT Versão 6.0 e posterior. Use um contexto de ativação. Para usar um contexto de ativação, você deve definir esse sinalizador e atribuir o identificador de contexto de ativação ao hActCtx. Confira os Comentários.
PSP_USEHEADERSUBTITLE Versão 5.80 ou posterior. Exibe a cadeia de caracteres apontada pelo membro pszHeaderSubTitle como o subtítulo da área de cabeçalho de uma página do Wizard97. Para usar esse sinalizador, você também deve definir o sinalizador PSH_WIZARD97 no membro dwFlags da estrutura PROPSHEETHEADER associada. O sinalizador PSP_USEHEADERSUBTITLE será ignorado se PSP_HIDEHEADER estiver definido. Em assistentes de estilo aero, o título aparece próximo à parte superior da área do cliente.
PSP_USEHEADERTITLE Versão 5.80 ou posterior. Exibe a cadeia de caracteres apontada pelo membro pszHeaderTitle como o título no cabeçalho de uma página interior do Wizard97. Você também deve definir o sinalizador PSH_WIZARD97 no membro dwFlags da estrutura PROPSHEETHEADER associada. O sinalizador PSP_USEHEADERTITLE será ignorado se PSP_HIDEHEADER estiver definido. Não há suporte para esse sinalizador ao usar o assistente de estilo Aero (PSH_AEROWIZARD).
PSP_USEHICON Usa hIcon como o ícone pequeno na guia da página. Não há suporte para esse sinalizador ao usar o assistente de estilo Aero (PSH_AEROWIZARD).
PSP_USEICONID Usa pszIcon como o nome do recurso de ícone para carregar e usar como o pequeno ícone na guia da página. Não há suporte para esse sinalizador ao usar o assistente de estilo Aero (PSH_AEROWIZARD).
PSP_USEREFPARENT Mantém a contagem de referência especificada pelo membro pcRefParent para o tempo de vida da página da folha de propriedades criada a partir dessa estrutura.
PSP_USETITLE Usa o membro pszTitle como o título da caixa de diálogo da folha de propriedades em vez do título armazenado no modelo da caixa de diálogo. Não há suporte para esse sinalizador ao usar o assistente de estilo Aero (PSH_AEROWIZARD).

hInstance

Tipo: HINSTANCE

Manipule para a instância da qual carregar um ícone ou recurso de cadeia de caracteres. Se o membro pszIcon, pszTitle, pszHeaderTitle ou pszHeaderSubTitle identificar um recurso a ser carregado, hInstance deverá ser especificado.

pszTemplate

Tipo: LPCSTR

Modelo de caixa de diálogo a ser usado para criar a página. Esse membro pode especificar o identificador de recurso do modelo ou o endereço de uma cadeia de caracteres que especifica o nome do modelo. Se o sinalizador PSP_DLGINDIRECT no membro dwFlags estiver definido, pszTemplate será ignorado. Esse membro é declarado como uma união com pResource.

pResource

Tipo: LPCDLGTEMPLATE

Ponteiro para um modelo de caixa de diálogo na memória. A função PropertySheet pressupõe que o modelo não esteja protegido por gravação. Um modelo somente leitura causará uma exceção em algumas versões do Windows. Para usar esse membro, você deve definir o sinalizador PSP_DLGINDIRECT no membro dwFlags . Esse membro é declarado como uma união com pszTemplate.

hIcon

Tipo: HICON

Manipule para o ícone a ser usado como o ícone na guia da página. Se o membro dwFlags não incluir PSP_USEHICON, esse membro será ignorado. Esse membro é declarado como uma união com pszIcon.

pszIcon

Tipo: LPCSTR

Recurso de ícone a ser usado como o ícone na guia da página. Esse membro pode especificar o identificador do recurso de ícone ou o endereço da cadeia de caracteres que especifica o nome do recurso de ícone. Para usar esse membro, você deve definir o sinalizador PSP_USEICONID no membro dwFlags . Esse membro é declarado como uma união com hIcon.

Psztitle

Tipo: LPCSTR

Título da caixa de diálogo da folha de propriedades. Esse título substitui o título especificado no modelo da caixa de diálogo. Esse membro pode especificar o identificador de um recurso de cadeia de caracteres ou o endereço de uma cadeia de caracteres que especifica o título. Para usar esse membro, você deve definir o sinalizador PSP_USETITLE no membro dwFlags .

pfnDlgProc

Tipo: DLGPROC

Ponteiro para o procedimento da caixa de diálogo da página. Como as páginas são criadas como caixas de diálogo sem formação, o procedimento da caixa de diálogo não deve chamar a função EndDialog .

lParam

Tipo: LPARAM

Quando a página é criada, uma cópia da estrutura PROPSHEETPAGE da página é passada para o procedimento da caixa de diálogo com uma mensagem WM_INITDIALOG . O membro lParam é fornecido para permitir que você passe informações específicas do aplicativo para o procedimento da caixa de diálogo. Ele não tem nenhum efeito na própria página.

Pfncallback

Tipo: LPFNPSPCALLBACK

Ponteiro para uma função de retorno de chamada definida pelo aplicativo que é chamada quando a página é criada e quando ela está prestes a ser destruída. Para obter mais informações sobre a função de retorno de chamada, consulte Função de retorno de chamada LPFNPSPCALLBACKA. Para usar esse membro, você deve definir o sinalizador PSP_USECALLBACK no membro dwFlags .

pcRefParent

Tipo: UINT*

Ponteiro para o valor da contagem de referência. Para usar esse membro, você deve definir o sinalizador PSP_USEREFPARENT no membro dwFlags .

Observação

Quando uma página de folha de propriedades é criada, o valor apontado por pcRefParent é incrementado. Você cria uma página de folha de propriedades implicitamente definindo o sinalizador PSH_PROPSHEETPAGE no membro dwFlags de PROPSHEETHEADER e chamando a função PropertySheet . Você pode fazer isso explicitamente usando a função CreatePropertySheetPage . Quando uma página de folha de propriedades é destruída, o valor apontado pelo membro pcRefParent é decrementado. Isso ocorre automaticamente quando a folha de propriedades é destruída. Você pode destruir explicitamente uma página de folha de propriedades usando a função DestroyPropertySheetPage .

pszHeaderTitle

Tipo: LPCTSTR

Versão 5.80 ou posterior. Título da área de cabeçalho. Para usar esse membro no assistente de estilo Wizard97, você também deve fazer o seguinte:

  • Defina o sinalizador PSP_USEHEADERTITLE no membro dwFlags .
  • Defina o sinalizador PSH_WIZARD97 no membro dwFlags da estrutura PROPSHEETHEADER da página.
  • Verifique se o sinalizador PSP_HIDEHEADER no membro dwFlags não está definido.

pszHeaderSubTitle

Tipo: LPCTSTR

Versão 5.80 ou posterior. Subtítulo da área de cabeçalho. Para usar esse membro, você deve fazer o seguinte:

  • Defina o sinalizador PSP_USEHEADERSUBTITLE no membro dwFlags .
  • Defina o sinalizador PSH_WIZARD97 no membro dwFlags da estrutura PROPSHEETHEADER da página.
  • Verifique se o sinalizador PSP_HIDEHEADER no membro dwFlags não está definido.

Observação

Esse membro é ignorado ao usar o assistente de estilo Aero (PSH_AEROWIZARD)

hActCtx

Tipo: HANDLE

Versão 6.0 ou posterior. Um identificador de contexto de ativação. Defina esse membro como o identificador que é retornado quando você cria o contexto de ativação com CreateActCtx. O sistema ativará esse contexto antes de criar a caixa de diálogo. Você não precisará usar esse membro se usar um manifesto global.

hbmHeader

Tipo: HBITMAP

Esse membro é declarado como uma união com pszbmHeader.

pszbmHeader

Tipo: LPCSTR

Esse membro é declarado como uma união com hbmHeader.

Comentários

Comctl32.dll versão 6 e posteriores não são redistribuíveis. Para usar Comctl32.dll versão 6 ou posterior, especifique o arquivo .dll em um manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito Valor
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
Nomes Unicode e ANSI PROPSHEETHEADERW (Unicode) e PROPSHEETHEADERA (ANSI)