Classe CPropertySheet
Representa propriedade folhas, também conhecido sistema autônomo caixas de diálogo do guia.
class CPropertySheet : public CWnd
Comentários
A folha de propriedades consiste em um CPropertySheet objeto e um ou mais CPropertyPage objetos.Exibe a estrutura de um folha de propriedades sistema autônomo uma janela com um conjunto de índices de guia e uma área que contém a página atualmente selecionada.O usuário navega para uma página específica, usando a guia apropriada.
CPropertySheet Fornece suporte para o expandido PROPSHEETHEADER estrutura introduzida no Windows 98 e Windows NT 2000. A estrutura contém sinalizadores adicionais e membros que suporta o uso de um bitmap de plano de fundo "marca-d'água".
Para exibir essas novas imagens automaticamente em seu objeto de folha de propriedades, passar os valores válido para as imagens de bitmap e paleta na telefonar para CPropertySheet::Construct or CPropertySheet::CPropertySheet.
Embora CPropertySheet não é derivado de CDialog, gerenciando um CPropertySheet objeto é como gerenciar um CDialog objeto. Por exemplo, criação de um folha de propriedades requer construção de duas partes: telefonar construtor e, em seguida, telefonar DoModal para uma folha de propriedades modal ou Criar para uma folha de propriedades sem janela restrita.CPropertySheet tem dois tipos de construtores: CPropertySheet::Construct and CPropertySheet::CPropertySheet.
Quando você construir um CPropertySheet o objeto, alguns Estilos de janela pode gerar uma exceção de primeira chance ocorrer. Isso resultados de sistema tentar alterar o estilo da folha de propriedades antes que a planilha seja criada.Para evitar essa exceção, certifique-se de conjunto os seguintes estilos quando você cria seu CPropertySheet:
DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP
Os estilos a seguir são opcionais e não causará a exceção de primeira chance:
DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN
Outros Window Styles são proibidos e não deve ativá-los.
Troca de dados entre um CPropertySheet objeto e um objeto externo é semelhante ao trocar dados com um CDialog objeto. A diferença importante é que as configurações de um folha de propriedades normalmente são variáveis de membro do CPropertyPage objetos em vez da CPropertySheet objeto propriamente dito.
Você pode criar um tipo de caixa de diálogo guia chamada um assistente, que consiste em um folha de propriedades com uma sequência de páginas de propriedades que orientam o usuário pelas etapas de uma operação, sistema autônomo configuração de um dispositivo ou criando um boletim informativo.Em uma caixa de diálogo de tipo de assistente guia as páginas de propriedade não tem as guias e página apenas uma propriedade é visível ao mesmo time.Além disso, em vez de ter OK and Aplicar agora botões, uma caixa de diálogo tipo de assistente guia tiver um Fazer backup button, a Próximo or Concluir button, a Cancelar botão e um Ajuda botão.
Para criar uma caixa de diálogo tipo de assistente, siga as mesmas etapas que você deve seguir para criar uma folha de propriedades padrão, mas telefonar SetWizardMode antes de você telefonar DoModal.Para ativar os botões de assistente telefonar SetWizardButtons, usando sinalizadores para personalizar sua função e a aparência.Para habilitar o Concluir telefonar botãoSetFinishText depois que o usuário executou a ação na última página do assistente.
Para obter mais informações sobre como usar CPropertySheet objetos, consulte o artigo Folhas de propriedade e páginas de propriedades.Além disso, consulte o artigo da Base de dados de Conhecimento Q146916: HOWTO: Criar um CPropertySheet sem janela restrita com botões padrão e Q300606 do artigo: HOWTO: Crie uma folha de propriedades de redimensionamento MFC.
Requisitos
Cabeçalho: afxdlgs.h
Anotações Developer Dispositivo Inteligente
Não tem suporte para projetos Smartphone.
Consulte também
Tarefas
Exemplo de CMNCTRL1: Demonstra a classes do MFC de Controlarar ComComumComum, parte 1
Exemplo de CMNCTRL2: Demonstra a classes do MFC de Controlarar ComComumComum, parte 2
Exemplo PROPDLG: Demonstra o suporte de folha de propriedades
Exemplo SNAPVW: Usa páginas de propriedades em um aplicativo de Exibir de Formulário