ControlCollection.AddDateTimePicker-Methode (Range, Single, Single, String) (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Fügt dem Dokument an der angegebenen Position ein neues DateTimePicker-Steuerelement in der angegebenen Größe hinzu.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word.v9.0 (in Microsoft.Office.Tools.Word.v9.0.dll)

Syntax

'Declaration
Public Function AddDateTimePicker ( _
    range As Range, _
    width As Single, _
    height As Single, _
    name As String _
) As DateTimePicker
'Usage
Dim instance As ControlCollection
Dim range As Range
Dim width As Single
Dim height As Single
Dim name As String
Dim returnValue As DateTimePicker

returnValue = instance.AddDateTimePicker(range, _
    width, height, name)

public DateTimePicker AddDateTimePicker(
    Range range,
    float width,
    float height,
    string name
)

Parameter

range
Typ: Microsoft.Office.Interop.Word.Range

Ein Range, der die Position des Steuerelements angibt.

width
Typ: System.Single

Die Breite des Steuerelements in Punkt.

height
Typ: System.Single

Die Höhe des Steuerelements in Punkt.

name
Typ: System.String

Der Name, der zum Indizieren des Steuerelements in der ControlCollection-Instanz verwendet werden kann.

Rückgabewert

Typ: Microsoft.Office.Tools.Word.Controls.DateTimePicker

Das DateTimePicker-Steuerelement, das der ControlCollection-Instanz hinzugefügt wurde.

Ausnahmen

Ausnahme	Bedingung
ArgumentNullException	Das name-Argument oder das range-Argument ist nullNULL-Verweis (Nothing in Visual Basic), oder das name-Argument hat die Länge 0 (null).
ControlNameAlreadyExistsException	Ein Steuerelement mit dem gleichen Namen ist bereits in der ControlCollection-Instanz vorhanden.
InvalidRangeException	Der angegebene Bereich ist nicht gültig.

Hinweise

Mithilfe dieser Methode können Sie DateTimePicker-Objekte am Ende der ControlCollection hinzufügen.

Um eine DateTimePicker zu entfernen, die programmgesteuert hinzugefügt wurde, verwenden Sie die Remove-Methode.

Beispiele

Im folgenden Codebeispiel wird im ersten Absatz des Dokuments ein DateTimePicker-Steuerelement hinzugefügt. Anschließend wird die Hintergrundfarbe des Kalenders auf Hellblau festgelegt.

Private Sub WordRangeAddDateTimePicker()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Dim DateTimePicker1 As Microsoft.Office.Tools.Word. _
        Controls.DateTimePicker = Me.Controls.AddDateTimePicker( _
        Me.Paragraphs(1).Range, 150, 15, "DateTimePicker1")
    DateTimePicker1.CalendarMonthBackground = Color.LightBlue

End Sub

private void WordRangeAddDateTimePicker()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Microsoft.Office.Tools.Word.Controls.DateTimePicker
        dateTimePicker1 = this.Controls.AddDateTimePicker(
        this.Paragraphs[1].Range, 150, 15, "dateTimePicker1");
    dateTimePicker1.CalendarMonthBackground = Color.LightBlue;
}

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.