CustomTaskPane.DockPosition Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.Office.Tools
Assembly:
Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Outlook.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

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

public:
 property Microsoft::Office::Core::MsoCTPDockPosition DockPosition { Microsoft::Office::Core::MsoCTPDockPosition get(); void set(Microsoft::Office::Core::MsoCTPDockPosition value); };
public Microsoft.Office.Core.MsoCTPDockPosition DockPosition { get; set; }
member this.DockPosition : Microsoft.Office.Core.MsoCTPDockPosition with get, set
Public Property DockPosition As MsoCTPDockPosition

Valore della proprietà

MsoCTPDockPosition

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

Eccezioni

ObjectDisposedException

Il metodo Microsoft.Office.Tools.CustomTaskPane.Dispose di CustomTaskPane è già stato chiamato.

COMException

Il valore della DockPositionRestrict proprietà è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange quando si tenta di modificare il valore della DockPosition proprietà.-oppure-Si tenta di impostare questa proprietà nel gestore eventi per l'evento DockPositionChanged o VisibleChanged .

Esempio

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

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);
}

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

Commenti

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

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

Si applica a