Partilhar via


Classe IPropertyPageImpl

Essa classe implementa IUnknown e fornece uma implementação padrão da interface IPropertyPageImpl.

Importante

Essa classe e os respectivos membros não podem ser usados em aplicativos executados no Windows Runtime.

Sintaxe

template<class T>
class IPropertyPageImpl

Parâmetros

T
Sua classe, derivada de IPropertyPageImpl.

Membros

Construtores públicos

Nome Descrição
IPropertyPageImpl::IPropertyPageImpl Construtor.

Métodos públicos

Nome Descrição
IPropertyPageImpl::Activate Cria a janela da caixa de diálogo para a página de propriedade.
IPropertyPageImpl::Apply Aplica valores de página de propriedade atuais aos objetos subjacentes especificados por meio de SetObjects. A implementação da ATL retorna S_OK.
IPropertyPageImpl::Deactivate Destrói a janela criada com Activate.
IPropertyPageImpl::GetPageInfo Recupera informações sobre a página de propriedade.
IPropertyPageImpl::Help Invoca a ajuda do Windows para a página de propriedades.
IPropertyPageImpl::IsPageDirty Indica se a página de propriedade foi alterada desde que foi ativada.
IPropertyPageImpl::Move Posiciona e redimensiona a caixa de diálogo da página de propriedade.
IPropertyPageImpl::SetDirty Sinaliza o estado da página de propriedade como alterado ou inalterado.
IPropertyPageImpl::SetObjects Fornece uma matriz de ponteiros IUnknown para os objetos associados à página de propriedade. Esses objetos recebem os valores da página de propriedade atual por meio de uma chamada para Apply.
IPropertyPageImpl::SetPageSite Fornece à página de propriedade um ponteiro IPropertyPageSite, por meio do qual a página de propriedade se comunica com o quadro de propriedades.
IPropertyPageImpl::Show Torna a caixa de diálogo da página de propriedade visível ou invisível.
IPropertyPageImpl::TranslateAccelerator Processa um pressionamento de tecla especificado.

Membros de Dados Públicos

Nome Descrição
IPropertyPageImpl::m_bDirty Especifica se o estado da página de propriedade foi alterado.
IPropertyPageImpl::m_dwDocString Armazena o identificador de recurso associado à cadeia de caracteres de texto que descreve a página de propriedade.
IPropertyPageImpl::m_dwHelpContext Armazena o identificador de contexto para o tópico de ajuda associado à página de propriedade.
IPropertyPageImpl::m_dwHelpFile Armazena o identificador de recurso associado ao nome do arquivo de ajuda que descreve a página de propriedade.
IPropertyPageImpl::m_dwTitle Armazena o identificador de recurso associado à cadeia de caracteres de texto que aparece na guia da página de propriedade.
IPropertyPageImpl::m_nObjects Armazena o número de objetos associados à página de propriedade.
IPropertyPageImpl::m_pPageSite Aponta para a interface IPropertyPageSite pela qual a página de propriedade se comunica com o quadro de propriedade.
IPropertyPageImpl::m_ppUnk Aponta para uma matriz de ponteiros IUnknown para os objetos associados à página de propriedade.
IPropertyPageImpl::m_size Armazena a altura e a largura da caixa de diálogo da página de propriedade, em pixels.

Comentários

A interface IPropertyPage permite que um objeto gerencie uma página de propriedade específica dentro de uma folha de propriedades. A classe IPropertyPageImpl fornece uma implementação padrão dessas interfaces e implementa IUnknown enviando informações para o dispositivo de despejo em builds de depuração.

Artigos relacionados Tutorial da ATL, criando um projeto da ATL

Hierarquia de herança

IPropertyPage

IPropertyPageImpl

Requisitos

Cabeçalho: atlctl.h

IPropertyPageImpl::Activate

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

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

Comentários

Por padrão, a caixa de diálogo é sempre sem modelo, independentemente do valor do parâmetro bModal .

Consulte IPropertyPage::Activate no SDK do Windows.

IPropertyPageImpl::Apply

