Condividi tramite

Aggiungere controlli Segnalibro ai documenti di Word

  • Articolo

Nei progetti a livello di documento è possibile aggiungere controlli Bookmark al documento nel progetto in fase di progettazione o di esecuzione. Nei progetti di componente aggiuntivo VSTO è possibile aggiungere i controlli Bookmark a qualsiasi documento aperto in fase di esecuzione.

Si applica a: le informazioni contenute in questo argomento si applicano ai progetti a livello di documento e ai progetti di componente aggiuntivo VSTO per Word. Per altre informazioni, vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Questo argomento descrive le attività seguenti:

Aggiungere controlli Segnalibro in fase di progettazione

Sono disponibili varie modalità di aggiunta di controlli Bookmark al documento in un progetto a livello di documento in fase di progettazione:

  • Dalla Casella degli strumentidi Visual Studio.

    È possibile trascinare il controllo Bookmark dalla Casella degli strumenti al documento. Scegliere questa modalità se si sta già usando la Casella degli strumenti per aggiungere controlli Windows Form al documento.

  • Da Word.

    È possibile aggiungere il controllo Bookmark al documento nello stesso modo in cui si aggiunge un segnalibro nativo. Il vantaggio di questa modalità è la possibilità di assegnare un nome al controllo al momento della creazione.

  • Dalla finestra Origini dati .

    È possibile trascinare il controllo Bookmark nel documento dalla finestra Origini dati . Questa modalità è utile quando si vuole contemporaneamente associare il controllo ai dati. È possibile aggiungere il controllo host nello stesso modo in cui si aggiunge un controllo Windows Form dalla finestra Origini dati . Per altre informazioni, vedere Data binding e Windows Form.

    Nota

    I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzare l'IDE.

Per aggiungere un controllo Bookmark a un documento dalla casella degli strumenti

  1. Aprire la Casella degli strumenti e fare clic sulla scheda Controlli Word .

  2. Trascinare un controllo Bookmark nel documento.

    Verrà visualizzata la finestra di dialogo Aggiungi controllo Bookmark .

  3. Selezionare il testo o altri elementi che si desidera includere nel segnalibro.

  4. Fare clic su OK.

    Se non si vuole mantenere il nome del segnalibro predefinito, è possibile modificarlo nella finestra Proprietà .

Per aggiungere un controllo Bookmark a un documento in Word

  1. Nel documento ospitato nella finestra di progettazione di Visual Studio posizionare il cursore in cui si desidera aggiungere il segnalibro oppure selezionare il testo che si vuole racchiudere nel segnalibro.

  2. Nella scheda Inserisci della barra multifunzione fare clic sul pulsante Segnalibro nel gruppo Collegamenti .

  3. Nella finestra di dialogo Segnalibro digitare il nome del nuovo segnalibro e fare clic su Aggiungi.

Aggiungere controlli Segnalibro in fase di esecuzione in un progetto a livello di documento

È possibile aggiungere controlli Bookmark a livello di codice al documento in fase di esecuzione usando i metodi della proprietà Controls della classe ThisDocument nel progetto. Ci sono due overload di metodo che è possibile usare per aggiungere un controllo Bookmark nei modi seguenti:

  • Aggiungere un oggetto Bookmark in corrispondenza di un intervallo specificato.

  • Aggiungere un oggetto Bookmark basato su un segnalibro nativo nel documento (ovvero un oggetto Bookmark).

    I controlli Bookmark creati dinamicamente non vengono salvati in modo permanente nel documento quando questo viene chiuso. Tuttavia, un oggetto Bookmark nativo rimane nel documento. È possibile ricreare un oggetto Bookmark basato su un segnalibro nativo alla successiva apertura del documento. Per altre informazioni, vedere Aggiungere controlli ai documenti di Office in fase di esecuzione.

Per aggiungere un controllo Bookmark a un documento a livello di codice

  1. Nel gestore eventi ThisDocument_Startup nel progetto inserire il codice seguente per aggiungere il controllo Bookmark al primo paragrafo nel documento.

    Microsoft.Office.Tools.Word.Bookmark firstParagraph;
firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
    "FirstParagraph");

    Nota

    Se si vuole creare un controllo Bookmark da un oggetto Bookmarkesistente, usare il metodo AddBookmark e passare l'oggetto Bookmarkesistente.

Aggiungere controlli Segnalibro in fase di esecuzione in un progetto di componente aggiuntivo VSTO

È possibile aggiungere controlli Bookmark a livello di codice a qualsiasi documento aperto in fase di esecuzione usando un componente aggiuntivo VSTO. A tale scopo, generare un elemento host Document basato su un documento aperto e quindi usare i metodi della proprietà Controls di tale elemento host. Ci sono due overload di metodo che è possibile usare per aggiungere un controllo Bookmark nei modi seguenti:

Per aggiungere un controllo Bookmark in corrispondenza di un intervallo specificato

  1. Usare il metodo AddBookmark e passare l'oggetto Range dove si vuole aggiungere Bookmark.

    L'esempio di codice seguente aggiunge un nuovo oggetto Bookmark all'inizio del documento attivo. Per usare questo esempio, eseguire il codice dal gestore eventi ThisAddIn_Startup in un progetto di componente aggiuntivo VSTO di Word.

    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);


Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
    extendedDocument.Paragraphs[1].Range, "FirstParagraph");

Per aggiungere un controllo Bookmark basato su un controllo Bookmark nativo

  1. Usare il metodo AddBookmark e passare l'oggetto Bookmark esistente che si vuole usare come base per il nuovo oggetto Bookmark.

    L'esempio di codice seguente crea un nuovo oggetto Bookmark basato sul primo oggetto Bookmark nel documento attivo. Per usare questo esempio, eseguire il codice dal gestore eventi ThisAddIn_Startup in un progetto di componente aggiuntivo VSTO di Word.

    if (this.Application.ActiveDocument.Bookmarks.Count > 0)
{
    object index = 1;
    Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);


     Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);

    Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
            firstBookmark, "VSTOBookmark");
}

Contenuto correlato