Utilizzo di oggetti Ole
OLE è l’acronimo di “Object Linking and Embedding”. Questa è la 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 esportare questi “oggetti” in un’altra applicazione per la modifica e quindi importarli con alcuni contenuti aggiuntivi.
In questo articolo, parleremo dell’inserimento di un oggetto OLE e dell’impostazione delle sue proprietà in un documento.
Inserisci Ole Oggetto
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 OLE Oggetto 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’applicazione Packager.exe che poteva 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à OLE Package.
Nell’esempio di codice riportato di seguito viene illustrato come impostare il nome del file, l’estensione e il nome visualizzato per OLE Package:
Ottieni l’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 dati grezzi oggetto OLE utilizzando il metodo GetRawData:
Inserisci OLE Oggetto come icona
Gli oggetti OLE possono anche essere inseriti nei documenti come immagini.
Il seguente esempio di codice mostra come inserire OLE Oggetto come icona. A tale scopo, la classe DocumentBuilder espone il metodo InsertOleObjectAsIcon.
L’esempio di codice seguente mostra come inserire un oggetto incorporato OLE 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 provider, quindi contattare il rispettivo provider per i dettagli.
L’esempio di codice seguente mostra come inserire un video online in un documento utilizzando tale codice HTML: