CustomTaskPane.Height – vlastnost

Článek
01/03/2014

Získá nebo nastaví výšku vlastní podokno úloh, v bodech.

Obor názvů: Microsoft.Office.Tools
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

'Deklarace
Property Height As Integer

int Height { get; set; }

Hodnota vlastnosti

Typ: System.Int32
Výška vlastní podokno úloh, v bodech.

Výjimky

Výjimka	Podmínka
COMException	Hodnota DockPosition vlastnost je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft při pokusu nastavit Height vlastnost. -nebo- Pokusíte se nastavit Height v obslužné rutině události pro vlastnost DockPositionChanged nebo VisibleChanged události.
ObjectDisposedException	Dispose Metoda CustomTaskPane již byla volána.

COMException

Hodnota DockPosition vlastnost je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft při pokusu nastavit Height vlastnost.

-nebo-

Pokusíte se nastavit Height v obslužné rutině události pro vlastnost DockPositionChanged nebo VisibleChanged události.

ObjectDisposedException

Dispose Metoda CustomTaskPane již byla volána.

Poznámky

Nepoužívejte Height vlastnost, pokud vlastní podokno úloh je ukotven na levé nebo pravé straně okna dokumentu.Pokud DockPosition vlastnost je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, Height vlastnost vrátí hodnotu 0 a vyvolá COMException při pokusu nastavit jej.

Maximální výška závisí na pozici doku.Při vlastní podokno úloh je ukotven na horní nebo dolní části okna dokumentu, maximální výška je přibližně poloviční výšku obrazovky.Při vlastní podokno úloh je plovoucí, není žádná maximální výšku.

Minimální výška závisí na několika faktorech a můžete změnit v budoucích verzích sady Microsoft Office.Pokud se pokusíte nastavit Height vlastnost na hodnotu, která je menší než minimální výška aplikace budou automaticky přiřadí Height vlastnost na minimální výšku.

Příklady

Následující příklad kódu vytvoří vlastní podokno úloh, který má zadaná výška při zobrazení před okna aktivní aplikace.Tento příklad kódu je součástí většího příkladu určeného pro 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);
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

CustomTaskPane Rozhraní

Microsoft.Office.Tools – obor názvů

Sdílet prostřednictvím