Freigeben über


CustomTaskPane.Width-Eigenschaft (2007 System)

Aktualisiert: November 2007

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

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

Syntax

Public Property Width As Integer

Dim instance As CustomTaskPane
Dim value As Integer

value = instance.Width

instance.Width = value
public int Width { get; set; }

Eigenschaftenwert

Typ: System.Int32

Die Breite des benutzerdefinierten Aufgabenbereichs in Punkt.

Ausnahmen

Ausnahme Bedingung
COMException

Der Wert der DockPosition-Eigenschaft ist Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop oder Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, wenn Sie die Width-Eigenschaft festzulegen versuchen.

- oder -

Sie versuchen, die Width-Eigenschaft im Ereignishandler für das DockPositionChanged-Ereignis oder das VisibleChanged-Ereignis festzulegen.

ObjectDisposedException

Die Dispose-Methode des CustomTaskPane wurde bereits aufgerufen.

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.

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, das für die CustomTaskPane-Klasse bereitgestellt wird.

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

Berechtigungen

Siehe auch

Referenz

CustomTaskPane-Klasse

CustomTaskPane-Member

Microsoft.Office.Tools-Namespace