Introduzione
In questo articolo, vedremo come creare un componente di tipo Web, per il programma di video scrittura più utilizzato al mondo, Microsoft Word.
Il componente visualizzerà una frase nel documento tramite il click di un pulsante posto nel TaskPane, utilizzando file di tipo web, come HTML e Javascript.
Il componente sarà come mostrato in figura 1.
Figura 1 – Il componente realizzato
Creazione del progetto
Si crea un nuovo progetto tramite Visual Studio 2022 Community, nella selezione dei progetti, selezioniamo il modello di tipo “Componente aggiuntivo web per Word”, il tutto come mostrato in figura 2.
Figura 2 – La scelta del progetto
Facciamo click sul pulsane “Avanti” , e selezioniamo l’ultima versione del Framework, la 4
8.1 , ed assegniamo il nome del progetto.
Impostati questi due campi, facciamo click sul pulsante “Crea” in modo che verrà creato il progetto.
Stesura del codice
Terminata la creazione del progetto, non resta che scrivere il codice. Nel progetto avremo diverse cartelle, che contengono, gli script, le immagini ed altro, come se fosse appunto un’applicazione web.
Modifichiamo il file denominato “Home.css” , togliendo il codice presente di default e mettendo questo qui di seguito.
Home.css
body {
font-family: Arial, sans-serif;
}
h1 {
color: #0078D7;
}
button {
background-color: #0078D7;
color: white;
border: none;
padding: 10px 20px;
cursor: pointer;
}
button:hover {
background-color: #005A9E;
}
Questo file, permette di impostare la formattazione della pagina Home, o meglio applicare lo stile ai vari componenti presenti nella pagina.
Facciamo click sul pulsante “Home.html”, in modo da visualizzare il codice presente in questo file. Qui, troviamo il codice html, che riguarderà il taskpane, ossia quello che verrà visualizzato nel task panel. In particolare un pulsante ed un titolo.
Di seguito si riporta il codice del file “Home.html”.
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>Task Panel
Personalizzato</title>
<script src="Scripts/jquery-3.6.0.js" type="text/javascript"></script>
<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js"></script>
<script src="Home.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="Home.css">
</head>
<body>
<h1>Esempio di Task Panel Personalizzato</h1>
<button id="run">Esegui Azione</button>
</body>
</html>
Questo codice, oltre a fare riferimento a due file di tipo Javascript, in particolare quello per la gestione delle funzionalità Microsoft Office, denominato “office.js, mentre l’altro file, quello denominato Home.js, riguarderà le funzionalità personalizzate, ossia il codice che far eseguire determinate operazioni che vorremmo effettuare sul documento Microsoft Word.
Facciamo click sul pulsante Home.Js, e togliamo il codice che è stato generato automaticamente, per inserire un codice personalizzato.
In particolare, all’evento click del pulsante, verrà inserito del testo nel documento Microsoft Word.
Di seguito si riporta il codice del file “Home.js”, delle suddette operazioni.
Home.js
Office.onReady(() => {
if (Office.context.host === Office.HostType.Word) {
document.getElementById("run").onclick = run;
}
});
async function run() {
await Word.run(async (context) => {
const doc = context.document;
doc.body.insertText("Ciao a tutti! Testo
inserito nel documento ", Word.InsertLocation.end);
await context.sync();
});
}
Conclusioni
Terminata la stesura del codice, non resta che eseguire la nostra applicazione (premere il taso F5, oppure Esegui) per verificare quanto scritto. L’articolo ha voluto fornire al lettore, le basi per realizzare i componenti Microsoft Word, utilizzando il linguaggio del web. Per coloro che già usano questi linguaggi, troveranno molto semplice e di facile realizzazione, la creazione di componenti di Microsoft Word, anche di una certa complessità.
La creazione dei componenti, può avveri in due modalità, utilizzando il linguaggio di programmazione C#, oppure il linguaggio web, come in questo articolo.
Le potenzialità offerte dall’ambiente di sviluppo Visual Studio 2022 Community, permettono al programmatore di realizzare componenti per Microsoft Word per estendere funzionalità o aggiungere particolare operatività.