Диапазон ячеек рабочего листа.
Свойства #
Cells #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Список ячеек диапазона.
Cells : List
Значение свойства (ReadOnly)
Тип: List
Список List из ячеек Range, входящих в диапазон.
for each cell in rng1.Cells .... next
Col #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Начальный столбец диапазона.
Col : Integer
Значение свойства (ReadOnly)
Тип: Integer
Индекс первого столбца диапазона, индекс первого столбца - 0.
index = rng1.Col
Cols #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Количество столбцов диапазона.
Cols : Integer
Значение свойства (ReadOnly)
Тип: Integer
Количество столбцов диапазона, индекс первого столбца - 0.
ag.MsgBox rng1.Cols
Dbl #
Поддержка в версии: старше или равно 34.24.2.31.
Описание
Числовое значение ячейки.
Dbl : String
Значение свойства
Тип: String
Double, числовое значение ячейки или null.
ag.MsgBox rng1.Dbl
IsSingleCell #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Определяет, состоит ли диапазон из единственной ячейки.
IsSingleCell : Boolean
Значение свойства (ReadOnly)
Тип: Boolean
True - если диапазон из единственной ячейки и False в противном случае.
ag.MsgBox rng1.IsSingleCell
Row #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Начальная строка диапазона.
Row : Integer
Значение свойства (ReadOnly)
Тип: Integer
Индекс первой строки диапазона, индекс первой строки - 0.
ag.MsgBox rng1.Row
Rows #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Количество строк диапазона.
Rows : Integer
Значение свойства (ReadOnly)
Тип: Integer
Количество строк диапазона, индекс первого столбца - 0.
ag.MsgBox rng1.Rows
Str #
Поддержка в версии: старше или равно 34.24.2.31.
Описание
Текстовое значение ячейки.
Str : String
Значение свойства
Тип: String
Текстовое значение ячейки или null.
ag.MsgBox rng1.Str
TopLeft #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Ячейка верхнего-левого угла диапазона.
TopLeft : Range
Значение свойства (ReadOnly)
Тип: Range
Ячейка верхнего-левого угла диапазона.
ag.MsgBox rng1.TopLeft.Text
Value #
Поддержка в версии: старше или равно 34.24.03.31.
Описание
Значение ячейки.
Value : Variant
Значение свойства
Тип: Variant
Значение ячейки или null.
ag.MsgBox rng1.Value
X #
Поддержка в версии: старше или равно 34.24.3.32.
Описание
Координата X диапазона.
X : Integer
Значение свойства (ReadOnly)
Тип: Integer
Координата X верхнего левого угла диапазона..
ag.MsgBox rng1.X
Y #
Поддержка в версии: старше или равно 34.24.3.32.
Описание
Координата Y диапазона.
Y : Integer
Значение свойства (ReadOnly)
Тип: Integer
Координата Y верхнего левого угла диапазона..
ag.MsgBox rng1.Y
Методы #
GetColSpan #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Список значений ячеек в строке.
GetColSpan ( Count Integer ) : List
Возвращаемое значение
Тип: List
Список List значений ячеек Variant.
Параметры
Count | Integer | Количество ячеек в строке.
|
ag.MsgBox Join(rng1.GetColSpan(3).ToArray, ";")
GetRowSpan #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Список значений ячеек в столбце.
GetRowSpan ( Count Integer ) : List
Возвращаемое значение
Тип: List
Список List значений ячеек Variant.
Параметры
Count | Integer | Количество ячеек в столбце.
|
ag.MsgBox Join(rng1.GetRowSpan(3).ToArray, ";")
Offset #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Ячейка, находящаяся по заданному смещению относительно верхней-левой ячейки диапазона.
Offset ( Rows Integer , Rows Integer ) : Range
Возвращаемое значение
Тип: Range
Ячейка Range.
Параметры
Rows | Integer | Смещение по строкам.
|
Rows | Integer | Смещение по столбцам.
|
ag.MsgBox rng1.Offset(2, 1).Text
Resize #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Диапазон с новым размером относительно верхней-левой ячейки диапазона.
Resize ( Rows Integer , Rows Integer ) : Range
Возвращаемое значение
Тип: Range
Диапазон Range.
Параметры
Rows | Integer | Новый размер по строкам.
|
Rows | Integer | Новый размер по столбцам.
|
set rng2 = rng1.Resize(4, 0)
SetColSpan #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Устанавливает значения в строке.
SetColSpan ( ValueArray Array ) : Range
Возвращаемое значение
Тип: Range
Диапазон Range.
Параметры
ValueArray | Array | Массив Array значений Variant.
|
set rng2 = rng1.SetColSpan(Array(2, 3.3, "Плотность")) rng1.SetColSpan Array(2, 3.3)
SetRowSpan #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Устанавливает значения в столбце.
SetRowSpan ( ValueArray Array ) : Range
Возвращаемое значение
Тип: Range
Диапазон Range.
Параметры
ValueArray | Array | Массив Array значений Variant.
|
set rng2 = rng1.SetRowSpan(Array(2, 3.3, "Плотность")) rng1.SetRowSpan Array(2, 3.3)
SetStyle #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Устанавливает стиль ячеек диапазона.
SetStyle ( ValueArray Dictionary ) : Range
Возвращаемое значение
Тип: Range
Диапазон Range.
Параметры
ValueArray | Dictionary | Именованный список параметров стиля ячеек диапазона.
Ниже приведены допустимые названия и значения параметров. Если параметр не указан, то связанный с ним элемент стиля не изменяется. BoundaryOuter - Стиль отображения внешних границ диапазона 'НазваниеЦвета;ТипЛинии':
BoundaryInternal - Стиль отображения внешних границ диапазона 'НазваниеЦвета;ТипЛинии':
Body - Стиль отображения фона ячейки 'НазваниеЦвета':
Text - Стиль отображения содержимого ячейки 'НазваниеЦвета;ВыравниваниеПоВертикали;ВыравниваниеПоГоризонтали;ПереносСлов':
Font - шрифт содержимого ячейки 'НазваниеШрифта;РазмерШрифта;СтильШрифта':
|
Set ws = ag.app.NewWorkbook.ActiveWorksheet ws.Range("A1:B1").SetType("Text").SetColSpan(Array("Формат 'F7':", ag.FormatNumber(23.4, "F7"))) set rngHeader = ws.Range("B3").SetColSpan(Array("Number", "Date", "Site")).SetType("Text") set rngBodyTopLeft = ws.Range("B4") set StyleTableBody = ag.app.NewObject("Dictionary", Array( _ "BoundaryOuter", "DarkBlue;Solid", _ "BoundaryInternal", "Black;Dotted", _ "Body", "White", _ "Text", "DarkBlue;Middle;Center;Wrap", _ "Font", "Arial;8;Bold" _ )) set StyleTableHeader = ag.app.NewObject("Dictionary").AddRange(StyleTableBody) StyleTableHeader.Add "Body", "LightBlue" StyleTableHeader.Add "Font", ";;Bold" rngHeader.SetStyle StyleTableHeader rngBodyTopLeft.Resize(3, 2).SetStyle StyleTableBody for rowOffset = 0 to 3 set rngRow = rngBodyTopLeft.Offset(rowOffset, 0).SetColSpan(Array(2,3,4)) if rowOffset mod 2 = 1 then rngRow.SetStyle ag.app.NewObject("Dictionary", Array("Body", "LightGray")) next
SetType #
Поддержка в версии: старше или равно 34.24.2.0.
Описание
Устанавливает тип значения ячеек диапазона.
SetType ( ValueArray Array ) : Range
Возвращаемое значение
Тип: Range
Диапазон Range.
Параметры
ValueArray | Array | Название типа: 'Number'|'Text'|'General'.
|
rng1.SetType "Text"