Classe COleConvertDialog

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

Sintaxe

class COleConvertDialog : public COleDialog

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados Públicos

Observações

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

Hierarquia de herança

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleConvertDialog

Requerimentos

Cabeçalho: afxodlgs.h

COleConvertDialog::COleConvertDialog

Constrói apenas um COleConvertDialog objeto.

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

Parâmetros

pItem
Aponta para o item a converter ou ativar.

dwBandeiras
Flag de criação, que contém qualquer número dos seguintes valores combinados usando o operador bitwise-or:

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

• CF_SELECTACTIVATEAS 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 clsidConvertDefault membro da m_cv estrutura será usada como seleção padrão na caixa da lista de classes quando o botão de opção Converter para estiver selecionado.

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

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

pClassID
Aponta para o CLSID do item a converter ou ativar. Se for NULL, será utilizado o CLSID associado ao pItem .

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

Observações

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

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

COleConvertDialog::D oConvert

Chame esta função, após regressar com sucesso do DoModal, seja para converter ou para ativar um objeto do tipo COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Parâmetros

pItem
Aponta para o item a converter ou ativar. Não pode ser NULL.

Valor de retorno

Não nulo se for bem-sucedido; caso contrário, 0.

Observações

O item é convertido ou ativado de acordo com a informação selecionada pelo utilizador na caixa de diálogo Converter.

COleConvertDialog::D oModal

Chame esta função para mostrar a caixa de diálogo OLE Convert.

virtual INT_PTR DoModal();

Valor de retorno

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

• Não sei se a caixa de diálogo foi exibida com sucesso.

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

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

Observações

Se quiser inicializar os vários controlos das caixas de diálogo definindo membros da estrutura m_cv , deve fazê-lo antes de chamar DoModal, mas depois de o objeto de diálogo estar construído.

Se DoModal devolver IDOK, pode chamar outras funções membros para recuperar as definições ou informações introduzidas pelo utilizador na caixa de diálogo.

COleConvertDialog::GetClassID

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

REFCLSID GetClassID() const;

Valor de retorno

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

Observações

Chame esta função apenas depois de o DoModal devolver IDOK.

Para mais informações, consulte CLSID Key no Windows SDK.

COleConvertDialog::GetDrawAspect

Chame esta função para determinar se o utilizador escolheu exibir o item selecionado como um ícone.

DVASPECT GetDrawAspect() const;

Valor de retorno

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

• DVASPECT_CONTENT devolvido se a opção de Ícone de Mostrar Como não estivesse assinalada.

• DVASPECT_ICON Retornava se a caixa de Mostrar Como Ícone estivesse assinalada.

Observações

Chame esta função apenas depois de o DoModal devolver IDOK.

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

ColeConvertDialog::GetIconicMetafile

Chame esta função para obter um endereço para o metaficheiro que contém o aspeto icónico do item selecionado.

HGLOBAL GetIconicMetafile() const;

Valor de retorno

O handle do metaficheiro contendo o aspeto icónico do item selecionado, se a caixa de seleção Display As Icon estivesse assinalada quando o diálogo era ignorado ao escolher OK; caso contrário, NULL.

COleConvertDialog::GetSelectionType

Chame esta 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.

Observações

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

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Seguem-se breves descrições destes valores:

• COleConvertDialog::noConversion Retornava se a caixa de diálogo fosse cancelada ou se o utilizador selecionasse para não ter conversão. Se COleConvertDialog::DoModal for devolvido o IDOK, é possível que o utilizador tenha selecionado um ícone diferente daquele previamente selecionado.

• COleConvertDialog::convertItem Retornava se o botão de opção Converter para estivesse marcado, o utilizador selecionava um item diferente para converter e DoModal devolvea IDOK.

• COleConvertDialog::activateAs Devolvido se o botão de opção Ativar Como estivesse marcado, o utilizador selecionava um item diferente para ativar e DoModal devolvea IDOK.

COleConvertDialog::m_cv

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

OLEUICONVERT m_cv;

Observações

Os membros desta estrutura podem ser modificados diretamente ou através de funções membros.

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

Consulte também

Classe COleDialog
Gráfico de Hierarquia
Classe COleDialog