CustomTaskPane.Height Vlastnost

Reference

Definice

Obor názvů:: Microsoft.Office.Tools

Sestavení:: 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

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví výšku vlastního podokna úloh v bodech.

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

Hodnota vlastnosti

Int32

Výška vlastního podokna úloh v bodech

Výjimky

COMException

Hodnota DockPosition vlastnosti je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft při pokusu Height o nastavení vlastnosti.-or-Pokusíte se nastavit Height vlastnost v obslužné rutině události pro DockPositionChanged událost nebo VisibleChanged události.

ObjectDisposedException

Metoda Microsoft.Office.Tools.CustomTaskPane.Dispose již CustomTaskPane byla volána.

Příklady

Následující příklad kódu vytvoří vlastní podokno úloh, které má zadanou výšku, když se zobrazí před aktivním oknem aplikace. Tento příklad kódu je součástí většího příkladu pro 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

Poznámky

Vlastnost nepoužívejte, Height pokud je vlastní podokno úloh ukotvené v levé nebo pravé části okna dokumentu. DockPosition Pokud je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight vlastnost nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, Height vrátí tato vlastnost hodnotu 0 a vyvolá hodnotu , COMException pokud se ji pokusíte nastavit.

Maximální výška závisí na poloze doku. Když je vlastní podokno úloh ukotvené v horní nebo dolní části okna dokumentu, je maximální výška přibližně poloviční než výška obrazovky. Když je vlastní podokno úloh plovoucí, není k dispozici žádná maximální výška.

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

Platí pro

Sdílet prostřednictvím