Właściwość CustomTaskPane.Height —

Pobiera lub ustawia wysokooć 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 ustawić 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 zadokowana w lewo lub po prawej stronie 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 podczas próby ustawić go.

Maksymalna wysokość zależy od położenia dokowania.Gdy niestandardowe okienko zadań jest zadokowany u góry lub u dołu okna dokumentu, maksymalna wysokość wynosi około pół wysokości ekranu.Jeśli niestandardowe okienko zadań jest zmienny, nie ma żadnych maksymalna wysokość.

Minimalna wysokość zależy od kilku czynników, a także 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 będzie automatycznie przypisać Height właściwość, aby wysokość minimalna.

Przykłady

Poniższy przykład kodu tworzy niestandardowe okienko zadań, który ma określonej wysokości w przypadku wyświetlenia przed oknem aktywnej aplikacji.Ten 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 Przy użyciu bibliotek z częściowo zaufanego kodu..

Zobacz też

Informacje

CustomTaskPane Interfejs

Przestrzeń nazw Microsoft.Office.Tools