Caixas de diálogo no OLE

Enquanto um usuário executa um aplicativo habilitado para OLE, há momentos em que o aplicativo precisa de informações do usuário para executar a operação. As classes OLE MFC fornecem caixas de diálogo padrão para reunir as informações necessárias. Este artigo lista as tarefas manipuladas pelas caixas de diálogo OLE e as classes necessárias para exibir essas caixas de diálogo. Para obter detalhes sobre caixas de diálogo OLE e as estruturas usadas para personalizar seu comportamento, consulte Referência MFC.

Caixas de diálogo comuns

Inserir objeto
Essa caixa de diálogo permite que o usuário insira objetos recém-criados ou existentes no documento composto. Ele também permite que o usuário escolha exibir o item como um ícone e habilita o botão de comando Alterar ícone. Exiba essa caixa de diálogo quando o usuário escolher Inserir objeto no menu Editar. Use a COleInsertDialog classe para exibir essa caixa de diálogo. Não é possível inserir um aplicativo MDI em si mesmo. Um aplicativo que é um contêiner/servidor não pode ser inserido em si mesmo, a menos que seja um aplicativo SDI.

Colar Especial
Esta caixa de diálogo permite ao usuário controlar o formato usado ao colar dados em um documento composto. O usuário pode escolher o formato dos dados, se deseja incorporar ou vincular os dados e se deseja exibi-los como um ícone. Exiba essa caixa de diálogo quando o usuário escolher Colar especial no menu Editar. Use a COlePasteSpecialDialog classe para exibir essa caixa de diálogo.

Alterar ícone
Essa caixa de diálogo permite que o usuário selecione qual ícone é exibido para representar o item vinculado ou incorporado. Exiba essa caixa de diálogo quando o usuário escolher Alterar ícone no menu Editar ou escolher o botão Alterar ícone nas caixas de diálogo Colar especial ou Converter. Exiba-o também quando o usuário abrir a caixa de diálogo Inserir objeto e escolher Exibir como ícone. Use a COleChangeIconDialog classe para exibir essa caixa de diálogo.

Converter
Essa caixa de diálogo permite que o usuário altere o tipo de um item incorporado ou vinculado. Por exemplo, se você incorporou um metarquivo em um documento composto e mais tarde deseja usar outro aplicativo para modificar o metarquivo incorporado, você pode usar a caixa de diálogo Converter. Essa caixa de diálogo geralmente é exibida clicando no tipo de item Objeto no menu Editar e, em seguida, no menu em cascata, clicando em Converter. Use a COleConvertDialog classe para exibir essa caixa de diálogo. Por exemplo, execute o exemplo OLE MFC OCLIENT.

Editar links ou atualizar links
A caixa de diálogo Editar links permite que o usuário altere informações sobre a origem de um objeto vinculado. A caixa de diálogo Atualizar Links verifica as origens de todos os itens vinculados na caixa de diálogo atual e exibe a caixa de diálogo Editar Vínculos, se necessário. Exiba a caixa de diálogo Editar links quando o usuário escolher Links no menu Editar. Normalmente, a caixa de diálogo Atualizar links é exibida quando um documento composto é aberto pela primeira vez. Use a classe COleLinksDialog ou a classe COleUpdateDialog, dependendo da caixa de diálogo que pretende exibir.

Servidor ocupado ou servidor não está respondendo
A caixa de diálogo Servidor Ocupado é exibida quando o usuário tenta ativar um item e o servidor não consegue lidar com a solicitação no momento, geralmente porque o servidor está em uso por outro usuário ou tarefa. A caixa de diálogo Servidor Não Respondendo será exibida se o servidor não responder à solicitação de ativação. Essas caixas de diálogo são exibidas via COleMessageFilter, com base em uma implementação da interface IMessageFilterOLE , e o usuário pode decidir se deseja tentar a solicitação de ativação novamente. Use a COleBusyDialog classe para exibir essa caixa de diálogo.

Ver também

Caixas de diálogo
Trabalhando com caixas de diálogo no MFC
OLE