Proprietà CustomTaskPane.Height

  • Articolo

Ottiene o imposta l'altezza in punti del riquadro attività personalizzato.

Spazio dei nomi:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
Property Height As Integer
    Get
    Set

int Height { get; set; }

Valore proprietà

Tipo: System.Int32
Altezza in punti del riquadro attività personalizzato.

Eccezioni

Eccezione Condizione
COMException

Il valore della proprietà DockPosition è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft quando si tenta di impostare la proprietà Height.

In alternativa

Si tenta di impostare la proprietà Height nel gestore dell'evento DockPositionChanged o VisibleChanged.
ObjectDisposedException

Il metodo Dispose() della classe CustomTaskPane è già stato chiamato.

Note

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

L'altezza massima dipende dalla posizione di ancoraggio. Quando il riquadro attività personalizzato è ancorato in alto o in basso nella finestra del documento, l'altezza massima è approssimativamente la metà dell'altezza dello schermo. Quando il riquadro attività personalizzato è mobile, non esiste un'altezza massima.

L'altezza minima dipende da diversi fattori e può essere modificata in versioni future di Microsoft Office. Se si tenta di impostare la proprietà Height su un valore inferiore all'altezza minima, l'applicazione riassegnerà automaticamente la proprietà Height all'altezza minima.

Esempi

Nell'esempio di codice seguente viene creato un riquadro attività personalizzato che ha un'altezza specifica quando visualizzato davanti alla finestra dell'applicazione attiva. Questo esempio di codice fa parte di un esempio più esaustivo fornito per 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);
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

CustomTaskPane Interfaccia

Spazio dei nomi Microsoft.Office.Tools