Condividi tramite

Panoramica del riquadro Azioni

Importante

La funzione Azioni è stata ritirata da Microsoft Word a partire da Office 2024. Questa funzionalità è disponibile solo in Microsoft Word con le seguenti versioni di Office.

  • Microsoft 365
  • Ufficio LTSC Professional Plus 2021
  • Standard LTSC per ufficio 2021
  • Office Professional Plus 2016, 2019
  • Office Standard 2016, 2019

Un riquadro attività è un riquadro attività personalizzabile azioni documento allegato a un documento specifico di Microsoft Office Word o a una cartella di lavoro di Microsoft Office Excel. Il riquadro delle azioni è ospitato all'interno del riquadro attività di Office insieme ad altri riquadri attività predefiniti, come il riquadro attività Origine XML in Excel o il riquadro attività Stili e formattazione in Word. È possibile utilizzare controlli Windows Form o controlli WPF per progettare l'interfaccia utente del riquadro azioni.

Si applica a: Le informazioni contenute in questo argomento si applicano ai progetti a livello di documento per Excel e Word. Per altre informazioni, vedere Funzionalità disponibili per l'applicazione e il tipo di progetto di Office.

È possibile creare un riquadro azioni solo in una personalizzazione a livello di documento per Word o Excel. Non è possibile creare un riquadro azioni in un componente aggiuntivo VSTO. Per altre informazioni, vedere Funzionalità disponibili per l'applicazione e il tipo di progetto di Office.

Nota

Il riquadro azioni è diverso dai riquadri attività personalizzati. I riquadri attività personalizzati sono associati all'applicazione, non a un documento specifico. È possibile creare riquadri attività personalizzati nei componenti aggiuntivi VSTO per alcune applicazioni di Microsoft Office. Per altre informazioni, vedere Riquadri attività personalizzati.

Visualizzare il riquadro azioni

Il riquadro azioni è rappresentato dalla classe ActionsPane. Quando si crea un progetto a livello di documento, un'istanza di questa classe è disponibile per il codice usando il campo ActionsPane della classe ThisWorkbook (per Excel) o ThisDocument (per Word) nel progetto. Per visualizzare il riquadro azioni, aggiungere un controllo Windows Form alla proprietà Controls del campo ActionsPane. Nell'esempio di codice seguente viene aggiunto un controllo denominato actions al riquadro azioni.

this.ActionsPane.Controls.Add(actions);

Il riquadro azioni diventa visibile in fase di esecuzione non appena si aggiunge in modo esplicito un controllo. Dopo aver visualizzato il riquadro azioni, è possibile aggiungere o rimuovere in modo dinamico i controlli in risposta alle azioni dell'utente. In genere, si aggiunge il codice per visualizzare il riquadro azioni nel gestore eventi Startup di ThisDocument o ThisWorkbook in modo che il riquadro azioni sia visibile quando l'utente apre il documento per la prima volta. Tuttavia, potrebbe essere necessario visualizzare il riquadro azioni solo in risposta all'azione di un utente nel documento. Ad esempio, è possibile aggiungere il codice all'evento Click di un controllo nel documento.

Aggiungere più controlli al riquadro azioni

Quando si aggiungono più controlli al riquadro azioni, è necessario raggruppare i controlli in un controllo utente e quindi aggiungere il controllo utente alla proprietà Controls. Questo processo include i passaggi seguenti:

  1. Creare l'interfaccia utente del riquadro azioni aggiungendo un controllo del riquadro delle azioni o un controllo utente al progetto. Entrambi questi elementi includono una classe personalizzata di Windows Form UserControl. Gli elementi del Controllo Riquadro Azioni e del Controllo Utente sono equivalenti; l'unica differenza è il nome.

  2. Aggiungere controlli Windows Forms al UserControl usando la finestra di progettazione oppure scrivendo codice.

    Nota

    È anche possibile aggiungere controlli WPF al riquadro azioni aggiungendo un UserControl WPF a Windows Form UserControl. Per altre informazioni, vedere Usare controlli WPF nelle soluzioni Office.

  3. Aggiungere un'istanza del controllo utente personalizzato ai controlli contenuti nel campo ActionsPane della classe ThisWorkbook (per Excel) o ThisDocument (per Word) nel progetto.

    Per esempi che illustrano questo processo in modo più dettagliato, vedere Procedura: Aggiungere un riquadro azioni a documenti di Word o cartelle di lavoro di Excel.

Nascondere il riquadro azioni

Anche se la classe ActionsPane ha un metodo Hide e una proprietà Visible, non è possibile rimuovere il riquadro azioni dall'interfaccia utente usando qualsiasi membro della classe ActionsPane stessa. La chiamata al metodo Hide o l'impostazione della proprietà Visible su false nasconde solo i controlli nel riquadro azioni; non nasconde il riquadro attività.

Per nascondere il riquadro attività nella soluzione, sono disponibili diverse opzioni:

  • Per Word, impostare la proprietà Visible dell'oggetto TaskPane che rappresenta il riquadro attività Azioni documento su false. L'esempio di codice seguente deve essere eseguito dalla classe ThisDocument nel progetto.

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;

  • Per Excel, impostare la proprietà DisplayDocumentActionTaskPane dell'oggetto Application su false. L'esempio di codice seguente deve essere eseguito dalla classe ThisWorkbook nel progetto.

    this.Application.DisplayDocumentActionTaskPane = false;

  • Per Word o Excel, in alternativa, è possibile impostare la proprietà Visible della barra dei comandi che rappresenta il riquadro attività su false. L'esempio di codice seguente deve essere eseguito dalla classe ThisDocument o ThisWorkbook nel progetto.

    this.Application.CommandBars["Task Pane"].Visible = false;

Cancellare il riquadro azioni all'apertura del documento

Quando un utente salva il documento mentre il riquadro azioni è visibile, il riquadro azioni è visibile ogni volta che il documento viene aperto, indipendentemente dal fatto che il riquadro azioni contenga controlli. Se si desidera controllare quando viene visualizzata, chiamare il metodo Clear del campo ActionsPane nel gestore eventi Startup di ThisDocument o ThisWorkbook per assicurarsi che il riquadro azioni non sia visibile all'apertura del documento.

Determinare quando il riquadro azioni è chiuso

Non viene generato alcun evento quando il riquadro azioni viene chiuso. Anche se la classe ActionsPane ha un evento VisibleChanged, questo evento non viene generato quando l'utente finale chiude il riquadro azioni. Questo evento viene invece generato quando i controlli nel riquadro azioni vengono nascosti chiamando il metodo Hide o impostando la proprietà Visible su false.

Quando l'utente chiude il riquadro azioni, l'utente può visualizzarlo di nuovo eseguendo una delle procedure seguenti nell'interfaccia utente dell'applicazione.

Per visualizzare il riquadro azioni tramite l'interfaccia utente di Word o Excel

  1. Sulla barra multifunzione fare clic sulla scheda Visualizzazione.

  2. Nel gruppo Mostra/Nascondi fare clic sul pulsante Azioni documento.

Eventi del riquadro Azioni del programma

È possibile aggiungere più controlli utente al riquadro azioni e quindi scrivere codice per rispondere agli eventi nel documento visualizzando e nascondendo i controlli utente. Se si esegue il mapping degli elementi XML Schema al documento, è possibile visualizzare determinati controlli utente nel riquadro azioni ogni volta che il punto di inserimento si trova all'interno di uno degli elementi XML. Per altre informazioni, vedere Procedura: Eseguire il mapping degli schemi ai documenti di Word all'interno di Visual Studio e Procedura: Eseguire il mapping degli schemi ai fogli di lavoro all'interno di Visual Studio.

È anche possibile scrivere codice per rispondere agli eventi di qualsiasi oggetto, tra cui controllo host, applicazione o eventi del documento. Per ulteriori informazioni, consultare Procedura dettagliata: Gestire gli eventi di un controllo NamedRange.

Associare i dati ai controlli nel riquadro azioni

I controlli nel riquadro azioni hanno le stesse funzionalità di data binding dei controlli in Windows Form. È possibile associare i controlli a origini dati, ad esempio set di dati, set di dati tipizzati e XML. Per altre informazioni, vedere Data binding e Windows Form.

È possibile associare controlli nel riquadro azioni e nei controlli del documento allo stesso set di dati. Ad esempio, è possibile creare una relazione master/dettagli tra i controlli nel riquadro azioni e i controlli del foglio di lavoro. Per ulteriori informazioni, vedere Guida: Associare dati ai controlli nel riquadro delle azioni di Excel.

