Proprietà CustomTaskPane.Width
Ottiene o imposta la larghezza 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 Width As Integer
Get
Set
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. In alternativa 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.
La larghezza massima dipende dalla posizione di ancoraggio. Quando il riquadro attività personalizzato è ancorato al lato destro o sinistro della finestra del documento, la larghezza massima è approssimativamente la metà della larghezza dello schermo. Quando il riquadro attività personalizzato è mobile, non esiste una larghezza massima.
La larghezza minima dipende da diversi fattori e può essere modificata in versioni future di Microsoft Office. Se si tenta di impostare la proprietà Width su un valore inferiore alla larghezza minima, l'applicazione riassegnerà automaticamente la proprietà Width alla larghezza minima.
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 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
- 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.