ControlCollection.AddDateTimePicker Метод (Range, String) (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Добавляет в указанный диапазон листа новый элемент управления DateTimePicker.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel.v9.0 (в Microsoft.Office.Tools.Excel.v9.0.dll)

Синтаксис

'Декларация
Public Function AddDateTimePicker ( _
    range As Range, _
    name As String _
) As DateTimePicker
'Применение
Dim instance As ControlCollection
Dim range As Range
Dim name As String
Dim returnValue As DateTimePicker

returnValue = instance.AddDateTimePicker(range, _
    name)

public DateTimePicker AddDateTimePicker(
    Range range,
    string name
)

Параметры

range
Тип: Microsoft.Office.Interop.Excel.Range
Объект Range, предоставляющий границы элемента управления.

name
Тип: System.String
Имя элемента управления, которое можно использовать для индексации элемента управления в экземпляре ControlCollection.

Возвращаемое значение

Тип: Microsoft.Office.Tools.Excel.Controls.DateTimePicker
Элемент управления DateTimePicker, добавленный в экземпляр ControlCollection.

Исключения

Исключение	Условие
ArgumentNullException	Аргумент имени или диапазона равен nullссылка null (Nothing в Visual Basic), или аргумент имени имеет нулевую длину.
ControlNameAlreadyExistsException	Элемент управления с таким именем уже имеется в данном экземпляре ControlCollection.
InvalidRangeException	Указанный диапазон не существует. Невозможно использовать диапазоны с несколькими областями. Диапазон должен находиться на том же листе, что и экземпляр ControlCollection.

Заметки

Метод AddDateTimePicker используется для добавления объектов DateTimePicker в конец ControlCollection. Чтобы удалить добавленный программно объект DateTimePicker, воспользуйтесь методом Remove().

Размер элемента управления автоматически изменяется при изменении размера диапазона.

Примеры

В следующем примере кода добавляется элемент управления DateTimePicker в ячейки A1 до C1, и затем устанавливается светло-голубой фон календаря.

Private Sub ExcelRangeAddDateTimePicker()

    Dim DateTimePicker1 As Microsoft.Office.Tools. _
        Excel.Controls.DateTimePicker = Me.Controls. _
        AddDateTimePicker(Me.Range("A1", "C1"), _
        "DateTimePicker1")
    DateTimePicker1.CalendarMonthBackground = _
        Color.LightBlue

End Sub

private void ExcelRangeAddDateTimePicker()
{

    Microsoft.Office.Tools.Excel.Controls.DateTimePicker
        dateTimePicker1 = this.Controls.AddDateTimePicker(
        this.Range["A1", "C1"], "dateTimePicker1");
    dateTimePicker1.CalendarMonthBackground = Color.LightBlue;
}

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.