Classe de diálogo COleProperties

Encapsula a caixa de diálogo comum de Propriedades do Objeto OLE do Windows.

Sintaxe

class COlePropertiesDialog : public COleDialog

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados Públicos

Observações

As caixas de diálogo Propriedades de Objetos OLE comuns fornecem uma forma fácil de mostrar e modificar as propriedades de um item de documento OLE de forma consistente com os padrões do Windows. Estas propriedades incluem, entre outras, informações no ficheiro representado pelo item do documento, opções para mostrar o ícone e a escala da imagem, e informações sobre a ligação do item (caso o item esteja ligado).

Para usar um COlePropertiesDialog objeto, primeiro cria-o usando o COlePropertiesDialog construtor. Depois de a caixa de diálogo ter sido construída, chame a DoModal função membro para mostrar a caixa de diálogo e permitir que o utilizador modifique quaisquer propriedades do item. DoModal retorna quer o utilizador tenha selecionado o botão OK (IDOK) ou Cancelar (IDCANCEL). Além dos botões OK e Cancelar, existe um botão Aplicar. Quando o utilizador seleciona Aplicar, quaisquer alterações feitas às propriedades do item do documento são aplicadas ao item e a sua imagem é automaticamente atualizada, mas permanece ativa.

O m_psh membro de dados é um ponteiro para uma PROPSHEETHEADER estrutura e, na maioria dos casos, não precisará de aceder a ela explicitamente. Uma exceção é quando precisas de páginas de propriedades adicionais além das páginas padrão de Geral, Visualização e Link. Neste caso, pode modificar o m_psh membro de dados para incluir as suas páginas personalizadas antes de chamar a DoModal função membro.

Para mais informações sobre as caixas de diálogo OLE, consulte o artigo Caixas de Diálogo em OLE.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePropertiesDialog

Requerimentos

Cabeçalho: afxodlgs.h

Diálogo COleProperties::Diálogo COleProperties

Cria um COlePropertiesDialog objeto.

COlePropertiesDialog(
    COleClientItem* pItem,
    UINT nScaleMin = 10,
    UINT nScaleMax = 500,
    CWnd* pParentWnd = NULL);

Parâmetros

pItem
Apontar para o item do documento cujas propriedades estão a ser acedidas.

nScaleMin
Percentagem mínima de escalonamento para a imagem do item do documento.

nScaleMax
Percentagem máxima de escala para a imagem do item do documento.

pParentWnd
Apontar para o pai ou proprietário da caixa de diálogo.

Observações

Derive a sua classe COlePropertiesDialog de diálogo comum de Propriedades de Objetos OLE para implementar escalonamento para os itens do seu documento. Quaisquer caixas de diálogo implementadas por uma instância desta classe não suportarão a escalabilidade do item do documento.

Por defeito, a caixa de diálogo comum OLE Object Properties tem três páginas por defeito:

• Geral

  Esta página contém informações do sistema para o ficheiro representado pelo item do documento selecionado. A partir desta página, o utilizador pode converter o item selecionado para outro tipo.

• View

  Esta página contém opções para exibir o item, alterar o ícone e alterar a escala da imagem.

• Link

  Esta página contém opções para alterar a localização do item ligado e atualizá-lo. A partir desta página, o utilizador pode quebrar o link do item selecionado.

Para adicionar páginas para além das fornecidas por defeito, modifique a variável m_psh membro antes de sair do construtor da sua COlePropertiesDialogclasse derivada em . Esta é uma implementação avançada do COlePropertiesDialog construtor.

Diálogo COleProperties::D oModal

Chame esta função membro para mostrar a caixa de diálogo Propriedades do Objeto OLE comum do Windows e permitir que o utilizador visualize e/ou altere as várias propriedades do item do documento.

virtual INT_PTR DoModal();

Valor de retorno

IDOK ou IDCANCEL se for bem-sucedido; caso contrário, 0. IDOK e IDCANCEL são constantes que indicam se o utilizador selecionou o botão OK ou Cancelar.

Se o IDCANCEL for devolvido, pode chamar a função CommDlgExtendedError do Windows para determinar se ocorreu um erro.

Diálogo COleProperties::m_gp

Uma estrutura do tipo OLEUIGNRLPROPS, usada para inicializar a página Geral da caixa de diálogo Propriedades do Objeto OLE.

OLEUIGNRLPROPS m_gp;

Observações

Esta página mostra o tipo e tamanho de um embedding e permite ao utilizador o acesso à caixa de diálogo Converter. Esta página também mostra o destino do link se o objeto for um link.

Para mais informações sobre a OLEUIGNRLPROPS estrutura, consulte o SDK do Windows.

Diálogo COleProperties::m_lp

Uma estrutura do tipo OLEUILINKPROPS, usada para inicializar a página de ligação da caixa de diálogo Propriedades do Objeto OLE.

OLEUILINKPROPS m_lp;

Observações

Esta página mostra a localização do item ligado e permite ao utilizador atualizar, ou quebrar, o link para o item.

Para mais informações sobre a OLEUILINKPROPS estrutura, consulte o SDK do Windows.

Diálogo COleProperties::m_op

Uma estrutura do tipo OLEUIOBJECTPROPS, usada para inicializar a caixa de diálogo comum OLE Object Properties.

OLEUIOBJECTPROPS m_op;

Observações

Esta estrutura contém membros usados para inicializar as páginas Geral, Link e Visualização.

Para mais informações, consulte as estruturas OLEUIOBJECTPROPS e OLEUILINKPROPS no SDK do Windows.

Diálogo COleProperties::m_psh

Uma estrutura do tipo PROPSHEETHEADER, cujos membros armazenam as características do objeto de diálogo.

PROPSHEETHEADER m_psh;

Observações

Depois de construir um COlePropertiesDialog objeto, pode usar m_psh para definir vários aspetos da caixa de diálogo antes de chamar a DoModal função membro.

Se modificar diretamente o m_psh membro de dados, irá sobrepor qualquer comportamento padrão.

Para mais informações sobre a PROPSHEETHEADER estrutura, consulte o SDK do Windows.

DiálogoProprietáriosCócle::m_vp

Uma estrutura do tipo OLEUIVIEWPROPS, usada para inicializar a página de Visualização da caixa de diálogo Propriedades do Objeto OLE.

OLEUIVIEWPROPS m_vp;

Observações

Esta página permite ao utilizador alternar entre as vistas "conteúdo" e "icónica" do objeto, e alterar a sua escala dentro do contentor. Também permite ao utilizador aceder à caixa de diálogo Alterar Ícone quando o objeto está a ser exibido como um ícone.

Para mais informações sobre a OLEUIVIEWPROPS estrutura, consulte o SDK do Windows.

Diálogo COleProperties::OnApplyScale

É chamado pelo framework quando o valor de escalabilidade mudou e foi selecionado OK ou Aplicar.

virtual BOOL OnApplyScale(
    COleClientItem* pItem,
    int nCurrentScale,
    BOOL bRelativeToOrig);

Parâmetros

pItem
Apontar para o item do documento cujas propriedades estão a ser acedidas.

nCurrentScale
Valor numérico da escala de diálogo.

bRelativeToOrig
Indica se a escala se aplica ao tamanho original do item do documento.

Valor de retorno

Não nulo se for tratado; caso contrário, 0.

Observações

A implementação padrão não faz nada. Tens de sobrescrever esta função para ativar os controlos de escala.

Consulte também

MFC Sample CIRC
Classe COleDialog
Gráfico de Hierarquia
Classe COleDialog
CPropertyPage Classe