Classe COleInsertDialog

Usado para a caixa de diálogo OLE Insert Object.

Sintaxe

class COleInsertDialog : public COleDialog

Membros

Construtores Públicos

Métodos Públicos

Membros de Dados Públicos

Observações

Cria um objeto de classe COleInsertDialog quando quiseres chamar esta caixa de diálogo. Depois de um COleInsertDialog objeto ter sido construído, pode usar a estrutura m_io para inicializar os valores ou estados dos controlos na caixa de diálogo. A m_io estrutura é do tipo OLEUIINSERTOBJECT. Para mais informações sobre a utilização desta classe de diálogo, consulte a função membro DoModal .

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

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

COleInsertDialog

Requerimentos

Cabeçalho: afxodlgs.h

COleInsertDialog::COleInsertDialog

Esta função constrói apenas um COleInsertDialog objeto.

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

Parâmetros

dwBandeiras
Flag de criação que contém qualquer número dos seguintes valores a combinar usando o operador bitwise-OR:

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

• IOF_SELECTCREATENEW Especifica que o botão de opção Criar Novo será selecionado inicialmente quando a caixa de diálogo for chamada. Este é o padrão e não pode ser usado com IOF_SELECTCREATEFROMFILE.

• IOF_SELECTCREATEFROMFILE Especifica que o botão de opção Criar a partir do ficheiro será selecionado inicialmente quando a caixa de diálogo for chamada. Não pode ser usado com IOF_SELECTCREATENEW.

• IOF_CHECKLINK Especifica que a caixa de seleção Link será assinalada inicialmente quando a caixa de diálogo for chamada.

• IOF_DISABLELINK Especifica que a caixa de seleção Link será desativada quando a caixa de diálogo for chamada.

• IOF_CHECKDISPLAYASICON Especifica que a caixa de seleção Display As Icon será inicialmente assinalada, o ícone atual será exibido e o botão Alterar Ícone será ativado quando a caixa de diálogo for chamada.

• IOF_VERIFYSERVERSEXIST Especifica que a caixa de diálogo deve validar as classes que adiciona à caixa de lista, garantindo que os servidores especificados na base de dados de registo existem antes da exibição da caixa de diálogo. Definir esta bandeira pode prejudicar significativamente o desempenho.

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 pai do objeto 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 .

ColeInsertDialog::CreateItem

Chame esta função para criar um objeto do tipo COleClientItem apenas se o DoModal devolver IDOK.

BOOL CreateItem(COleClientItem* pItem);

Parâmetros

pItem
Aponta para o item a criar.

Valor de retorno

Não nulo se o item foi criado; caso contrário, 0.

Observações

Deves alocar o COleClientItem objeto antes de poderes chamar esta função.

COleInsertDialog::D oModal

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

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Parâmetros

dwBandeiras
Um dos seguintes valores:

COleInsertDialog::DocObjectsOnly insere apenas DocObjects.

COleInsertDialog::ControlsOnly insere apenas controlos ActiveX.

O Zero não insere nem um DocObject nem um controlo ActiveX. Este valor resulta na mesma implementação do primeiro protótipo listado acima.

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 OleUIInsertObject no SDK do Windows.

Observações

Se quiseres inicializar os vários controlos das caixas de diálogo definindo membros da estrutura m_io , deves fazer isto 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 na caixa de diálogo pelo utilizador.

ColeInsertDialog::GetClassID

Chame esta função para obter o CLSID associado ao item selecionado apenas se o DoModal devolver IDOK e o tipo de seleção for COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Valor de retorno

Devolve o CLSID associado ao item selecionado.

Observações

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

ColeInsertDialog::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 se o DoModal devolver IDOK.

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

ColeInsertDialog::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.

ColeInsertDialog::GetPathName

Chame esta função para obter o caminho completo do ficheiro selecionado apenas se o DoModal devolver IDOK e o tipo de seleção não COleInsertDialog::createNewItemfor .

CString GetPathName() const;

Valor de retorno

O caminho completo para o ficheiro selecionado na caixa de diálogo. Se o tipo de seleção for createNewItem, esta função devolve um sem CString sentido no modo de lançamento ou causa uma asserção no modo de depuração.

ColeInsertDialog::GetSelectionType

Chame esta função para obter o tipo de seleção escolhido quando a caixa de diálogo Inserir Objeto foi desativada ao escolher OK.

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 COleInsertDialog classe.

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

Seguem-se breves descrições destes valores:

• COleInsertDialog::createNewItem O botão de opção Criar Novo foi selecionado.

• COleInsertDialog::insertFromFile O botão de opção Criar a partir do ficheiro estava selecionado e a caixa de seleção Link não estava assinalada.

• COleInsertDialog::linkToFile O botão de opção Criar a partir do ficheiro estava selecionado e a caixa de seleção Link estava assinalada.

ColeInsertDialog::m_io

Estrutura do tipo OLEUIINSERTOBJECT usada para controlar o comportamento da caixa de diálogo Inserir Objeto.

OLEUIINSERTOBJECT m_io;

Observações

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

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

Consulte também

Exemplo MFC OCLIENT
Classe COleDialog
Gráfico de Hierarquia
Classe COleDialog