Partilhar via


Usando folhas de propriedades em seu aplicativo

Para usar uma folha de propriedades em seu aplicativo, conclua as seguintes etapas:

  1. Crie um recurso de modelo de diálogo para cada página de propriedade.Tenha em mente que o usuário pode ser alternar de uma página para outro, portanto, dispor de cada página mais consistente possível.

    Os modelos de caixa de diálogo para todas as páginas não tem o mesmo tamanho.A estrutura usa o tamanho de página maior para determinar quanto espaço alocar na folha de propriedades para as páginas de propriedade.

    Quando você cria o recurso de modelo de diálogo para uma página de propriedades, você deve especificar os seguintes estilos na folha de propriedades de caixa de diálogo Propriedades:

    • Definir o legenda caixa de edição de Geral página do texto que você deseja aparecem na guia para esta página.

    • Definir o estilo caixa de listagem de estilos página filho.

    • Definir o borda caixa de listagem de estilos página fina.

    • Garantir que o Titlebar caixa de seleção de estilos página está selecionada.

    • Garantir que o desativado caixa de seleção de Mais estilos página está selecionada.

  2. Criar um CPropertyPage-correspondente para cada modelo de caixa de diálogo Propriedades de classe derivada.Consulte Adicionar uma classe de.Escolha CPropertyPage como a classe base.

  3. Crie variáveis para armazenar valores para esta página de propriedade de membro.O processo para adicionar variáveis de membro para uma página de propriedades é exatamente a mesma adicionando variáveis de membro para uma caixa de diálogo, porque uma página de propriedades é uma caixa de diálogo especializados.Para obter mais informações, consulte Definir variáveis de membro para controles de caixa de diálogo.

  4. Construir um CPropertySheet o objeto no seu código fonte.Normalmente, você constrói a CPropertySheet objeto no manipulador para o comando que exibe a folha de propriedades.Este objeto representa a folha inteira.Se você criar uma folha de propriedades restrita com o DoModal função, o framework fornece três botões de comando, por padrão: OK, Cancelar e aplicar.O framework não cria nenhum botão de comando para planilhas de propriedade sem janela restrita criado com o criar função.Você não precisa derivar uma classe de CPropertySheet a menos que queira adicionar outros controles (como uma janela de visualização) ou exibir uma folha de propriedades sem janela restrita.Essa etapa é necessária para planilhas de propriedade sem janela restrita porque eles não contêm quaisquer controles padrão que podem ser usadas para fechar a folha de propriedades.

  5. Para cada página a ser adicionado à folha de propriedades, faça o seguinte:

    • Construir um objeto para cada CPropertyPage-derivada da classe que você criou anteriormente esse processo.

    • Chamar CPropertySheet::AddPage para cada página.

    Normalmente, o objeto que cria o CPropertySheet também cria o CPropertyPage objetos nesta etapa.No entanto, se você implementar um CPropertySheet-derivada da classe, você pode incorporar o CPropertyPage objetos na CPropertySheet objeto e chamada AddPage para cada página do CPropertySheet-derivado construtor da classe.AddPageAdiciona o CPropertyPage o objeto para a lista da folha de propriedades de páginas, mas na verdade não criar a janela da página.Portanto, não é necessário esperar até a criação da janela de folha de propriedade para chamar AddPage; Você pode chamar AddPage de construtor da folha de propriedades.

    Por padrão, se uma folha de propriedades possui mais guias que cabem em uma única linha da folha de propriedades, as guias se empilharão em várias linhas.Para desativar o empilhamento, chame CPropertySheet::EnableStackedTabs com o parâmetro definido FALSE.Você deve chamar EnableStackedTabs ao criar a folha de propriedades.

  6. Chamar CPropertySheet::DoModal ou criar para exibir a folha de propriedades.Chamar DoModal para criar uma folha de propriedades como uma caixa de diálogo modal.Chamar criar para criar a folha de propriedades como uma caixa de diálogo sem janela restrita.

  7. Trocar dados entre páginas de propriedade e o proprietário da folha de propriedades.Isso é explicado no artigo Trocando dados.

Para obter um exemplo de como usar folhas de propriedades, consulte MFC geral exemplo PROPDLG.

Consulte também

Conceitos

Folhas de propriedade (MFC)