Proprietà CustomTaskPane.DockPosition

Ottiene o imposta un valore che specifica la posizione del riquadro attività personalizzato rispetto alla finestra dell'applicazione.

Spazio dei nomi:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
Property DockPosition As MsoCTPDockPosition

MsoCTPDockPosition DockPosition { get; set; }

Valore proprietà

Tipo: Microsoft.Office.Core.MsoCTPDockPosition
Uno dei valori di Microsoft.Office.Core.MsoCTPDockPosition.Il valore predefinito è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Eccezioni

Eccezione	Condizione
ObjectDisposedException	Il metodo Dispose della classe CustomTaskPane è già stato chiamato.
COMException	Il valore della proprietà DockPositionRestrict è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange quando si tenta di modificare il valore della proprietà DockPosition. In alternativa Si tenta di impostare questa proprietà nel gestore dell'evento DockPositionChanged o VisibleChanged.

Note

Nella tabella seguente sono inclusi i valori dell'enumerazione Microsoft.Office.Core.MsoCTPDockPosition.

Valore	Descrizione
msoCTPDockPositionLeft	Il riquadro attività personalizzato viene ancorato al lato sinistro della finestra.
msoCTPDockPositionTop	Il riquadro attività personalizzato viene ancorato al lato superiore della finestra.
msoCTPDockPositionRight	Il riquadro attività personalizzato viene ancorato al lato destro della finestra.
msoCTPDockPositionBottom	Il riquadro attività personalizzato viene ancorato al lato inferiore della finestra.
msoCTPDockPositionFloating	Visualizza il riquadro attività personalizzato davanti alla finestra.L'utente può trascinare il riquadro attività in qualsiasi posizione nella finestra.

Esempi

Nell'esempio di codice seguente viene creato un riquadro attività personalizzato e vengono configurate dimensioni predefinite diverse da utilizzare quando il riquadro è visualizzato davanti alla finestra dell'applicazione attiva e quando è ancorato.Questo esempio di codice fa parte di un esempio più esaustivo fornito per CustomTaskPane.

Private myUserControl1 As MyUserControl
Private WithEvents myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane

Private Sub ThisAddIn_Startup(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles Me.Startup

    myUserControl1 = New MyUserControl()
    myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "New Task Pane")

    With myCustomTaskPane
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionFloating
        .Height = 500
        .Width = 500
        .DockPosition = Office.MsoCTPDockPosition.msoCTPDockPositionRight
        .Width = 300
        .Visible = True
    End With
End Sub

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.DockPosition =
        Office.MsoCTPDockPosition.msoCTPDockPositionRight;
    myCustomTaskPane.Width = 300;

    myCustomTaskPane.Visible = true;
    myCustomTaskPane.DockPositionChanged +=
        new EventHandler(myCustomTaskPane_DockPositionChanged);
}

Sicurezza di .NET Framework

• Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

CustomTaskPane Interfaccia

Spazio dei nomi Microsoft.Office.Tools