Właściwość CustomTaskPane.Height —
Pobiera lub Ustawia wysokość niestandardowe okienko zadań, w punktach.
Przestrzeń nazw: Microsoft.Office.Tools
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)
Składnia
'Deklaracja
Property Height As Integer
int Height { get; set; }
Wartość właściwości
Typ: System.Int32
Wysokość niestandardowe okienko zadań, w punktach.
Wyjątki
| Wyjątek | Warunek |
|---|---|
| COMException | Wartość DockPosition właściwość jest Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight lub Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft podczas próby zestaw Height właściwość. -lub- Spróbuj ustawić Height właściwość w procedurze obsługi zdarzenia dla DockPositionChanged lub VisibleChanged zdarzenia. |
| ObjectDisposedException | Dispose Metoda CustomTaskPane została już wywołana. |
Uwagi
Nie należy używać Height właściwość, jeśli niestandardowe okienko zadań jest zadokowane po lewej lub z prawej strony okna dokumentu.Jeśli DockPosition właściwość jest Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight lub Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, Height właściwość zwraca wartość 0 i rzuca COMException Jeśli spróbujesz ustawić go.
Maksymalna wysokość zależy od położenia dokowania.Gdy niestandardowe okienko zadań jest zadokowany na górze lub na dole okna dokumentu, maksymalna wysokość wynosi około pół wysokości ekranu.Niestandardowe okienko zadań jest ruchomy, nie ma żadnych maksymalnej wysokości.
Minimalna wysokość zależy od kilku czynników, a można zmienić w przyszłych wersjach pakietu Microsoft Office.Jeśli spróbujesz ustawić Height właściwość na wartość, która jest mniejsza niż minimalna wysokość, aplikacja automatycznie spowoduje ponowne przypisanie Height właściwość minimalna wysokość.
Przykłady
Poniższy przykład kodu tworzy niestandardowe okienko zadań, który ma określonej wysokości, gdy są wyświetlane przed oknem aktywnej aplikacji.Poniższy przykład kodu jest częścią większy przykład przewidziane 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);
}
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.