Proprietà CustomTaskPane.Width (System 2007)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Ottiene o imposta la larghezza in punti del riquadro attività personalizzato.

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

Sintassi

Public Property Width As Integer

Dim instance As CustomTaskPane
Dim value As Integer

value = instance.Width

instance.Width = value

public int Width { get; set; }

Valore proprietà

Tipo: System.Int32

Larghezza in punti del riquadro attività personalizzato.

Eccezioni

Eccezione	Condizione
COMException	Il valore della proprietà DockPosition è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom quando si tenta di impostare la proprietà Width. -oppure- Si tenta di impostare la proprietà Width nel gestore dell'evento DockPositionChanged o VisibleChanged.
ObjectDisposedException	Il metodo Dispose della classe CustomTaskPane è già stato chiamato.

COMException

Il valore della proprietà DockPosition è Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop o Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom quando si tenta di impostare la proprietà Width.

-oppure-

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

ObjectDisposedException

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

Note

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

Esempi

Nell'esempio di codice seguente viene creato un riquadro attività personalizzato che ha una larghezza predefinita diversa quando viene visualizzato davanti alla finestra dell'applicazione attiva e quando è ancorato a sinistra o a destra della finestra. Questo esempio di codice fa parte di un esempio più esaustivo fornito per la classe 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);
}

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

CustomTaskPane Classe

Membri CustomTaskPane

Spazio dei nomi Microsoft.Office.Tools

Condividi tramite