Convalidare i dati nei controlli del riquadro azioni

Se si visualizza una casella di messaggio nel gestore eventi Validating di un controllo nel riquadro azioni, l'evento potrebbe essere generato una seconda volta quando lo stato attivo passa dal controllo alla casella di messaggio. Per evitare questo problema, usare un controllo ErrorProvider per visualizzare eventuali messaggi di errore di convalida.

Ordine di sovrapposizione del controllo utente

Se si usano più controlli utente, è possibile scrivere codice per impilare correttamente i controlli utente nel riquadro azioni, indipendentemente dal fatto che sia ancorato verticalmente o orizzontalmente. È possibile impostare l'ordine di stack dei controlli utente nel riquadro azioni usando l'enumerazione StackStyle della proprietà StackOrder. Per altre informazioni, vedere Procedura: Gestire il layout dei controlli nei riquadri azioni.

La proprietà StackOrder può accettare i valori di enumerazione StackStyle seguenti.

Stile di impilamento Definizione
DaDal fondo Impila dalla parte inferiore del riquadro delle azioni.
Da sinistra Stack a sinistra del riquadro delle azioni.
Dadestra Impila a partire da destra del riquadro azioni.
Dall'alto Impila dall'alto del riquadro azioni.
Nessuno Nessun ordine di impilamento definito; l'ordine è controllato dallo sviluppatore.

Il codice seguente imposta la proprietà StackOrder in modo da impilare i controlli utente dalla parte superiore del riquadro azioni.

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

Controlli di ancoraggio

Se l'utente ridimensiona il riquadro azioni in fase di esecuzione, i controlli possono essere ridimensionati con il riquadro azioni. È possibile utilizzare la proprietà Anchor di un controllo Windows Form per ancorare i controlli al riquadro azioni. È anche possibile ancorare i controlli Windows Form al controllo utente nello stesso modo. Per altre informazioni, vedere Procedura: Ancorare i controlli in Windows Forms.

Ridimensionare il riquadro azioni

Non è possibile modificare direttamente le dimensioni di un ActionsPane perché il ActionsPane è incorporato nel riquadro attività. Tuttavia, è possibile modificare a livello di codice la larghezza del riquadro attività impostando la proprietà Width del CommandBar che rappresenta il riquadro attività. È possibile modificare l'altezza del riquadro attività se è ancorata orizzontalmente o mobile.

Non è consigliabile ridimensionare il riquadro attività a livello di codice perché l'utente deve essere in grado di selezionare le dimensioni del riquadro attività più adatte alle proprie esigenze. Tuttavia, se è necessario ridimensionare la larghezza del riquadro attività, è possibile usare il codice seguente per ottenere questa attività.

this.CommandBars["Task Pane"].Width = 200;

Riposizionare il riquadro azioni

Non è possibile riposizionare direttamente il ActionsPane perché è incorporato nel riquadro attività. Tuttavia, è possibile spostare il riquadro attività a livello di codice impostando la proprietà Position del CommandBar che rappresenta il riquadro attività.

Il riposizionamento del riquadro attività a livello di codice non è consigliato perché l'utente deve essere in grado di scegliere la posizione del riquadro attività sullo schermo più adatta alle proprie esigenze. Tuttavia, se è necessario spostare il riquadro attività in una posizione specifica, è possibile usare il codice seguente per ottenere questa attività.

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

Nota

Gli utenti finali possono riposizionare manualmente il riquadro attività in qualsiasi momento. Non è possibile assicurarsi che il riquadro attività rimanga ancorato alla posizione indicata a livello di codice. Tuttavia, è possibile verificare la presenza di modifiche di orientamento e assicurarsi che i controlli nel riquadro azioni siano impilati nella direzione corretta. Per altre informazioni, vedere Procedura: Gestire il layout dei controlli nei riquadri azioni.

L'impostazione delle proprietà Top e Left del ActionsPane non cambia la posizione perché l'oggetto ActionsPane è incorporato nel riquadro attività.

Se il riquadro attività non è ancorato, è possibile impostare le proprietà Top e Left del CommandBar che rappresenta il riquadro attività. Il codice seguente sposta un riquadro attività non ancorato nell'angolo superiore sinistro del documento.

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}

Contenuto correlato