Partilhar via

Classe COleConvertDialog

  • Artigo

Para mais informações, confira a estrutura OLEUICONVERT no SDK do Windows.

Sintaxe

class COleConvertDialog : public COleDialog

Membros

Construtores públicos

Nome Descrição
COleConvertDialog::COleConvertDialog Constrói um objeto COleConvertDialog.

Métodos públicos

Nome Descrição
COleConvertDialog::DoConvert Executa a conversão especificada na caixa de diálogo.
COleConvertDialog::DoModal Exibe a caixa de diálogo OLE Alterar Item.
COleConvertDialog::GetClassID Obtém o CLSID associado ao item escolhido.
COleConvertDialog::GetDrawAspect Informa se o item deve ser desenhado como um ícone.
COleConvertDialog::GetIconicMetafile Obtém um identificador para o metarquivo associado à forma icônica deste item.
COleConvertDialog::GetSelectionType Obtém o tipo de seleção escolhido.

Membros de Dados Públicos

Nome Descrição
COleConvertDialog::m_cv Uma estrutura que controla o comportamento da caixa de diálogo.

Comentários

Observação

O código de contêiner gerado pelo Assistente de Aplicativo usa essa classe.

Para mais informações sobre caixas de diálogo específicas do OLE, confira o artigo Caixas de diálogo no OLE.

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleConvertDialog

Requisitos

Cabeçalho: afxodlgs.h

COleConvertDialog::COleConvertDialog

Constrói apenas um objeto COleConvertDialog.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Parâmetros

pItem
Aponta para o item a ser convertido ou ativado.

dwFlags
O sinalizador de criação que contém qualquer número dos seguintes valores a serem combinados usando o operador bit a bit OR:

  • CF_SELECTCONVERTTO Especifica que o botão de opção Converter para será selecionado inicialmente quando a caixa de diálogo for chamada. Esse é o padrão.

  • CF_SELECTCONVERTTO Especifica que o botão de opção Ativar como será selecionado inicialmente quando a caixa de diálogo for chamada.

  • CF_SETCONVERTDEFAULT Especifica que a classe cujo CLSID é especificado pelo membro clsidConvertDefault da estrutura m_cv será usada como a seleção padrão na caixa de listagem de classe quando o botão de opção Converter para for selecionado.

  • CF_SETCONVERTDEFAULT Especifica que a classe cujo CLSID é especificado pelo membro clsidActivateDefault da estrutura m_cv será usada como a seleção padrão na caixa de listagem de classe quando o botão de opção Ativar como for selecionado.

  • IOF_SHOWHELP Especifica que o botão Ajuda será exibido quando a caixa de diálogo for chamada.

pClassID
Aponta para o CLSID do item a ser convertido ou ativado. Se for NULL, o CLSID associado ao pItem será usado.

pParentWnd
Aponta para o objeto de janela pai ou proprietário (do tipo CWnd) ao qual o objeto de caixa de diálogo pertence. Se for NULL, a janela pai da caixa de diálogo será definida como a janela principal do aplicativo.

Comentários

Para exibir a caixa de diálogo, chame a função DoModal.

Para obter mais informações, consulte a Chave CLSID e a estrutura OLEUICONVERT.

COleConvertDialog::DoConvert

Chame essa função depois de retornar com êxito do DoModal para converter ou ativar um objeto do tipo COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Parâmetros

pItem
Aponta para o item a ser convertido ou ativado. Não pode ser NULL.

Valor de retorno

Diferente de zero se tiver êxito; caso contrário, 0.

Comentários

O item é convertido ou ativado de acordo com as informações selecionadas pelo usuário na caixa de diálogo Converter.

COleConvertDialog::DoModal

Chame essa função para exibir a caixa de diálogo OLE Converter.

virtual INT_PTR DoModal();

Valor de retorno

Status de conclusão da caixa de diálogo. Um dos seguintes valores:

  • IDOK se a caixa de diálogo foi exibida com êxito.

  • IDCANCEL se o usuário cancelou a caixa de diálogo.

  • IDABORT se ocorreu um erro. Se IDABORT for retornado, chame a função membro COleDialog::GetLastError para obter mais informações sobre o tipo de erro que ocorreu. Para obter uma lista de possíveis erros, confira a função OleUIConvert no SDK do Windows.

Comentários

Se você quiser inicializar os vários controles da caixa de diálogo definindo membros da estrutura m_cv, faça isso antes de chamar DoModal, mas depois que o objeto de caixa de diálogo for construído.

Se retornar DoModal, você poderá chamar outras funções membro para recuperar as configurações ou informações inseridas pelo usuário na caixa de diálogo.

COleConvertDialog::GetClassID

Chame essa função para obter o CLSID associado ao item selecionado pelo usuário na caixa de diálogo Converter.

REFCLSID GetClassID() const;

Valor de retorno

O CLSID associado ao item que foi selecionado na caixa de diálogo Converter.

Comentários

Chame essa função somente depois que DoModal retornar IDOK.

Para mais informações, confira Chave CLSID no SDK do Windows.

COleConvertDialog::GetDrawAspect

Chame essa função para determinar se o usuário optou por exibir o item selecionado como um ícone.

DVASPECT GetDrawAspect() const;

Valor de retorno

O método necessário para renderizar o objeto.

  • DVASPECT_CONTENT Retornado se a caixa de seleção Exibir como Ícone não tiver sido marcada.

  • DVASPECT_ICON Retornado se a caixa de seleção Exibir como Ícone foi marcada.

Comentários

Chame essa função somente depois que DoModal retornar IDOK.

Para obter mais informações sobre o aspecto do desenho, confira a estrutura de dados FORMATETC no SDK do Windows.

COleConvertDialog::GetIconicMetafile

Chame essa função para obter um identificador para o metarquivo que contém o aspecto icônico do item selecionado.

HGLOBAL GetIconicMetafile() const;

Valor de retorno

O identificador para o metarquivo que contém o aspecto icônico do item selecionado se a caixa de seleção Exibir como Ícone tiver sido marcada quando a caixa de diálogo foi ignorada ao escolher OK; caso contrário, NULL.

COleConvertDialog::GetSelectionType

Chame essa função para determinar o tipo de conversão selecionado na caixa de diálogo Converter.

UINT GetSelectionType() const;

Valor de retorno

Tipo de seleção feita.

Comentários

Os valores de tipo retornado são especificados pelo tipo de enumeração Selection declarado na classe COleConvertDialog.

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Breves descrições desses valores estão a seguir:

  • COleConvertDialog::noConversion Retornado se a caixa de diálogo tiver sido cancelada ou o usuário não tiver selecionado nenhuma conversão. Se COleConvertDialog::DoModal retornar IDOK, é possível que o usuário tenha selecionado um ícone diferente daquele selecionado anteriormente.

  • COleConvertDialog::convertItem Retornado se o botão de opção Converter para tiver sido marcado, o usuário tiver selecionado um item diferente para converter e DoModal tiver retornado IDOK.

  • COleConvertDialog::activateAs Retornado se o botão de opção Ativar como tiver sido marcado, o usuário tiver selecionado um item diferente para ativar e DoModal tiver retornado IDOK.

COleConvertDialog::m_cv

Estrutura do tipo OLEUICONVERT usada para controlar o comportamento da caixa de diálogo Converter.

OLEUICONVERT m_cv;

Comentários

Os membros dessa estrutura podem ser modificados diretamente ou por meio de funções de membro.

Para mais informações, confira a estrutura OLEUICONVERT no SDK do Windows.

Confira também

Classe COleDialog
Gráfico da hierarquia
Classe COleDialog