Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
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