Página de propriedades ATL COM

  • Artigo

As páginas de propriedades COM fornecem uma interface de usuário para definir as propriedades (ou chamar os métodos) de um ou mais objetos COM. As páginas de propriedades são usadas extensivamente por controles ActiveX para fornecer as interfaces de usuário avançadas que permitem que as propriedades de controle sejam definidas em tempo de design.

As páginas de propriedades são objetos COM que implementam a interface IPropertyPage ou IPropertyPage2. Essas interfaces fornecem os métodos que permitem que a página seja associada a um site (um objeto COM representando o contêiner da página) e a vários objetos (objetos COM cujos métodos serão chamados em resposta às alterações feitas pelo usuário da página de propriedades). O contêiner da página de propriedades é responsável por chamar os métodos na interface da página de propriedades para informar à página quando mostrar ou ocultar a interface do usuário, e quando aplicar as alterações feitas pelo usuário aos objetos subjacentes.

Cada página de propriedades pode ser criada completamente independentemente dos objetos cujas propriedades podem ser definidas. Tudo o que uma página de propriedades precisa é reconhecer uma interface específica (ou um conjunto de interfaces) e fornecer uma interface do usuário para chamar os métodos nessa interface.

Para obter mais informações, consulte Folhas de propriedades e páginas de propriedades no SDK do Windows.

Nesta seção

Especificando páginas de propriedades
Lista as etapas para especificar as páginas de propriedades para o controle e mostra uma classe de exemplo.

Implementando páginas de propriedades
Lista as etapas para implementar as páginas de propriedades, incluindo os métodos a serem substituídos. Percorre um exemplo completo com base no programa de exemplo ATLPages.

Exemplo de páginas ATL
O resumo de exemplo para o exemplo ATLPages, que implementa uma página de propriedades usando IPropertyPageImpl.

ATL
Fornece links para tópicos conceituais sobre como programar usando o Active Template Library.

Confira também

Conceitos