CustomTaskPane.Width – vlastnost

Článek
08/11/2011

Získá nebo nastaví šířku úloha podoknov bodech.

Obor názvů: Microsoft.Office.Tools
Sestavení: Microsoft.Office.Tools.Common (v Microsoft.Office.Tools.Common.dll)

Syntaxe

'Deklarace
Property Width As Integer
    Get
    Set

int Width { get; set; }

Hodnota vlastnosti

Typ: System.Int32
Šířka úloha podoknov bodech.

Výjimky

Výjimka	Podmínka
COMException	Hodnota DockPosition vlastnost je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom Při pokusu nastavit Width vlastnost. -nebo- Zkuste nastavit Width v obslužné rutině události pro vlastnost DockPositionChanged nebo VisibleChanged událostí.
ObjectDisposedException	Dispose()metoda CustomTaskPane již byla volána.

COMException

Hodnota DockPosition vlastnost je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom Při pokusu nastavit Width vlastnost.

-nebo-

Zkuste nastavit Width v obslužné rutině události pro vlastnost DockPositionChanged nebo VisibleChanged událostí.

ObjectDisposedException

Dispose()metoda CustomTaskPane již byla volána.

Poznámky

Nepoužívejte Widthvlastnost Pokud vlastní úlohapodokno ukotveno horní nebo dolní části okno dokumentu. Pokud DockPosition vlastnost je Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionTop nebo Microsoft.Office.Core.MsoCTPDockPosition.msoCTPDockPositionBottom, Width vlastnost vrátí hodnotu 0 a vyvolá COMException Při pokusu nastavit jej.

Maximální šířka závisí na umístění ukotvit . Při úlohapodokno vlevo nebo vpravo od okno dokumentuukotven, maximální šířka je přibližně polovinu šířky obrazovky. Pokud plovoucí úloha podokno neexistuje žádná maximální šířka.

Minimální šířka závisí na několika faktorech a můžete změnit v budoucích verzích systém Microsoft Office. Pokud se pokusíte nastavit Width vlastnost na hodnotu, která je menší než minimální šířka aplikace budou automaticky přiřadit Width vlastnost minimální šířku.

Příklady

Následující příklad kódu vytvoří vlastní úlohapodokno obsahující různé výchozí šířku při zobrazení z aplikaceaktivníoknoa ukotven na levé nebo pravé straně okno. Příklad kódu je součástí větší příklad k 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);
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Odkaz

CustomTaskPane Rozhraní

Microsoft.Office.Tools – obor názvů

Sdílet prostřednictvím