CustomTaskPane.Width Eigenschaft
Definition
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 die Breite des benutzerdefinierten Aufgabenbereichs in Punkt ab oder legt diese fest.
public:
property int Width { int get(); void set(int value); };public int Width { get; set; }member this.Width : int with get, setPublic Property Width As IntegerEigenschaftswert
Die Breite des benutzerdefinierten Aufgabenbereichs in Punkt.
Ausnahmen
Der Wert der DockPosition Eigenschaft ist Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop oder Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, wenn Sie versuchen, die Width Eigenschaft festzulegen.-or-Sie versuchen, die Width Eigenschaft im Ereignishandler für das DockPositionChanged -Ereignis oder VisibleChanged -Ereignis festzulegen.
Die Microsoft.Office.Tools.CustomTaskPane.Dispose-Methode von CustomTaskPane wurde bereits aufgerufen.
Beispiele
Im folgenden Codebeispiel wird ein benutzerdefinierter Aufgabenbereich erstellt, der eine andere Standardbreite aufweist, wenn er vor dem aktiven Anwendungsfenster angezeigt wird und wenn er links oder rechts des Fensters 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
Verwenden Sie die Width -Eigenschaft nicht, wenn der benutzerdefinierte Aufgabenbereich oben oder unten im Dokumentfenster angedockt ist. Wenn die DockPosition Eigenschaft oder Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottomistMicrosoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop, gibt die Width Eigenschaft 0 zurück und löst einen ausCOMException, wenn Sie versuchen, sie festzulegen.
Die maximale Breite hängt von der Dockposition ab. Wenn der benutzerdefinierte Aufgabenbereich links oder rechts neben dem Dokumentfenster angedockt ist, beträgt die maximale Breite etwa die Hälfte der Bildschirmbreite. Wenn der benutzerdefinierte Aufgabenbereich schwebt, 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 Wert festzulegen, der kleiner als die Mindestbreite ist, weist die Anwendung die Width Eigenschaft automatisch der Mindestbreite neu zu.