Partilhar via


Classe IPropertyPageImpl

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe implementa IUnknown e fornece uma implementação padrão da interface IPropertyPage .

Importante

Esta classe e os seus membros não podem ser usados em aplicações que sejam executadas no Windows Runtime.

Sintaxe

template<class T>
class IPropertyPageImpl

Parâmetros

T
A sua classe, derivada de IPropertyPageImpl.

Membros

Construtores Públicos

Nome Description
IPropertyPageImpl::IPropertyPageImpl Construtor.

Métodos Públicos

Nome Description
IPropertyPageImpl::Ativar Cria a janela da caixa de diálogo para a página de propriedades.
IPropertyPageImpl::Apply Aplica valores atuais de página de propriedades aos objetos subjacentes especificados através de SetObjects. A implementação do ATL devolve S_OK.
IPropertyPageImpl::D eactivate Destrói a janela criada com Activate.
IPropertyPageImpl::GetPageInfo Recupera informações sobre a página da propriedade.
IPropertyPageImpl::Ajuda Invoca ajuda do Windows para a página de propriedades.
IPropertyPageImpl::IsPageDirty Indica se a página de propriedades mudou desde que foi ativada.
IPropertyPageImpl::Move Posiciona e redimensiona a caixa de diálogo da página de propriedades.
IPropertyPageImpl::SetDirty Sinaliza o estado da página da propriedade como alterado ou inalterado.
IPropertyPageImpl::SetObjects Fornece um array de IUnknown ponteiros para os objetos associados à página de propriedades. Estes objetos recebem os valores atuais da página de propriedades através de uma chamada a Apply.
IPropertyPageImpl::SetPageSite Fornece à página de propriedades um IPropertyPageSite ponteiro, através do qual a página de propriedades comunica com o quadro de propriedades.
IPropertyPageImpl::Mostrar Torna a caixa de diálogo da página de propriedades visível ou invisível.
IPropertyPageImpl::TranslateAccelerator Processa uma tecla pressionada especificada.

Membros de Dados Públicos

Nome Description
IPropertyPageImpl::m_bDirty Especifica se o estado da página de propriedades mudou.
IPropertyPageImpl::m_dwDocString Armazena o identificador de recurso associado à cadeia de texto que descreve a página de propriedades.
IPropertyPageImpl::m_dwHelpContext Armazena o identificador de contexto para o tópico de ajuda associado à página de propriedades.
IPropertyPageImpl::m_dwHelpFile Armazena o identificador de recurso associado ao nome do ficheiro de ajuda que descreve a página de propriedades.
IPropertyPageImpl::m_dwTitle Armazena o identificador de recurso associado à cadeia de texto que aparece no separador da página de propriedades.
IPropertyPageImpl::m_nObjects Armazena o número de objetos associados à página de propriedades.
IPropertyPageImpl::m_pPageSite Aponta para a IPropertyPageSite interface através da qual a página de propriedades comunica com o quadro de propriedades.
IPropertyPageImpl::m_ppUnk Aponta para um array de IUnknown apontadores para os objetos associados à página de propriedades.
IPropertyPageImpl::m_size Armazena a altura e largura da caixa de diálogo da página de propriedades, em pixels.

Observações

A interface IPropertyPage permite que um objeto gere uma determinada página de propriedades dentro de uma folha de propriedades. A Class IPropertyPageImpl fornece uma implementação padrão desta interface e é IUnknown implementada enviando informação para o dispositivo de despejo em compilações de depuração.

Artigos RelacionadosTutorial ATL, Criação de um Projeto ATL

Hierarquia de herança

IPropertyPage

IPropertyPageImpl

Requerimentos

Cabeçalho: atlctl.h

IPropertyPageImpl::Ativar

Cria a janela da caixa de diálogo para a página de propriedades.

HRESULT Activate(
    HWND hWndParent,
    LPCRECT pRect,
    BOOL bModal);

Observações

Por defeito, a caixa de diálogo é sempre sem modos, independentemente do valor do parâmetro bModal .

Ver IPropertyPage::Ativar no SDK do Windows.

IPropertyPageImpl::Apply

Aplica valores atuais de página de propriedades aos objetos subjacentes especificados através de SetObjects.

HRESULT Apply();

Valor de retorno

Devolve S_OK.

Observações

Veja IPropertyPage::Apply no SDK do Windows.

IPropertyPageImpl::D eactivate

Destrói a janela de caixa de diálogo criada com Ativar.

HRESULT Deactivate();

Observações

