Os controles ActiveX MFC: propriedade Páginas

propriedade páginas permitir que um usuário de controle ActiveX exibir e alterar as propriedades do controle ActiveX.Essas propriedades são acessadas, chamando uma caixa de diálogo de propriedades de controle, que contém um ou mais páginas de propriedades que fornecem uma interface gráfica personalizada para exibir e editar as propriedades do controle.

Controle ActiveX propriedade páginas são exibidas de duas maneiras:

• Quando verbo de propriedades do controle (OLEIVERB_PROPERTIES) é chamado, o controle abre uma janela restrita propriedade caixa de diálogo que contém o controle propriedade páginas.

• O contêiner pode exibir sua própria caixa de diálogo sem janela restrita que mostre o propriedade páginas do controle selecionado.

A caixa de diálogo de propriedades (ilustrada na figura a seguir) consiste em uma área para exibir a página corrente da propriedade, guias para alternar entre páginas de propriedades e um conjunto de botões que executam tarefas comuns, sistema autônomo fechar a caixa de diálogo de página de propriedades, cancelar sistema autônomo alterações feitas, ou aplicar imediatamente sistema autônomo alterações no controle ActiveX.

Caixa de diálogo de propriedades

Este artigo aborda tópicos relacionados ao uso propriedade páginas em um controle ActiveX.Eles incluem:

• Implementando o padrão página de propriedades para um controle ActiveX

• Adicionando controles para uma propriedade página

• Personalizando a função DoDataExchange

Para obter mais informações sobre como usar propriedade páginas em um controle ActiveX, consulte os seguintes artigos:

• Os controles ActiveX MFC: Adicionando outra personalizada página de propriedades

• Os controles ActiveX MFC: Usando as ações propriedade páginas

Para obter informações sobre como usar propriedade planilhas em um aplicativo MFC diferente de um controle ActiveX, consulte Folhas de propriedade (MFC).

Implementando a página de propriedades padrão

Se você usar o Assistente de controle ActiveX para criar seu projeto de controle, o Assistente para controle de ActiveX fornece uma classe de página de propriedades padrão para o controle derivado de Classe COlePropertyPage. Inicialmente, isso página de propriedades fica em branco, mas você pode adicionar qualquer controle de caixa de diálogo ou conjunto de controles a ela.Porque controle ActiveX cria apenas uma propriedade classe de página por padrão, classes de página de propriedades adicionais (também derivadas de COlePropertyPage) deve ser criado usando o modo de exibição de classe. Para obter mais informações sobre esse procedimento, consulte Os controles ActiveX MFC: Adicionando outra personalizada página de propriedades.

Implementando um página de propriedades (no caso, o padrão) é um processo de três etapas:

Para implementar um página de propriedades

1. Adicionar um COlePropertyPage-classe derivada para o projeto de controle. Se o projeto foi criado usando o Assistente de controle ActiveX (sistema autônomo no caso), a classe padrão da página de propriedades já existe.

2. Use o editor da caixa de diálogo para adicionar controles ao modelo de página de propriedades.

3. Personalizar o DoDataExchange função dos COlePropertyPage-derivado da classe para trocar valores entre o controle de página de propriedades e o controle ActiveX.

Por exemplo, fins, os procedimentos a seguir usar um controle simples (chamado "Sample").Exemplo foi criado usando o Assistente para controle ActiveX de ActiveX e contém somente a propriedade legenda ações.

Adicionando controles a um página de propriedades

Para adicionar controles a um página de propriedades

1. Com o seu projeto de controle em aberto, abra modo de exibição de recurso.

2. clicar duas vezes o Caixa de diálogoícone de pasta .

3. Abra o IDD_PROPPAGE_SAMPLE caixa de diálogo.

   O Assistente de controle ActiveX acrescenta o nome do projeto ao participante da caixa de diálogo ID, nesse caso, amostra.

4. arrastar e solte o controle selecionado da Toolbox para a área da caixa de diálogo.

5. Neste exemplo, um texto de rótulo controle "legenda:" e um controle de caixa de edição com um IDC_CAPTION identificador são suficientes.

6. clicar Salvar na barra de ferramentas para salvar suas alterações.

Agora que a interface do usuário tiver sido modificada, você precisa vincular a caixa de edição com a propriedade legenda.Para fazer isso na seção a seguir, editando o CSamplePropPage::DoDataExchange função.

Personalizando a função DoDataExchange

Your página de propriedades CWnd::DoDataExchange função permite que você vincule página de propriedades valores com os valores real das propriedades no controle. Para estabelecer links, você deve mapear os campos de página de propriedades adequadas às suas propriedades de controle respectivo.

Esses mapeamentos são implementados usando o página de propriedades DDP_ funções.The DDP_ funções funcionam como a DDX_ funções usadas no padrão caixas de diálogo MFC, com uma exceção.Juntamente com a referência a uma variável de membro, DDP_ funções levam o nome de propriedade do controle.A seguir é uma entrada típica no DoDataExchange função para um página de propriedades.

DDP_Text(pDX, IDC_CAPTION, m_caption, _T("Caption"));

Esta função associa m_caption variável de membro com a legenda usando o DDP_TEXT função.

Depois de ter o controle de página de propriedades inserido, você precisa estabelecer um vínculo entre o controle de página de propriedades, IDC_CAPTION, e a propriedade do controle real, legenda, usando o DDP_Textfunção conforme descrito acima.

Páginas de propriedades (MFC) estão disponível para outros tipos de controle de caixa de diálogo, sistema autônomo caixas de seleção, botões de opção, e lista caixas. A tabela abaixo mostra a lista de todo o conjunto de propriedade página DDP_ funções e suas finalidades:

Funções de página de propriedades

Consulte também

Conceitos

Controles do ActiveX MFC

Referência

Classe COlePropertyPage