# Problema de Visualização de Objeto ao Adicionar OleObjectFrame

> Saiba por que EMBEDDED OLE OBJECT aparece ao adicionar OleObjectFrame no Aspose.Slides para PHP e como corrigir problemas de visualização em apresentações PPT, PPTX e ODP.

Source: https://docs.aspose.com/slides/pt/php-java/object-preview-issue-when-adding-oleobjectframe/
Updated: 2026-06-10

## **Introdução**

Usando Aspose.Slides para PHP via Java, ao adicionar um [OleObjectFrame](https://reference.aspose.com/slides/pt/php-java/aspose.slides/oleobjectframe/) a um slide, é exibida a mensagem "EMBEDDED OLE OBJECT" no slide de saída. Essa mensagem é intencional e NÃO é um bug.

Para mais informações sobre como trabalhar com objetos OLE, veja [Manage OLE](/slides/pt/php-java/manage-ole/). 

## **Explicação e Solução**

Aspose.Slides exibe a mensagem "EMBEDDED OLE OBJECT" para notificar que o objeto OLE foi alterado e a imagem de visualização precisa ser atualizada. 

Por exemplo, se você adicionar um gráfico do Microsoft Excel como um [OleObjectFrame](https://reference.aspose.com/slides/pt/php-java/aspose.slides/oleobjectframe/) a um slide (para mais detalhes, consulte o artigo "Manage OLE") e então abrir a apresentação no Microsoft PowerPoint, verá esta imagem no slide:

![OLE object message](OLE_object_message.png)

Se quiser verificar e confirmar que seu objeto OLE foi adicionado ao slide, você deve clicar duas vezes na mensagem "EMBEDDED OLE OBJECT", ou pode clicar com o botão direito nela e escolher a opção **Object > Edit**.

![OLE object > Edit](OLE_object_edit.png)

O PowerPoint então abre o objeto OLE incorporado.

![OLE object data](OLE_object_data.png)

O slide pode manter a mensagem "EMBEDDED OLE OBJECT". Quando você clicar no objeto OLE, a visualização do slide será atualizada e a mensagem "EMBEDDED OLE OBJECT" será substituída pela imagem real do objeto OLE. 

![OLE object preview](OLE_object_preview.png)

Agora, você pode querer salvar sua apresentação para garantir que a imagem do Objeto OLE seja atualizada corretamente. Dessa forma, após salvar a apresentação, ao abri‑la novamente, você NÃO verá a mensagem "EMBEDDED OLE OBJECT". 

## **Outras Soluções**

### **Solução 1: Substituir a mensagem "Embedded OLE Object" por uma Imagem**

Se você não quiser remover a mensagem "EMBEDDED OLE OBJECT" abrindo a apresentação no PowerPoint e depois salvando‑a, pode substituir a mensagem pela sua imagem de visualização preferida. Estas linhas de código demonstram o processo:

```php
$presentation = new Presentation("embeddedOLE.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);
    $oleFrame = $slide->getShapes()->get_Item(0);

    // Adicionar uma imagem aos recursos da apresentação.
    $image = Images::fromFile("myImage.png");
    $oleImage = $presentation->getImages()->addImage($image);
    $image->dispose();

    // Definir um título e a imagem para a visualização do objeto OLE.
    $oleFrame->setSubstitutePictureTitle("My title");
    $oleFrame->getSubstitutePictureFormat()->getPicture()->setImage($oleImage);
    $oleFrame->setObjectIcon(false);

    $presentation->save("embeddedOLE-newImage.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}
```

O slide que contém o `OleObjectFrame` então passa a ser este:

![New OLE object image](OLE_object_new_image.png)

### **Solução 2: Criar um Add‑On para PowerPoint**

Você também pode criar um add‑on para o Microsoft PowerPoint que atualiza todos os objetos OLE ao abrir apresentações no programa.