CustomTaskPane.Height Właściwość

Odwołanie

Definicja

Przestrzeń nazw:: Microsoft.Office.Tools

Zestawy:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll, Microsoft.Office.Tools.Excel.v4.0.Utilities.dll, Microsoft.Office.Tools.Outlook.v4.0.Utilities.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Pobiera lub ustawia wysokość niestandardowego okienka zadań w punktach.

public:
 property int Height { int get(); void set(int value); };

public int Height { get; set; }

member this.Height : int with get, set

Public Property Height As Integer

Wartość właściwości

Int32

Wysokość niestandardowego okienka zadań w punktach.

Wyjątki

COMException

Wartość właściwości to Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight lub Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft podczas próby ustawienia Height właściwości.-or-- Spróbuj ustawić Height właściwość w procedurze obsługi zdarzeń dla DockPositionChanged zdarzenia lubVisibleChanged.DockPosition

ObjectDisposedException

CustomTaskPane Metoda Microsoft.Office.Tools.CustomTaskPane.Dispose metody została już wywołana.

Przykłady

Poniższy przykład kodu tworzy niestandardowe okienko zadań, które ma określoną wysokość, gdy jest wyświetlana przed aktywnym oknem aplikacji. Ten przykład kodu jest częścią większego przykładu podanego dla CustomTaskPaneelementu .

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

Uwagi

Nie używaj właściwości, Height jeśli niestandardowe okienko zadań jest zadokowane po lewej stronie lub po prawej stronie okna dokumentu. DockPosition Jeśli właściwość ma wartość Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight lub Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, Height właściwość zwraca wartość 0 i zgłasza COMException wartość , jeśli spróbujesz ją ustawić.

Maksymalna wysokość zależy od położenia doku. Gdy niestandardowe okienko zadań jest zadokowane do góry lub dolnej części okna dokumentu, maksymalna wysokość wynosi około połowy wysokości ekranu. Gdy okienko zadań niestandardowych jest przestawne, nie ma maksymalnej wysokości.

Minimalna wysokość zależy od kilku czynników i może ulec zmianie w przyszłych wersjach pakietu Microsoft Office. Jeśli spróbujesz ustawić Height właściwość na wartość mniejszą niż minimalna wysokość, aplikacja automatycznie przypisze Height właściwość do minimalnej wysokości.

Dotyczy

Udostępnij za pośrednictwem