ControlExtensions.AddVScrollBar - метод (ControlCollection, Range, String)

Статья
08/11/2011

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

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

Синтаксис

'Декларация
<ExtensionAttribute> _
Public Shared Function AddVScrollBar ( _
    controls As ControlCollection, _
    range As Range, _
    name As String _
) As VScrollBar

public static VScrollBar AddVScrollBar(
    this ControlCollection controls,
    Range range,
    string name
)

Параметры

controls
Тип: Microsoft.Office.Tools.Excel.ControlCollection
Коллекция, в которую добавляется элемент управления.Не формируйте значение этого параметра самостоятельно.При вызове этого метода для коллекции, возвращаемой свойством Worksheet.Controls (в проекте уровня приложения) или свойством WorksheetBase.Controls (в проекте уровня документа), данный параметр предоставляется автоматически.

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

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

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

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

Примечание об использовании

В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа ControlCollection. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе Методы расширения (Visual Basic) или Методы расширения (Руководство по программированию в C#).

Исключения

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

Заметки

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

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

Примеры

В следующем примере кода добавляется элемент управления VScrollBar в ячейки A1 до A8, и затем перемещается ползунок в центр полосы прокрутки. Чтобы использовать этот пример, запустите его из класса Sheet1 в проекте уровня документа.

Private Sub ExcelRangeAddVScrollBar()
    Dim VScrollBar1 As Microsoft.Office.Tools. _
        Excel.Controls.VScrollBar = Me.Controls. _
        AddVScrollBar(Me.Range("A1", "A8"), _
        "VScrollBar1")

    VScrollBar1.Value = 50

End Sub

private void ExcelRangeAddVScrollBar()
{
    Microsoft.Office.Tools.Excel.Controls.VScrollBar
        vScrollBar1 = this.Controls.AddVScrollBar(
        this.Range["A1", "A8"], "vScrollBar1");
    vScrollBar1.Value = 50;
}

Безопасность платформы .NET Framework

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

См. также

Ссылки

ControlExtensions Класс

AddVScrollBar - перегрузка

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через