CustomTaskPane.Width A propriedade (sistema de 2007)
Obtém ou define a largura da personalizado tarefa painel, em pontos.
Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common.v9.0 (em Microsoft.Office.Tools.Common.v9.0.dll)
Sintaxe
Public Property Width As Integer
Dim instance As CustomTaskPane
Dim value As Integer
value = instance.Width
instance.Width = value
public int Width { get; set; }
Valor de propriedade
Tipo: System.Int32
A largura da personalizado tarefa painel, em pontos.
Exceções
Exceção | Condição |
---|---|
COMException | O valor de DockPosition propriedade é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom Quando você tentar conjunto o Width propriedade. - ou - Você tentar conjunto o Width propriedade no manipulador de eventos para o DockPositionChanged ou VisibleChanged evento. |
ObjectDisposedException | The Dispose método para o CustomTaskPane já foi chamado. |
Comentários
Não use o Width propriedade se personalizado tarefa painel é encaixado na parte superior ou inferior da janela do documento. Se o DockPosition propriedade é Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop ou Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, o Width propriedade retornará 0 e lança um COMException Se você tentar defini-la.
Exemplos
O exemplo de código a seguir cria um personalizado tarefa painel que tenha uma largura padrão diferente quando ele for exibido na frente da janela do aplicativo ativo e quando ela estiver encaixada à esquerda ou direita da janela.Este exemplo de código é parte de um exemplo maior fornecido para a classe CustomTaskPane.
Private myUserControl1 As MyUserControl
PrivateWithEvents myCustomTaskPane As Microsoft.Office.Tools.CustomTaskPane
PrivateSub ThisAddIn_Startup(ByVal sender AsObject, ByVal e As System.EventArgs) _
HandlesMe.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 = TrueEndWithEndSub
private MyUserControl myUserControl1;
private Microsoft.Office.Tools.CustomTaskPane myCustomTaskPane;
privatevoid 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);
}
Permissões
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.