Класс ‘Range’

Содержание

almaGRID API

Диапазон ячеек рабочего листа.

Свойства #

Cells #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Список ячеек диапазона. 

Cells   : List

Значение свойства (ReadOnly)
Тип: List
Список List из ячеек Range, входящих в диапазон. 

for each cell in rng1.ells
  ....
next

almaGRID API

Col #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Начальный столбец диапазона. 

Col   : Integer

Значение свойства (ReadOnly)
Тип: Integer
Индекс первого столбца диапазона, индекс первого столбца - 0. 

index = rng1.Col

almaGRID API

Cols #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Количество столбцов диапазона. 

Cols   : Integer

Значение свойства (ReadOnly)
Тип: Integer
Количество столбцов диапазона, индекс первого столбца - 0. 

ag.app.MsgBox rng1.Cols

almaGRID API

IsSingleCell #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Определяет, состоит ли диапазон из единственной ячейки. 

IsSingleCell   : Boolean

Значение свойства (ReadOnly)
Тип: Boolean
True - если диапазон из единственной ячейки и False в противном случае. 

ag.app.MsgBox rng1.IsSingleCell

almaGRID API

Number #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Численной значение ячейки. 

Number   : Double

Значение свойства
Тип: Double
Численной значение ячейки или null, если значение не представимо, как число. 

ag.app.MsgBox rng1.Number

almaGRID API

Row #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Начальная строка диапазона. 

Row   : Integer

Значение свойства (ReadOnly)
Тип: Integer
Индекс первой строки диапазона, индекс первой строки - 0. 

ag.app.MsgBox rng1.Row

almaGRID API

Rows #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Количество строк диапазона. 

Rows   : Integer

Значение свойства (ReadOnly)
Тип: Integer
Количество строк диапазона, индекс первого столбца - 0. 

ag.app.MsgBox rng1.Rows

almaGRID API

Text #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Текстовое значение ячейки. 

Text   : String

Значение свойства
Тип: String
Текстовое значение ячейки или null. 

ag.app.MsgBox rng1.Text

almaGRID API

TopLeft #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Ячейка верхнего-левого угла диапазона. 

TopLeft   : Range

Значение свойства (ReadOnly)
Тип: Range
Ячейка верхнего-левого угла диапазона. 

ag.app.MsgBox rng1.TopLeft.Text

almaGRID API

Методы #

GetColSpan #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Список значений ячеек в строке. 

GetColSpan  ( Count  Integer  ) : List

Возвращаемое значение
Тип: List
Список List значений ячеек Variant.

Параметры

Count Integer Количество ячеек в строке. 

ag.app.MsgBox Join(rng1.GetColSpan(3).ToArray, ";")

almaGRID API

GetRowSpan #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Список значений ячеек в столбце. 

GetRowSpan  ( Count  Integer  ) : List

Возвращаемое значение
Тип: List
Список List значений ячеек Variant.

Параметры

Count Integer Количество ячеек в столбце. 

ag.app.MsgBox Join(rng1.GetRowSpan(3).ToArray, ";")

almaGRID API

Offset #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Ячейка, находящаяся по заданному смещению относительно верхней-левой ячейки диапазона. 

Offset  ( Rows  Integer , Rows  Integer  ) : Range

Возвращаемое значение
Тип: Range
Ячейка Range.

Параметры

Rows Integer Смещение по строкам.

Rows Integer Смещение по столбцам. 

ag.app.MsgBox rng1.Offset(2, 1).Text

almaGRID API

Resize #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Диапазон с новым размером относительно верхней-левой ячейки диапазона. 

Resize  ( Rows  Integer , Rows  Integer  ) : Range

Возвращаемое значение
Тип: Range
Диапазон Range.

Параметры

Rows Integer Новый размер по строкам.

Rows Integer Новый размер по столбцам. 

set rng2 = rng1.Resize(4, 0)

almaGRID API

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)

almaGRID API

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)

almaGRID API

SetStyle #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Устанавливает стиль ячеек диапазона. 

SetStyle  ( ValueArray  Dictionary  ) : Range

Возвращаемое значение
Тип: Range
Диапазон Range.

Параметры

ValueArray Dictionary Именованный список параметров стиля ячеек диапазона.

Ниже приведены допустимые названия и значения параметров. Если параметр не указан, то связанный с ним элемент стиля не изменяется.

BoundaryOuter - Стиль отображения внешних границ диапазона 'НазваниеЦвета;ТипЛинии':

  • 'НазваниеЦвета' - цвет;
  • 'ТипЛинии' - Тип линии, может принимать значения 'None'|'Solid'|'BoldSolid'|'Dashed'|'DoubleLine'|'Dotted'.

BoundaryInternal - Стиль отображения внешних границ диапазона 'НазваниеЦвета;ТипЛинии':

  • 'НазваниеЦвета' - цвет;
  • 'ТипЛинии' - Тип линии, может принимать значения 'None'|'Solid'|'BoldSolid'|'Dashed'|'DoubleLine'|'Dotted'.

Body - Стиль отображения фона ячейки 'НазваниеЦвета':

  • 'НазваниеЦвета' - цвет.

Text - Стиль отображения содержимого ячейки 'НазваниеЦвета;ВыравниваниеПоВертикали;ВыравниваниеПоГоризонтали;ПереносСлов':

  • 'НазваниеЦвета' - цвет;
  • 'ВыравниваниеПоВертикали' - выравнивание по вертикали может принимать значения 'Top'|'Middle'|'Bottom';
  • 'ВыравниваниеПоГоризонтали' - выравнивание по горизонтали может принимать значения 'Left'|'Center'|'Right';
  • 'ПереносСлов' - перенос слов может принимать значения 'Wrap'|'NoWrap'.

Font - шрифт содержимого ячейки 'НазваниеШрифта;РазмерШрифта;СтильШрифта':

  • 'НазваниеШрифта' - название шрифта;
  • 'РазмерШрифта' - размер шрифта, пункты;
  • 'СтильШрифта' - стиль шрифта 'Bold'|'Normal'. 

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

almaGRID API

SetType #

Поддержка в версии: старше или равно 34.24.2.0.

Описание
Устанавливает тип значения ячеек диапазона. 

SetType  ( ValueArray  Array  ) : Range

Возвращаемое значение
Тип: Range
Диапазон Range.

Параметры

ValueArray Array Название типа: 'Number'|'Text'|'General'. 

rng1.SetType "Text"

almaGRID API

Если вы нашли ошибку, пожалуйста, выделите фрагмент текста и нажмите Ctrl+Enter.

Сообщить об опечатке

Текст, который будет отправлен нашим редакторам:

Отправить