PROPSHEETPAGE
9/9/2008
Essa estrutura define uma página em um folha de propriedades.
Syntax
typedef struct _PROPSHEETPAGE {
DWORD dwSize;
DWORD dwFlags;
HINSTANCE hInstance;
union {
LPCSTR pszTemplate;
LPCDLGTEMPLATE pResource;
};
union {
HICON hIcon;
LPCSTR pszIcon;
};
LPCSTR pszTitle;
DLGPROC pfnDlgProc;
LPARAM lParam;
LPFNPSPCALLBACK pfnCallback;
UINT FAR* pcRefParent;
} PROPSHEETPAGE, FAR* LPPROPSHEETPAGE;
typedef const PROPSHEETPAGE FAR* LPCPROPSHEETPAGE;
Os membros
- dwSize
Especifica o tamanho, em bytes, da estrutura. O tamanho inclui qualquer adicional Application-defined dados no final de estrutura.
dwFlags
Especifica um máscara de bits de sinalizadores que opcional habilitar atributos de página de folha de propriedades e indicar o válido membros das PROPSHEETPAGE estrutura. Esse membro pode ser qualquer combinação dos seguinte valores.Valor Descrição PSP_DEFAULT
Usa o significado usar como padrão para todos os membros estrutura.
PSP_DLGINDIRECT
Cria a página de modelo caixa de diálogo na memória apontada pelo pResource membro. O Microsoft Win32® PropertySheet função supõe que o modelo está na memória gravável; Um modelo READ-ONLY irá causar uma exceção em algumas versões do Windows. Se este sinalizador não estiver definida, a página carregará o modelo caixa diálogo do recurso identificado pelo pszTemplate membro.
PSP_HASHELP
Permite que o botão ' ajuda ' folha de propriedades quando esta página está ativo.
PSP_USECALLBACK
Chama a função especificada pelo pfnCallback Quando criar ou destruir a página folha de propriedades definido por essa estrutura.
PSP_HICON
Não suportado.
PSP_PREMATURE
A página é criada quando o folha de propriedades é criado. Normalmente, a página não é criada até o primeiro tempo que ela estiver marcada.
PSP_USEICONID
Não suportado.
PSP__USEREFPARENT
Mantém o contagem de referência especificado por pcRefParent Para a tempo de vida da página folha de propriedades criada a partir essa estrutura.
PSP_USETITLE
Usa pszTitle Como o título da caixa de diálogo folha de propriedades instead of o título armazenado no modelo caixa de diálogo.
PSP_RTLREADING
Inverte a direção na qual pszTitle é exibida. Exibir janelas normal todo o texto, incluindo pszTitle, da esquerda - para - direito (EPD). Para os idiomas como árabe, hebraico ou que ler right-to-Left (RTL), uma janela pode ser espelhada e todo o texto será exibido RTL. Se PSP_RTLREADING for definido, pszTitle será, em vez disso, ler RTL em um janela pai normal e EPD em um janela pai espelhado.
- hInstance
Identificador para a instância a partir da qual carregar o modelo caixa diálogo, o ícone ou recurso seqüência de caracteres de título.
- pszTemplate
Esse parâmetro é ignorado. DLG_PROPSHEET é o identificador recurso usar como padrão para o modelo caixa diálogo usar para criar a página. Para ajustar o tamanho ou outros atributos de caixa de diálogo pai para o folha de propriedades, você pode editar o correspondente arquivo recurso (. res) para o tamanho desejado. O correspondente arquivo recurso pode ser encontrado em %_WINCEROOT%\PUBLIC\COMMON\OAK\LIB\ <BSPFamily> \RETAIL\ <LangID> \commctrlbase.res.
- pResource
Ponteiro para um modelo caixa diálogo na memória. O Win32 PropertySheet função supõe que o modelo está na memória gravável; Um modelo READ-ONLY irá causar uma exceção em algumas versões do Windows. Se dwFlags Não inclua o valor PSP_DLGINDIRECT, esse membro será ignorado.
- hIcon
Ignorado. Deve ser NULL.
- pszIcon
Ignorado. Deve ser NULL.
- pszTitle
Ponteiro para o seqüência de caracteres NULL-Terminated que contém o título da caixa de diálogo folha de propriedades. Esse título substitui o título especificado no modelo caixa de diálogo. Esse membro pode especificar ao identificador de um recurso seqüência de caracteres ou o ponteiro para uma seqüência de caracteres que especifica o título. Se dwFlags Não inclua o valor PSP_USETITLE, esse membro será ignorado.
- pfnDlgProc
Ponteiro para o procedimento caixa de diálogo para a página. O procedimento caixa de diálogo não deve chamar o Win32 EndDialog função.
- lParam
Application-defined dados.
- pfnCallback
Ponteiro para uma função callback Application-defined que é chamado quando a página é criada e quando ele está prestes a ser destruídos. Para obter mais informações sobre o função callback Win32, consulte PropSheetPageProc. Se dwFlags Não inclua o valor PSP_USECALLBACK, esse membro será ignorado.
- pcRefParent
Ponteiro para o valor contagem de referência. Se dwFlags Não inclua o valor PSP_USERREFPARENT, esse membro será ignorado.
Remarks
Quando o PropertySheet função cria a página, o procedimento caixa diálogo para a página recebe um WM_INITDIALOG mensagem. O lParam parâmetro desta mensagem aponta para a estrutura PROPSHEETPAGE usada para criar a página.
Requirements
Header | prsht.h |
Windows Embedded CE | Windows CE 1.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
CreatePropertySheetPage
EndDialog
PropertySheet
PropSheetPageProc
WM_INITDIALOG