Classe CPropertySheet

Artigo
06/10/2015

Representa as folhas de propriedade, também conhecido como caixas de diálogo de tabulação.

class CPropertySheet : public CWnd

Membros

Construtores public

Nome	Descrição
CPropertySheet::CPropertySheet	Constrói um objeto de CPropertySheet .

Métodos públicos

Nome	Descrição
CPropertySheet::AddPage	Adiciona uma página a folha de propriedades.
CPropertySheet::Construct	Constrói um objeto de CPropertySheet .
CPropertySheet::Create	Exibe uma folha de propriedades sem janela restrita.
CPropertySheet::DoModal	Exibe uma folha de propriedades modal.
CPropertySheet::EnableStackedTabs	Indica se a folha de propriedades usa guias empilhado ou de rolagem.
CPropertySheet::EndDialog	Finaliza a folha de propriedades.
CPropertySheet::GetActiveIndex	Retorna o índice da página ativo da folha de propriedades.
CPropertySheet::GetActivePage	Retorna o objeto de página.
CPropertySheet::GetPage	Recupera um ponteiro para a página especificada.
CPropertySheet::GetPageCount	Retorna o número de páginas na folha de propriedades.
CPropertySheet::GetPageIndex	Retorna o índice da página especificada da folha de propriedades.
CPropertySheet::GetTabControl	Recupera um ponteiro para um controle de guia.
CPropertySheet::MapDialogRect	Converte as unidades de diálogo de um retângulo para selecionar unidades.
CPropertySheet::OnInitDialog	Substituição para aumentar a inicialização da folha de propriedades.
CPropertySheet::PressButton	Simula a escolha do botão especificado em uma folha de propriedades.
CPropertySheet::RemovePage	Remove uma página da folha de propriedades.
CPropertySheet::SetActivePage	Defina programaticamente o objeto da página.
CPropertySheet::SetFinishText	Define o texto do botão de suporte.
CPropertySheet::SetTitle	Define a legenda da folha de propriedades.
CPropertySheet::SetWizardButtons	Permite que os botões do assistente.
CPropertySheet::SetWizardMode	Ativar o modo do assistente.

Membros públicos de dados

Nome	Descrição
CPropertySheet::m_psh	A estrutura de PROPSHEETHEADER do windows. Fornece acesso aos parâmetros básicos da folha de propriedades.

Comentários

Uma folha de propriedades consiste em um objeto de CPropertySheet e em um ou mais objetos de CPropertyPage . A estrutura exibe uma folha de propriedades como uma janela com um conjunto de índices da guia e uma área que contém a página selecionada. O usuário navegar para uma página específica usando a guia apropriada.

CPropertySheet fornece suporte para a estrutura expandida de PROPSHEETHEADER introduzida em Windows 98 e no Windows NT 2000. A estrutura contém os sinalizadores e membros adicionais que suportam usando um bitmap de plano de fundo do “marca de agua”.

Para exibir novos automaticamente essas imagens no seu objeto da folha de propriedades, passe valores válidos para o bitmap e a paleta imagens na chamada a CPropertySheet::Construct ou a CPropertySheet::CPropertySheet.

Mesmo que CPropertySheet não é derivado de CDialog, gerenciar um objeto de CPropertySheet é como gerenciar um objeto de CDialog . Por exemplo, a criação de uma folha de propriedades requer a compilação duas partes: o construtor, e então chame 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 e CPropertySheet::CPropertySheet.

Quando você constrói um objeto de CPropertySheet , qualquer Estilos de janela pode fazer com que uma exceção de primeira tentativa ocorra. Isso resulta do sistema que tenta alterar o estilo de folha propriedade antes da folha ser criada. Para evitar essa exceção, certifique-se de definir os seguintes estilos quando você cria seu CPropertySheet:

DS_3DLOOK
DS_CONTROL
WS_CHILD
WS_TABSTOP

Os seguintes estilos são opcionais, e não fará com que a exceção de primeira tentativa:

DS_SHELLFONT
DS_LOCALEDIT
WS_CLIPCHILDREN

Qualquer outro Window Styles é proibido e você não deve permite que eles.

Os trocar dados entre um objeto de CPropertySheet e um objeto externo são semelhantes para trocar dados com um objeto de CDialog . A diferença importante é que as configurações de uma folha de propriedades são normalmente variáveis de membro de objetos de CPropertyPage em vez do próprio objeto de CPropertySheet .

Você pode criar um tipo de caixa de diálogo de guia chamado um assistente, que consiste em uma folha de propriedades com uma seqüência de páginas de propriedades que guiam o usuário através das etapas de uma operação, como configurar um dispositivo ou a criação de um boletim de notícias. Em uma caixa de diálogo de guia de uma tipo, as páginas de propriedades não têm guias, e apenas uma página de propriedades é visível em vez. Além de isso, em vez de ter OK e botões de Aplicar agora , uma caixa de diálogo de guia de uma tipo tem um botão de Voltar , um botão de Avançar ou de Concluir , um botão de Cancelar , e um botão de Ajuda .

Para criar um caixa de diálogo de uma tipo, siga as mesmas etapas que você seguiria para criar um folha de propriedades padrão, mas a chamada SetWizardMode antes de chamar DoModal. Para ativar os botões do assistente, chame SetWizardButtons, usando os sinalizadores para personalizar suas função e aparência. Para ativar o botão de Concluir , chamada SetFinishText após o usuário tem a ação colocada na última página do assistente.

Para obter mais informações sobre como usar objetos de CPropertySheet , consulte o artigo folhas e páginas de propriedades de propriedade. Além de isso, consulte o artigo de Base de Dados de Conhecimento Q146916: HOWTO: Crie um CPropertySheet sem-modo com os botões padrão e o artigo Q300606: HOWTO: Criar uma folha de propriedades redimensionável MFC.