CustomTaskPane.Width Proprietà

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à

Larghezza in punti del riquadro attività personalizzato.

Eccezioni

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 WidthDockPosition 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