Aplica valores de página de propriedade atuais aos objetos subjacentes especificados por meio de SetObjects.

HRESULT Apply();

Valor de retorno

Returns S_OK.

Comentários

Consulte IPropertyPage::Apply no SDK do Windows.

IPropertyPageImpl::Deactivate

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

HRESULT Deactivate();

Comentários

Consulte IPropertyPage::Deactivate no SDK do Windows.

IPropertyPageImpl::GetPageInfo

Preenche a estrutura pPageInfo com informações contidas nos membros de dados.

HRESULT GetPageInfo(PROPPAGEINFO* pPageInfo);

Comentários

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

Consulte IPropertyPage::GetPageInfo no SDK do Windows.

IPropertyPageImpl::Help

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

HRESULT Help(PROPPAGEINFO* pPageInfo);

Comentários

Consulte IPropertyPage::Help no SDK do Windows.

IPropertyPageImpl::IPropertyPageImpl

O construtor .

IPropertyPageImpl();

Comentários

Inicializa todos os membros de dados.

IPropertyPageImpl::IsPageDirty

Indica se a página de propriedade foi alterada desde que foi ativada.

HRESULT IsPageDirty(void);

Comentários

IsPageDirty retornará S_OK se a página tiver sido alterada desde que foi ativada.

IPropertyPageImpl::m_bDirty

Especifica se o estado da página de propriedade foi alterado.

BOOL m_bDirty;

IPropertyPageImpl::m_nObjects

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

ULONG m_nObjects;

IPropertyPageImpl::m_dwHelpContext

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

DWORD m_dwHelpContext;

IPropertyPageImpl::m_dwDocString

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

UINT m_dwDocString;

IPropertyPageImpl::m_dwHelpFile

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

UINT m_dwHelpFile;

IPropertyPageImpl::m_dwTitle

Armazena o identificador de recurso associado à cadeia de caracteres de texto que aparece na guia da página de propriedade.

UINT m_dwTitle;

IPropertyPageImpl::m_pPageSite

Aponta para a interface IPropertyPageSite pela qual a página de propriedade se comunica com o quadro de propriedade.

IPropertyPageSite* m_pPageSite;

IPropertyPageImpl::m_ppUnk

Aponta para uma matriz de ponteiros IUnknown para os objetos associados à página de propriedade.

IUnknown** m_ppUnk;

IPropertyPageImpl::m_size

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

SIZE m_size;

IPropertyPageImpl::Move

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

HRESULT Move(LPCRECT pRect);

Comentários

Consulte IPropertyPage::Move no SDK do Windows.

IPropertyPageImpl::SetDirty

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

void SetDirty(BOOL bDirty);

Parâmetros

bDirty
[in] Se TRUE, o estado da página de propriedade será marcado como alterado. Caso contrário, ele será marcado como inalterado.

Comentários

Se necessário, SetDirty informa ao quadro que a página de propriedade foi alterada.

IPropertyPageImpl::SetObjects

Fornece uma matriz de ponteiros IUnknown para os objetos associados à página de propriedade.

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

Comentários

Consulte IPropertyPage::SetObjects no SDK do Windows.

IPropertyPageImpl::SetPageSite

Fornece à página de propriedade um ponteiro IPropertyPageSite, por meio do qual a página de propriedade se comunica com o quadro de propriedade.

HRESULT SetPageSite(IPropertyPageSite* pPageSite);

Comentários

Consulte IPropertyPage::SetPageSite no SDK do Windows.

IPropertyPageImpl::Show

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

HRESULT Show(UINT nCmdShow);

Comentários

Consulte IPropertyPage::Show no SDK do Windows.

IPropertyPageImpl::TranslateAccelerator

Processa o pressionamento de tecla especificado em pMsg.

HRESULT TranslateAccelerator(MSG* pMsg);

Comentários

Consulte IPropertyPage::TranslateAccelerator no SDK do Windows.

Confira também

Classe IPropertyPage2Impl
Classe IPerPropertyBrowsingImpl
Classe ISpecifyPropertyPagesImpl
Visão geral da aula