ControlExtensions.AddMonthCalendar – metoda (ControlCollection, Range, Single, Single, String)

Článek
05/14/2013

Přidá novou MonthCalendar dokument v určené velikosti a umístění ovládacího prvku.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word.v4.0.Utilities (v Microsoft.Office.Tools.Word.v4.0.Utilities.dll)

Syntaxe

'Deklarace
<ExtensionAttribute> _
Public Shared Function AddMonthCalendar ( _
    controls As ControlCollection, _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As MonthCalendar

public static MonthCalendar AddMonthCalendar(
    this ControlCollection controls,
    Range range,
    float width,
    float height,
    string name
)

Parametry

controls
Typ: Microsoft.Office.Tools.Word.ControlCollection
Kolekce pro přidání ovládacího prvku.Nezadávejte tento parametr sami.Při volání této metody v kolekci vrácenou Document.Controls vlastností (v projektu aplikace application-level) nebo DocumentBase.Controls vlastnosti (v úrovni dokumentů projektu), je tento parametr zadán automaticky.

range
Typ: Microsoft.Office.Interop.Word.Range
Umístění ovládacího prvku.

width
Typ: System.Single
Šířku ovládacího prvku v bodech.

height
Typ: System.Single
Výška ovládacího prvku v bodech.

name
Typ: System.String
Název, který lze použít k indexování ovládacího prvku v ControlCollection instance.

Vrácená hodnota

Typ: Microsoft.Office.Tools.Word.Controls.MonthCalendar
Ovládací prvek, který byl přidán do dokumentu.

Poznámka k použití

V jazycích Visual Basic a C# lze tuto metodu volat jako metodu instance libovolného objektu typu ControlCollection. Pokud k volání této metody použijete syntaxi metody instance, vynechejte první parametr. Další informace naleznete v tématech Rozšíření metody (Visual Basic) a Rozšíření metody (Příručka programování C#).

Výjimky

Výjimka	Podmínka
ArgumentNullException	name Nebo range argument je nullodkaz null (Nothing v jazyce Visual Basic), nebo name argument má nulovou délku.
ControlNameAlreadyExistsException	Ovládací prvek se stejným názvem je již ControlCollection instance.
InvalidRangeException	Rozsah, který byl určen není platný.

Poznámky

Tato metoda umožňuje přidat MonthCalendar objekty na konec ControlCollection.

Chcete-li odebrat MonthCalendar ovládací prvek, který byl přidán programově, použijte Remove metoda.

Příklady

Následující příklad kódu přidává MonthCalendar první odstavec v dokumentu a poté nastaví vlastnost ovládacího prvku FirstDayOfWeek vlastnost pro pondělí.Chcete-li použít tento příklad, spusťte jej z ThisDocument třídy v projektu na úrovni dokumentu.

Private Sub WordRangeAddMonthCalendar()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim MonthCalendar1 As Microsoft.Office.Tools.Word. _
        Controls.MonthCalendar = Me.Controls.AddMonthCalendar( _
        Me.Paragraphs(1).Range, 75, 15, "MonthCalendar1")
    MonthCalendar1.FirstDayOfWeek = System.Windows.Forms.Day.Monday
End Sub

private void WordRangeAddMonthCalendar()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.MonthCalendar
         monthCalendar1 = this.Controls.AddMonthCalendar(
         this.Paragraphs[1].Range, 75, 15, "monthCalendar1");
    monthCalendar1.FirstDayOfWeek = System.Windows.Forms.Day.Monday;
}

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é

Referenční dokumentace

ControlExtensions Třída

AddMonthCalendar – přetížení

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím