CustomTaskPane.Height Proprietà

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools

Assembly:: 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

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

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à

Int32

Altezza in punti del riquadro attività personalizzato.

Eccezioni

COMException

Il valore della DockPosition proprietà è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionRight o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionLeft quando si tenta di impostare la Height proprietà.-oppure-Si tenta di impostare la Height proprietà nel gestore eventi per l'evento DockPositionChanged o VisibleChanged .

ObjectDisposedException

Il metodo Microsoft.Office.Tools.CustomTaskPane.Dispose di CustomTaskPane è già stato chiamato.

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

Condividi tramite