CustomTaskPane.Width-Eigenschaft

Ruft die Breite des benutzerdefinierten Aufgabenbereichs in Punkt ab oder legt diese fest.

Namespace:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Syntax

'Declaration
Property Width As Integer

int Width { get; set; }

Eigenschaftswert

Typ: System.Int32
Die Breite des benutzerdefinierten Aufgabenbereichs in Punkt.

Ausnahmen

Hinweise

Verwenden Sie nicht die Width-Eigenschaft, wenn der benutzerdefinierte Aufgabenbereich an den oberen oder unteren Rand des Dokumentfensters angedockt ist.Wenn die DockPosition-Eigenschaft Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop oder Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom ist, gibt die Width-Eigenschaft 0 zurück und löst eine COMException aus, wenn Sie sie festzulegen versuchen.

Die maximale Breite hängt von der Dockposition ab.Wenn der benutzerdefinierte Aufgabenbereich an der linken oder rechten Seite des Dokumentfensters angedockt ist, beträgt die maximale Breite die halbe Bildschirmbreite.Wenn der benutzerdefinierte Aufgabenbereich unverankert ist, gibt es keine maximale Breite.

Die Mindestbreite hängt von mehreren Faktoren ab und kann sich in zukünftigen Versionen von Microsoft Office ändern.Wenn Sie versuchen, die Width-Eigenschaft auf einen kleineren Wert als die minimale Breite festzulegen, weist die Anwendung der Width-Eigenschaft automatisch erneut die minimale Breite zu.

Beispiele

Mit dem folgenden Codebeispiel wird ein benutzerdefinierter Aufgabenbereich erstellt, der unterschiedliche Standardbreiten aufweist, je nachdem, ob er vor dem aktiven Anwendungsfenster angezeigt wird oder links oder rechts im Fenster angedockt ist.Dieses Codebeispiel ist Teil eines umfangreicheren Beispiels zu 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);
}

.NET Framework-Sicherheit

• Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

CustomTaskPane Schnittstelle

Microsoft.Office.Tools-Namespace