Lavorare con gli oggetti OLE
OLE (Object Linking and Embedding) è una tecnologia con cui gli utenti possono lavorare con documenti contenenti “oggetti” creati o modificati da applicazioni di terze parti. Cioè, OLE consente a un’applicazione di modifica di esportare questi “oggetti” in un’altra applicazione di modifica e quindi importarli con contenuti aggiuntivi.
In questo articolo, parleremo dell’inserimento di un oggetto OLE e dell’impostazione delle sue proprietà in un documento.
Inserisci Oggetto OLE
Se si desidera un oggetto OLE, chiamare il metodo InsertOleObject e passarlo esplicitamente a ProgId con altri parametri.
Il seguente esempio di codice mostra come inserire l’oggetto OLE in un documento:
Impostare il nome del file e l’estensione quando si inserisce l’oggetto OLE
Il pacchetto OLE è un modo legacy e" non documentato " per archiviare oggetti incorporati se un gestore OLE è sconosciuto.
Le prime versioni di Windows come Windows 3.1, 95 e 98 avevano un Packager.applicazione exe che potrebbe essere utilizzata per incorporare qualsiasi tipo di dati nel documento. Questa applicazione è ora esclusa da Windows, ma Microsoft Word e altre applicazioni lo usano ancora per incorporare i dati se il gestore OLE è mancante o sconosciuto. La classe OlePackage
consente agli utenti di accedere alle proprietà del pacchetto OLE.
L’esempio di codice seguente mostra come impostare il nome del file, l’estensione e il nome visualizzato per il pacchetto OLE:
Accesso ai dati grezzi dell’oggetto OLE
Gli utenti possono accedere ai dati dell’oggetto OLE utilizzando varie proprietà e metodi della classe OleFormat
. Ad esempio, è possibile ottenere i dati grezzi dell’oggetto OLE
o il percorso e il nome di un file di origine per l’oggetto OLE collegato.
L’esempio di codice seguente mostra come ottenere i dati grezzi dell’oggetto OLE utilizzando il metodo GetRawData:
Inserisci l’Oggetto Ole come icona
Gli oggetti OLE possono anche essere inseriti nei documenti come immagini.
Il seguente esempio di codice mostra come inserire l’oggetto OLE come icona. A tale scopo, la classe DocumentBuilder espone il metodo InsertOleObjectAsIcon:
Il seguente esempio di codice mostra come inserire un oggetto OLE incorporato come icona da un flusso nel documento:
Inserisci Video online
Il video online può essere inserito nel documento Word dalla scheda “Insert” > “Online Video”. È possibile inserire un video online in un documento nella posizione corrente chiamando il metodo InsertOnlineVideo.
La classe DocumentBuilder introduce quattro sovraccarichi di questo metodo. Il primo funziona con le risorse video più popolari e prende il URL
del video come parametro. Ad esempio, il primo sovraccarico supporta l’inserimento semplice di video online da YouTube e Vimeo resources.
L’esempio di codice seguente mostra come inserire un video online da Vimeo in un documento:
Il secondo sovraccarico funziona con tutte le altre risorse video e prende il codice HTML incorporato come parametro. Il codice HTML per l’incorporamento di un video può variare a seconda del fornitore, quindi contattare il rispettivo fornitore per i dettagli.
Il seguente esempio di codice mostra come inserire un video online in un documento utilizzando tale codice HTML: