CustomTaskPane.DockPosition Eigenschaft

Referenz

Definition

Namespace:: Microsoft.Office.Tools

Assemblys:: 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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der die Position des benutzerdefinierten Aufgabenbereichs relativ zum Anwendungsfenster angibt, oder legt diesen fest.

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

Eigenschaftswert

MsoCTPDockPosition

Einer der Microsoft.Office.Core.MsoCTPDockPosition-Werte. Der Standardwert ist Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight.

Ausnahmen

ObjectDisposedException

Die Microsoft.Office.Tools.CustomTaskPane.Dispose-Methode von CustomTaskPane wurde bereits aufgerufen.

COMException

Der Wert der DockPositionRestrict Eigenschaft ist Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRestrictNoChange, wenn Sie versuchen, den Wert der DockPosition Eigenschaft zu ändern.-or-Sie versuchen, diese Eigenschaft im Ereignishandler für das DockPositionChanged -Ereignis oder VisibleChanged -Ereignis festzulegen.

Beispiele

Im folgenden Codebeispiel wird ein benutzerdefinierter Aufgabenbereich erstellt und verschiedene Standardgrößen konfiguriert, wenn der Bereich vor dem aktiven Anwendungsfenster angezeigt wird und angedockt wird. Dieses Codebeispiel ist Teil eines größeren Beispiels für 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

Hinweise

In der folgenden Tabelle sind die Werte der Microsoft.Office.Core.MsoCTPDockPosition -Enumeration aufgeführt.

Wert	Beschreibung
`msoCTPDockPositionLeft`	Dockt den benutzerdefinierten Aufgabenbereich an der linken Seite des Fensters an.
`msoCTPDockPositionTop`	Dockt den benutzerdefinierten Aufgabenbereich am oberen Rand des Fensters an.
`msoCTPDockPositionRight`	Dockt den benutzerdefinierten Aufgabenbereich rechts im Fenster an.
`msoCTPDockPositionBottom`	Dockt den benutzerdefinierten Aufgabenbereich am unteren Rand des Fensters an.
`msoCTPDockPositionFloating`	Zeigt den benutzerdefinierten Aufgabenbereich vor dem Fenster an. Der Benutzer kann den Aufgabenbereich an eine beliebige Stelle im Fenster ziehen.

Gilt für:

Freigeben über