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.

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 .

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.

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