PropertySheet
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
Essa função cria um folha de propriedades e adiciona as páginas definidas na estrutura de cabeçalho especificado folha de propriedades.
Syntax
int PropertySheet(
LPCPROPSHEETHEADER lppsph
);
Parameters
- lppsph
[no] Ponteiro longo para um PROPSHEETHEADER estrutura que define o quadro e páginas de um folha de propriedades.
Return Value
Um valor positivo indica sucesso. – 1 Indica falha.
Se a pasta dwFlags membro das PROPSHEETHEADER estrutura especifica o sinalizador PSH_MODELESS, bem-sucedido o valor de retorno é a manipulador de janela para o diálogo folha de propriedades.
Os valores de retorno descritos a seguinte tabela tem um significado especial.
| Valor | Descrição |
|---|---|
ID_PSREBOOTSYSTEM |
Uma página enviada a PSM_REBOOTSYSTEM mensagem para o folha de propriedades. O computador deve ser reiniciado para que alterações do usuário tenham efeito. |
ID_PSRESTARTWINDOWS |
Uma página enviada a PSM_RESTARTWINDOWS mensagem para o folha de propriedades. Windows deve ser reiniciado para que alterações do usuário tenham efeito. |
Para informações de erro estendidas get, chamar GetLastError.
Remarks
Por padrão, PropertySheet Cria um restrito diálogo. Se a pasta dwFlags membro das PROPSHEETHEADER estrutura especifica o sinalizador PSH_MODELESS, PropertySheet Cria uma sem janela restrita diálogo e retorna imediatamente após a criação de diálogo. Neste maiúsculas e minúsculas, o PropertySheet valor de retorno o manipulador de janela para a sem janela restrita é diálogo.
Para uma sem janela restrita folha de propriedades, executar um loop a mensagem deverá usar PSM_ISDIALOGMESSAGE Para transmitir mensagens para o diálogo folha de propriedades. O executar um loop mensagem deverá usar PSM_GETCURRENTPAGEHWND para determinar quando destruir o diálogo. Quando o usuário escolhe o OK Ou Cancelar botão, PSM_GETCURRENTPAGEHWND retorna NULL, e em seguida, você pode usar o DestroyWindow função para destruir caixa de diálogo.
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
DestroyWindow
CreatePropertySheetPage
DestroyPropertySheetPage
PSM_ISDIALOGMESSAGE
PSM_REBOOTSYSTEM
PSM_RESTARTWINDOWS
PSM_GETCURRENTPAGEHWND
PROPSHEETHEADER