Esporta (0) Stampa
Espandi tutto

Classe CustomTaskPane

Rappresenta un riquadro attività personalizzato in un'applicazione di Microsoft Office.

Spazio dei nomi: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common2007 (in microsoft.office.tools.common2007.dll)

public sealed class CustomTaskPane : IDisposable

Utilizzare la classe CustomTaskPane in un componente aggiuntivo a livello di applicazione per modificare un riquadro attività personalizzato oppure per rispondere a eventi correlati alla modifica della posizione o della visibilità del riquadro attività personalizzato. I riquadri attività sono pannelli dell'interfaccia utente in genere ancorati a un lato della finestra di un'applicazione. Per ulteriori informazioni sulla creazione di riquadri attività personalizzati, vedere Cenni preliminari sui riquadri attività personalizzati.

Per controllare le dimensioni o la posizione del riquadro attività personalizzato, è possibile utilizzare proprietà quali Height, Width e Visible. Per rispondere a eventi correlati allo spostamento del riquadro attività personalizzato o alla modifica della visibilità del riquadro, è possibile gestire gli eventi DockPositionChanged e VisibleChanged.

Nell'esempio di codice seguente viene illustrato come creare un riquadro attività personalizzato utilizzando il metodo Add(UserControl,String). Nell'esempio vengono utilizzate proprietà dell'oggetto CustomTaskPane per impostare l'aspetto predefinito del riquadro attività personalizzato e vengono definiti i gestori eventi per gli eventi DockPositionChanged e VisibleChanged. Per la compilazione dell'esempio, copiare il codice nella classe ThisAddIn in un progetto di componente aggiuntivo per un'applicazione che supporta riquadri attività personalizzati. Assicurarsi di sostituire il metodo ThisAddIn_Startup predefinito nella classe ThisAddIn con il metodo ThisAddIn_Startup dell'esempio.

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

private void ThisAddIn_Startup(object sender, System.EventArgs e)
{
    myUserControl1 = new MyUserControl();
    myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, 
        "New Task Pane");

    myCustomTaskPane.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionFloating;
    myCustomTaskPane.Height = 500;
    myCustomTaskPane.Width = 500;
    myCustomTaskPane.DockPositionRestrict =
        Office.MsoCTPDockPositionRestrict.msoCTPDockPositionRestrictNoHorizontal;
    myCustomTaskPane.Visible = true;

    myCustomTaskPane.VisibleChanged += 
        new EventHandler(myCustomTaskPane_VisibleChanged);
    myCustomTaskPane.DockPositionChanged += 
        new EventHandler(myCustomTaskPane_DockPositionChanged);
}

private void myCustomTaskPane_DockPositionChanged(object sender, EventArgs e)
{
    Microsoft.Office.Tools.CustomTaskPane taskPane =
        sender as Microsoft.Office.Tools.CustomTaskPane;

    if (taskPane != null)
    {
        if (taskPane.DockPosition ==
            Office.MsoCTPDockPosition.msoCTPDockPositionFloating)
        {
            taskPane.Height = 500;
            taskPane.Width = 500;
        }
    }
}
 
private void myCustomTaskPane_VisibleChanged(object sender, EventArgs e)
{
    Microsoft.Office.Tools.CustomTaskPane taskPane =
        sender as Microsoft.Office.Tools.CustomTaskPane;

    if (taskPane != null)
    {
        if (taskPane.Visible)
        {
            taskPane.DockPosition = 
                Office.MsoCTPDockPosition.msoCTPDockPositionRight;
        }
    }
}

System.Object
  Microsoft.Office.Tools.CustomTaskPane

I membri statici pubblici (Shared in Visual Basic) di questo tipo sono validi per le operazioni multithreading. I membri di istanza non sono garantiti come thread safe.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft