CustomTaskPane.Width 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 la larghezza in punti del riquadro attività personalizzato.

public:
 property int Width { int get(); void set(int value); };

public int Width { get; set; }

member this.Width : int with get, set

Public Property Width As Integer

Valore della proprietà

Int32

Larghezza in punti del riquadro attività personalizzato.

Eccezioni

COMException

Il valore della DockPosition proprietà è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom quando si tenta di impostare la proprietà.-or-You prova a impostare la Width proprietà nel gestore eventi per l'evento Width DockPositionChanged oVisibleChanged.

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 larghezza predefinita diversa quando viene visualizzato davanti alla finestra dell'applicazione attiva e quando viene ancorato a sinistra o a destra della finestra. Questo esempio di codice fa parte di un esempio più grande 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 usare la Width proprietà se il riquadro attività personalizzato viene ancorato all'inizio o alla parte inferiore della finestra del documento. Se la proprietà è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, la Width DockPosition proprietà restituisce 0 e genera un COMException se si tenta di impostarlo.

La larghezza massima dipende dalla posizione del ancoraggio. Quando il riquadro attività personalizzato viene ancorato a sinistra o a destra della finestra del documento, la larghezza massima è circa la metà della larghezza dello schermo. Quando il riquadro attività personalizzato è mobile, non esiste alcuna larghezza massima.

La larghezza minima dipende da diversi fattori e può cambiare nelle versioni future di Microsoft Office. Se si tenta di impostare la Width proprietà su un valore minore della larghezza minima, l'applicazione riassegna automaticamente la Width proprietà sulla larghezza minima.

Si applica a

Condividi tramite