Consulte IPropertyPage::D eactivate no SDK do Windows.

IPropertyPageImpl::GetPageInfo

Preenche a estrutura pPageInfo com a informação contida nos membros de dados.

HRESULT GetPageInfo(PROPPAGEINFO* pPageInfo);

Observações

GetPageInfo carrega os recursos da cadeia associados a m_dwDocString, m_dwHelpFile e m_dwTitle.

Veja IPropertyPage::GetPageInfo no SDK do Windows.

IPropertyPageImpl::Ajuda

Invoca ajuda do Windows para a página de propriedades.

HRESULT Help(PROPPAGEINFO* pPageInfo);

Observações

Veja IPropertyPage::Ajuda no SDK do Windows.

IPropertyPageImpl::IPropertyPageImpl

O construtor.

IPropertyPageImpl();

Observações

Inicializa todos os membros dos dados.

IPropertyPageImpl::IsPageDirty

Indica se a página de propriedades mudou desde que foi ativada.

HRESULT IsPageDirty(void);

Observações

IsPageDirty Retorna S_OK se a página mudou desde que foi ativada.

IPropertyPageImpl::m_bDirty

Especifica se o estado da página de propriedades mudou.

BOOL m_bDirty;

IPropertyPageImpl::m_nObjects

Armazena o número de objetos associados à página de propriedades.

ULONG m_nObjects;

IPropertyPageImpl::m_dwHelpContext

Armazena o identificador de contexto para o tópico de ajuda associado à página de propriedades.

DWORD m_dwHelpContext;

IPropertyPageImpl::m_dwDocString

Armazena o identificador de recurso associado à cadeia de texto que descreve a página de propriedades.

UINT m_dwDocString;

IPropertyPageImpl::m_dwHelpFile

Armazena o identificador de recurso associado ao nome do ficheiro de ajuda que descreve a página de propriedades.

UINT m_dwHelpFile;

IPropertyPageImpl::m_dwTitle

Armazena o identificador de recurso associado à cadeia de texto que aparece no separador da página de propriedades.

UINT m_dwTitle;

IPropertyPageImpl::m_pPageSite

Aponta para a interface IPropertyPageSite , através da qual a página de propriedades comunica com o quadro de propriedades.

IPropertyPageSite* m_pPageSite;

IPropertyPageImpl::m_ppUnk

Aponta para um array de IUnknown apontadores para os objetos associados à página de propriedades.

IUnknown** m_ppUnk;

IPropertyPageImpl::m_size

Armazena a altura e largura da caixa de diálogo da página de propriedades, em pixels.

SIZE m_size;

IPropertyPageImpl::Move

Posiciona e redimensiona a caixa de diálogo da página de propriedades.

HRESULT Move(LPCRECT pRect);

Observações

Veja IPropertyPage::Move no SDK do Windows.

IPropertyPageImpl::SetDirty

Sinaliza o estado da página da propriedade como alterado ou inalterado, dependendo do valor de bDirty.

void SetDirty(BOOL bDirty);

Parâmetros

bSujo
[dentro] Se TRUE, o estado da página de propriedades é marcado como alterado. Caso contrário, está marcado como inalterado.

Observações

Se necessário, SetDirty informa o frame que a página de propriedades mudou.

IPropertyPageImpl::SetObjects

Fornece um array de IUnknown ponteiros para os objetos associados à página de propriedades.

HRESULT SetObjects(ULONG nObjects, IUnknown** ppUnk);

Observações

Consulte IPropertyPage::SetObjects no SDK do Windows.

IPropertyPageImpl::SetPageSite

Fornece à página de propriedades um ponteiro IPropertyPageSite , através do qual a página de propriedades comunica com o quadro de propriedades.

HRESULT SetPageSite(IPropertyPageSite* pPageSite);

Observações

Consulte IPropertyPage::SetPageSite no SDK do Windows.

IPropertyPageImpl::Mostrar

Torna a caixa de diálogo da página de propriedades visível ou invisível.

HRESULT Show(UINT nCmdShow);

Observações

Veja IPropertyPage::Show no SDK do Windows.

IPropertyPageImpl::TranslateAccelerator

Processa a tecla pressionada especificada em pMsg.

HRESULT TranslateAccelerator(MSG* pMsg);

Observações

Veja IPropertyPage::TranslateAccelerator no SDK do Windows.

Consulte também

Classe IPropertyPage2Impl
Classe IPerPropertyBrowsingImpl
ISspecificifyPropertyPagesImpl Class
Visão geral da classe