Caixas de diálogo em OLE

Quando 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 coletar as informações necessárias. Este artigo lista as tarefas tratadas pelas caixas de diálogo OLE e as classes necessárias para exibir essas caixas de diálogo. Para obter detalhes sobre as caixas de diálogo OLE e as estruturas usadas para personalizar seu comportamento, consulte Referência de 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. Ela 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 classe COleInsertDialog para exibir essa caixa de diálogo. Você não pode inserir um aplicativo MDI no próprio aplicativo MDI. Um aplicativo que é um contêiner/servidor não pode ser inserido em si mesmo, a menos que seja um aplicativo SDI.

Colar Especial
Essa caixa de diálogo permite que o usuário controle o formato usado ao colar dados em um documento composto. O usuário pode escolher o formato dos dados, optar se deseja inserir 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 classe COlePasteSpecialDialog 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 inserido. 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 classe COleChangeIconDialog para exibir essa caixa de diálogo.

Converter
Essa caixa de diálogo permite que o usuário altere o tipo de um item inserido ou vinculado. Por exemplo, se você inseriu um metarquivo em um documento composto e, posteriormente, deseja usar outro aplicativo para modificar o metarquivo inserido, 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 classe COleConvertDialog para exibir essa caixa de diálogo. Por exemplo, execute o OCLIENT de exemplo OLE do MFC.

Editar Links ou Atualizar Links
A caixa de diálogo Editar Links permite que o usuário altere informações sobre a fonte de um objeto vinculado. A caixa de diálogo Atualizar Links verifica as fontes de todos os itens vinculados na caixa de diálogo atual e exibe a caixa de diálogo Editar Links, 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 COleUpdateDialog, dependendo da caixa de diálogo que você deseja exibir.

Servidor ocupado ou servidor não 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, geralmente porque o servidor está em uso por outro usuário ou tarefa. A caixa de diálogo Servidor não está respondendo será exibida se o servidor não responder à solicitação de ativação. Essas caixas de diálogo são exibidas por meio de COleMessageFilter, com base em uma implementação da interface OLE IMessageFilter, e o usuário pode decidir se deseja tentar a solicitação de ativação novamente. Use a classe COleBusyDialog para exibir essa caixa de diálogo.

Confira também

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