Classe COlePropertiesDialog
Encapsula a caixa de diálogo do Objeto OLE comum do Windows.
Sintaxe
class COlePropertiesDialog : public COleDialog
Membros
Construtores públicos
| Nome | Descrição |
|---|---|
| COlePropertiesDialog::COlePropertiesDialog | Constrói um objeto COlePropertiesDialog. |
Métodos públicos
| Nome | Descrição |
|---|---|
| COlePropertiesDialog::DoModal | Exibe a caixa de diálogo e permite que o usuário faça uma seleção. |
| COlePropertiesDialog::OnApplyScale | Chamado pela estrutura quando o dimensionamento do item de documento foi alterado. |
Membros de Dados Públicos
| Nome | Descrição |
|---|---|
| COlePropertiesDialog::m_gp | Uma estrutura usada para inicializar a página "Geral" de um objeto COlePropertiesDialog. |
| COlePropertiesDialog::m_lp | Uma estrutura usada para inicializar a página "Link" de um objeto COlePropertiesDialog. |
| COlePropertiesDialog::m_op | Uma estrutura usada para inicializar o objeto COlePropertiesDialog. |
| COlePropertiesDialog::m_psh | Uma estrutura usada para adicionar páginas de propriedades personalizadas adicionais. |
| COlePropertiesDialog::m_vp | Uma estrutura usada para personalizar a página "Exibir" de um objeto COlePropertiesDialog. |
Comentários
As caixas de diálogo Propriedades comuns do objeto OLE oferecem um modo fácil de exibir e modificar as propriedades de um item de documento OLE de maneira consistente com os padrões do Windows. Essas propriedades incluem, entre outras, informações sobre o arquivo representado pelo item do documento, opções para exibir o ícone e o dimensionamento de imagem e informações sobre o link do item (se o item estiver vinculado).
Para usar um objeto COlePropertiesDialog, primeiro crie o objeto usando o construtor COlePropertiesDialog. Depois que a caixa de diálogo for construída, chame a função de membro DoModal para exibir a caixa de diálogo e permitir que o usuário modifique todas as propriedades do item. DoModal retorna se o usuário selecionou o botão OK (IDOK) ou Cancelar (IDCANCEL). Além dos botões OK e Cancelar, há um botão Aplicar. Quando o usuário seleciona Aplicar, todas as alterações feitas nas propriedades do item de documento são aplicadas ao item e sua imagem é atualizada automaticamente, mas permanece ativa.
O membro de dados m_psh é um ponteiro para uma estrutura PROPSHEETHEADER e, na maioria dos casos, você não precisará acessá-la explicitamente. Uma exceção é quando você precisa de páginas de propriedades adicionais além das páginas geral, exibição e link padrão. Nesse caso, você pode modificar o membro de dados m_psh para incluir suas páginas personalizadas antes de chamar a função de membro DoModal.
Para mais informações sobre caixas de diálogo OLE, confira o artigo Caixas de Diálogo no OLE.
Hierarquia de herança
COlePropertiesDialog
Requisitos
Cabeçalho: afxodlgs.h
COlePropertiesDialog::COlePropertiesDialog
Cria um objeto COlePropertiesDialog.
COlePropertiesDialog(
COleClientItem* pItem,
UINT nScaleMin = 10,
UINT nScaleMax = 500,
CWnd* pParentWnd = NULL);
Parâmetros
pItem
Ponteiro para o item de documento cujas propriedades estão sendo acessadas.
nScaleMin
Percentual mínimo de dimensionamento para a imagem do item do documento.
nScaleMax
Percentual máximo de dimensionamento para a imagem do item do documento.
pParentWnd
Ponteiro para o pai ou proprietário da caixa de diálogo.
Comentários
Derive a classe de diálogo Propriedades comuns do Objeto OLE de COlePropertiesDialog para implementar o dimensionamento para os itens do documento. As caixas de diálogo implementadas por uma instância dessa classe não darão suporte ao dimensionamento do item do documento.
Por padrão, a caixa de diálogo propriedades comuns do objeto OLE tem três páginas padrão:
Geral
Esta página contém informações do sistema para o arquivo representado pelo item de documento selecionado. Nesta página, o usuário pode converter o item selecionado em outro tipo.
Exibir
Esta página contém opções para exibir o item, alterar o ícone e alterar o dimensionamento da imagem.
Link
Esta página contém opções para alterar o local do item vinculado e atualizar o item vinculado. Nesta página, o usuário pode interromper o link do item selecionado.
Para adicionar páginas além daquelas fornecidas por padrão, modifique a variável de membro m_psh antes de sair do construtor da classe derivada de COlePropertiesDialog. Essa é uma implementação avançada do construtor COlePropertiesDialog.
COlePropertiesDialog::DoModal
Chame essa função membro para exibir a caixa de diálogo Propriedades comuns do objeto OLE do Windows e permitir que o usuário exiba e/ou altere as várias propriedades do item do documento.
virtual INT_PTR DoModal();
Valor de retorno
IDOK ou IDCANCEL se tiver êxito; caso contrário, 0. IDOK e IDCANCEL são constantes que indicam se o usuário selecionou o botão OK ou Cancelar.
Se IDCANCEL for retornado, você poderá chamar a função CommDlgExtendedError do Windows para determinar se ocorreu um erro.
COlePropertiesDialog::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;
Comentários
Esta página mostra o tipo e o tamanho de uma inserção e permite que o usuário acesse a 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 estrutura OLEUIGNRLPROPS, confira o SDK do Windows.
COlePropertiesDialog::m_lp
Uma estrutura do tipo OLEUILINKPROPS, usada para inicializar a página Link da caixa de diálogo Propriedades do Objeto OLE.
OLEUILINKPROPS m_lp;
Comentários
Esta página mostra o local do item vinculado e permite que o usuário atualize, ou interrompa, o link para o item.
Para mais informações sobre a estrutura OLEUILINKPROPS, confira o SDK do Windows.
COlePropertiesDialog::m_op
Uma estrutura do tipo OLEUIOBJECTPROPS, usada para inicializar a caixa de diálogo comum Propriedades do objeto OLE.
OLEUIOBJECTPROPS m_op;
Comentários
Essa estrutura contém membros usados para inicializar as páginas Geral, Link e Exibição.
Para mais informações, confira as estruturas OLEUIOBJECTPROPS e OLEUILINKPROPS no SDK do Windows.
COlePropertiesDialog::m_psh
Uma estrutura do tipo PROPSHEETHEADER, cujos membros armazenam as características do objeto de caixa de diálogo.
PROPSHEETHEADER m_psh;
Comentários
Depois de construir um objeto COlePropertiesDialog, você pode usar m_psh para definir vários aspectos da caixa de diálogo antes de chamar a função de membro DoModal.
Se você modificar o membro de dados m_psh diretamente, substituirá qualquer comportamento padrão.
Para mais informações sobre a estrutura PROPSHEETHEADER, confira o SDK do Windows.
COlePropertiesDialog::m_vp
Uma estrutura do tipo OLEUIVIEWPROPS, usada para inicializar a página Exibição da caixa de diálogo Propriedades do Objeto OLE.
OLEUIVIEWPROPS m_vp;
Comentários
Esta página permite que o usuário alterne entre exibições "conteúdo" e "icônicas" do objeto e altere seu dimensionamento dentro do contêiner. Ela também permite que o usuário acesse a caixa de diálogo Alterar Ícone quando o objeto está sendo exibido como um ícone.
Para mais informações sobre a estrutura OLEUIVIEWPROPS, confira o SDK do Windows.
COlePropertiesDialog::OnApplyScale
Chamado pela estrutura quando o valor de dimensionamento foi alterado e OK ou Aplicar foi selecionado.
virtual BOOL OnApplyScale(
COleClientItem* pItem,
int nCurrentScale,
BOOL bRelativeToOrig);
Parâmetros
pItem
Ponteiro para o item de documento cujas propriedades estão sendo acessadas.
nCurrentScale
Valor numérico da escala de diálogo.
bRelativeToOrig
Indica se o dimensionamento se aplica ao tamanho original do item do documento.
Valor de retorno
Não zero se tratado; caso contrário, 0.
Comentários
A implementação padrão não tem ação. Você deve substituir essa função para habilitar os controles de dimensionamento.
Observação
Antes da exibição da caixa de diálogo propriedades comuns do objeto OLE, a estrutura chama essa função com um NULL para pItem e um -1 para nCurrentScale. Isso é feito para determinar se os controles de dimensionamento devem ser habilitados.
Confira também
CIRC de exemplo do MFC
Classe COleDialog
Gráfico da hierarquia
Classe COleDialog
Classe CPropertyPage