CustomTaskPane.Height Proprietà

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

Valore della proprietà

Altezza in punti del riquadro attività personalizzato.

Eccezioni

Esempio

Nell'esempio di codice seguente viene creato un riquadro attività personalizzato con un'altezza specificata quando viene visualizzata davanti alla finestra dell'applicazione attiva. Questo esempio di codice fa parte di un esempio più ampio fornito per 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

Commenti

Non utilizzare la Height proprietà se il riquadro attività personalizzato è ancorato a sinistra o a destra della finestra del documento. Se la DockPosition proprietà è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft, la Height proprietà restituisce 0 e genera un'eccezione COMException se si tenta di impostarla.

L'altezza massima dipende dalla posizione del dock. Quando il riquadro attività personalizzato è ancorato alla parte superiore o inferiore della finestra del documento, l'altezza massima è circa la metà dell'altezza dello schermo. Quando il riquadro attività personalizzato è mobile, non esiste alcuna altezza massima.

L'altezza minima dipende da diversi fattori e può cambiare nelle versioni future di Microsoft Office. Se si tenta di impostare la Height proprietà su un valore minore dell'altezza minima, l'applicazione riassegna automaticamente la Height proprietà all'altezza minima.

Si applica a