Procedura dettagliata: Automatizzare un'applicazione da un riquadro attività personalizzato

  • Articolo

Questa procedura dettagliata mostra come creare un riquadro attività personalizzato che consente di automatizzare PowerPoint. Il riquadro attività personalizzato inserisce le date in una diapositiva quando l'utente fa clic su un controllo MonthCalendar che si trova nel riquadro attività personalizzato.

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

Benché questa procedura dettagliata usi PowerPoint in modo specifico, i concetti illustrati sono applicabili a tutte le applicazioni elencate in precedenza.

In questa procedura dettagliata sono illustrati i task seguenti:

  • Progettazione dell'interfaccia utente del riquadro attività personalizzato.

  • Automazione di PowerPoint dal riquadro attività personalizzato.

  • Visualizzazione del riquadro attività personalizzato in PowerPoint.

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 di Visual Studio.

Prerequisiti

Per completare questa procedura dettagliata, è necessario disporre dei componenti seguenti:

Creare il progetto di componente aggiuntivo

Il primo passaggio consiste nel creare un progetto di componente aggiuntivo VSTO per PowerPoint.

Per creare un nuovo progetto

  1. Creare un progetto di componente aggiuntivo VSTO per PowerPoint denominato MyAddIn, usando il modello per il progetto di componente aggiuntivo di PowerPoint. Per altre informazioni, vedere Procedura: Creare progetti di Office in Visual Studio.

    Visual Studio apre il file di codice ThisAddIn.cs o ThisAddIn.vb e aggiunge il progetto MyAddIn a Esplora soluzioni.

Progettare l'interfaccia utente del riquadro attività personalizzato

Non sono presenti finestre di visualizzazione visiva per i riquadri attività personalizzati, ma è possibile progettare un controllo utente con il layout desiderato. Più avanti in questa procedura dettagliata il controllo utente verrà aggiunto al riquadro attività personalizzato.

Per progettare l'interfaccia utente del riquadro attività personalizzato

  1. Nel menu Progetto fare clic su Aggiungi controllo utente.

  2. Nella finestra di dialogo Aggiungi nuovo elemento modificare il nome del controllo utente su MyUserControle fare clic su Aggiungi.

    Il controllo utente viene visualizzato nella finestra di progettazione.

  3. Nella scheda Controlli comuni della casella degli strumentitrascinare un controllo MonthCalendar nel controllo utente.

    Se il controllo MonthCalendar è più ampio dell'area di progettazione del controllo utente, ridimensionare il controllo utente per adattare il controllo MonthCalendar .

Automatizzare PowerPoint dal riquadro attività personalizzato

Lo scopo del componente aggiuntivo VSTO è inserire una data selezionata nella prima diapositiva della presentazione attiva. Usare l'evento DateChanged del controllo per aggiungere la data selezionata ogni volta che viene modificata.

Per automatizzare PowerPoint dal riquadro attività personalizzato

  1. Nella finestra di progettazione fare doppio clic sul controllo MonthCalendar .

    Il file MyUserControl.cs o MyUserControl.vb si apre e viene creato un gestore eventi per l'evento DateChanged .

  2. Aggiungere il codice seguente all'inizio del file. Questo codice crea alias per gli Microsoft.Office.Core spazi dei nomi e PowerPoint .

    using Office = Microsoft.Office.Core;
using PowerPoint = Microsoft.Office.Interop.PowerPoint;

  3. Aggiungere il codice seguente alla classe MyUserControl . Questo codice dichiara un oggetto Shape come membro di MyUserControl. Nel passaggio seguente si userà questa forma per aggiungere una casella di testo a una diapositiva nella presentazione attiva.

    private PowerPoint.Shape textbox;

  4. Sostituire il gestore eventi monthCalendar1_DateChanged con il codice seguente. Questo codice aggiunge una casella di testo alla prima diapositiva nella presentazione attiva, quindi aggiunge la data attualmente selezionata alla casella di testo. Questo codice usa l'oggetto Globals.ThisAddIn per accedere al modello di oggetto di PowerPoint.

    private void monthCalendar1_DateChanged(object sender, DateRangeEventArgs e)
{
    try
    {
        if (textbox != null)
        {
            textbox.Delete();
        }

        PowerPoint.Slide slide =
            Globals.ThisAddIn.Application.ActivePresentation.Slides[1];
        textbox = slide.Shapes.AddTextbox(
            Office.MsoTextOrientation.msoTextOrientationHorizontal,
            50, 100, 600, 50);
        textbox.TextFrame.TextRange.Text = e.Start.ToLongDateString();
        textbox.TextFrame.TextRange.Font.Size = 48;
        textbox.TextFrame.TextRange.Font.Color.RGB =
             Color.DarkViolet.ToArgb();
    }
    catch (Exception ex)
    {
        MessageBox.Show(ex.ToString());
    }
}

  5. In Esplora soluzionifare clic con il pulsante destro del mouse sul progetto MyAddIn , quindi scegliere Compila. Verificare che il progetto venga compilato senza errori.

Visualizzare il riquadro attività personalizzato

Per visualizzare il riquadro attività personalizzato quando viene avviato il componente aggiuntivo VSTO, aggiungere il controllo utente al riquadro attività nel gestore eventi Startup del componente aggiuntivo VSTO.

Per visualizzare il riquadro attività personalizzato

  1. In Esplora soluzioniespandere PowerPoint.

  2. Fare clic con il pulsante destro del mouse su ThisAddIn.cs o ThisAddIn.vb , quindi scegliere Visualizza codice.

  3. Aggiungere il codice seguente alla classe ThisAddIn . Questo codice dichiara le istanze di MyUserControl e CustomTaskPane come membri della classe ThisAddIn .

    private MyUserControl myUserControl1;
private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;

  4. Sostituire il gestore eventi ThisAddIn_Startup con il codice seguente. Questo codice crea un nuovo oggetto CustomTaskPane aggiungendo l'oggetto MyUserControl alla raccolta CustomTaskPanes . Il codice visualizza anche il riquadro attività.

    private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    myUserControl1 = new MyUserControl();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "Calendar");
    myCustomTaskPane.Visible = true;
}

Testare il componente aggiuntivo

Quando si esegue il progetto, PowerPoint si apre e il componente aggiuntivo VSTO visualizza il riquadro attività personalizzato. Fare clic sul controllo MonthCalendar per testare il codice.

Per testare il componente aggiuntivo VSTO

  1. Premere F5 per eseguire il progetto.

  2. Verificare che il riquadro attività personalizzato sia visibile.

  3. Fare clic su una data nel controllo MonthCalendar nel riquadro attività.

    La data viene inserita nella prima diapositiva della presentazione attiva.

Passaggi successivi

Per altre informazioni su come creare i riquadri attività personalizzati, vedere gli argomenti seguenti:

Contenuto correlato