Самоучитель VBA
       

Свойства и методы объекта Range


Свойства и методы объекта Range

Объект Range позволяет сочетать гибкость VBA и мощь рабочего листа Excel. Более 400 встроенных функций рабочего листа существенно упрощают и делают более наглядным программирование на VBA.

Далее приводятся наиболее часто используемые свойства и методы объекта

Range.

Перечислим основные свойства объекта Range.



Value

Возвращает значение из ячейки или в ячейки диапазона. В данном примере переменной х присваивается значение из ячейки C1 :

х = Range ("C1") .Value В следующем примере в диапазон AI : В2 введена 1 :

Range ("A1:B2") .Value = 1

Name

Возвращает имя диапазона. В данном примере диапазону А1:В2 присваивается имя итоги:

Range ( "Al :B2") .Name = "Итоги"

Count

Возвращает число объектов в наборе. В данном примере переменной х присваивается значение, равное числу строк диапазона AI : В2 :

х = Range ( "Al :B2") .Rows . Count

CurrentRegion

Возвращает число строк текущего диапазона. Текущим является диапазон, ограниченный пустыми строками и столбцами и содержащий данный элемент. В следующем примере переменной у присваивается значение, равное числу строк в текущем диапазоне, содержащем ячейку AI :

у = Range ( "Al" ). CurrentRegion. Rows . Count

WrapText

Позволяет переносить текст при вводе в диапазон. Допустимые значения True и False. В следующем примере в ячейку В2 вводится текст длинный текст и в этой ; ячейке устанавливается режим ввода текста с переносом: With Range ("B2") .Value = "Длинный текст" .WrapText = True End With

EntireColumn, EntireRow

Возвращает столбец и строку соответственно. В данном примере очищается содержимое строки и выделяется столбец с активной ячейкой:

ActiveCell . EntireRow. Clear ActiveCell .EntireColumn. Select

ColumnWidth, RowHeight

Возвращает ширину столбцов и высоту строк диапазона соответственно

Comment

Возвращает объект comment (примечание), который связан с левым верхним углом диапазона при отображении на экране. Объект comment является элементом семейства comments. Метод AddComment, примененный к диапазону, создает новое примечание. Среди методов объекта comment отметим только метод Text, который задает текст, выводимый в примечании. Синтаксис:

Text (Text, Start, Overwrite)

Text — строка, выводимая в качестве примечания П start — с какого символа вводится текст в уже существующее примечание. Если аргумент опущен, то из примечания удаляется весь ранее введенный текст П overwrite — допустимые значения: True (вводимый текст записывается поверх уже существующего) и False (вводимый текст вставляется в уже существующий) Среди свойств объекта Comment отметим только свойство visible, устанавливающее отображение примечания при активизации диапазона, имеющего определенное примечание. В качестве примера рассмотрим следующие инструкции, которые создают и отображают примечание ячейки вз, поясняющее запланированное событие (рис. 3.1):

With Range ("ВЗ")

.AddComment

.Text Text:= "Чрезвычайно важно!" & Chr(10) & "Про это никак нельзя забыть ! "

.Visible = True End With
<

Рис. 2.1. Пример отображения примечания на рабочем листе



Font
Возвращает объект Font (шрифт). Объект Font имеет следующие свойства:
  • Name — строка, указывающая имя шрифта, например "Arial Cyr"
  • FontStyle — СТИЛЬ, возможен Regular (обычный), Bold (ПОЛУЖИРНЫЙ), Italic(курсив), Bold italic (полужирный курсив)
  • size - размер
  • strikethrough — допустимы два значения: True (буквы имеют линию по центру, как будто они перечеркнуты) и False (не имеют линии по центру)
  • Superscript — допустимы два значения: True (текст используется как верхний индекс) и False (не используется как верхний индекс)
  • Subscript — допустимы два значения: True (текст используется как нижний индекс) и False (не используется как нижний индекс)
  • Underline-допустимыми являются значения:
    xlNone (нет подчеркивания)
    xlSingie (одинарное, по значению)

    		•






      xlDoubie (двойное, по значению)
      xlsingleAccounting (одинарное, по ячейке)
      Accounting (двойное, но ячейке)

      Например, в следующем примере устанавливается для диапазона AI : в2 полужирный шрифт, красного цвета и с высотой символов 1 4 :

      With Range ("A1:B2").Font
      .Size = 14
      .FontStyle = Bold
      .Colorlndex = 3
      End With

    Formula
    Возвращает формулу в формате Al. Например, следующая инструкция вводит в ячейку с2 формулу =$А$4+$А$ю:

    Range ("C2") . Formula = "=$А$4+$А$10"

    FormulaArray 1
    Возвращает формулу диапазона в формате А1. В отличие от обыкновенной формулы рабочего листа, формула диапазона вводится на рабочем листе не посредством нажатия на клавишу <Enter>, а с помощью комбинации клавиш <Ctrl>+<Shift>+<Enter>. Следующая инструкция вводит в диапазон Е!:ЕЗ формулу {=Sum(Al:A3*Bl:B3) }:
    Range ( "El :E3") .FormulaArray = "=Sum(Al:A3*Bl:B3) "

    FormulaHidden
    Допустимые значения: True (формула спрятана, если рабочий лист или книга защищены) и False (в противном случае). Например, следующая инструкция скрывает формулы в столбце А: Columns ("A") . FormulaHidden = True

    FormulaLocal
    Возвращает неанглоязычные (местные) формулы в формате А1. Например, следующая инструкция вводит в ячейку В2 формулу =СУММ(С1:С4):
    Range("B2"). FormulaLocal = "=СУММ (С1:С4) "

    JormulaRlCl
    Возвращает формулу в формате R1C1. Например,

    Range ("Bl") . FormulaRlCl = "=SQRT (R3C2 ) "

    FormulaRlCl Local
    Возвращает неанглоязычные формулы в формате R1C1

    Text
    Возвращает содержание диапазона в текстовом формате
    <




    HorizontalAlignment
    Горизонтальное выравнивание. Допустимые значения:
  • xlceneral ( обычное выравнивание, зависящее от типа вводимых значений)
  • xlcenter (выравнивание по центру)
  • xlRight (выравнивание по правому краю)
  • xlLeft (выравнивание по левому краю)
  • xUustify (выравнивание по ширине)
  • xlCenterAcrossSelection (выравнивание по центру в выделенном диапазоне)
  • xlFill (выравнивание по ширине
    		•

    Vertical Alignment
    Вертикальное выравнивание. Допустимые значения:

  • xlBottom (выравнивание по нижнему краю),
  • xlcenter (выравнивание по центру),
  • xUustify (выравнивание по высоте),
    xlTop (выравнивание по верхнему краю)

    		•

    Orientation
    Ориентация. Допускается либо угол поворота текста в градусах от —90° до 90°, либо одно из допустимых значений:
  • xlDownward (выравнивание по левому краю сверху вниз, соответствует углу —90°)
  • xlHorizontal(выравнивание по горизонтали, соответствует нулевому углу )
  • xlupward (выравнивание по правому краю снизу вверх, соответствует углу 90°)
    xlvertical (выравнивание по вертикали, нет соответствия в градусах)

    		•

    ShrinkToFit
    Допустимые значения: True (автоматическое изменение шрифта так, чтобы текст помещался в ячейку) и False (в противном случае)

    Ниже приведены наиболее часто используемые методы объекта Range.



    Address
    Возвращает адрес ячейки.
    Синтаксис:

    Address (rowAbsolute, coluimAbsolute, referenceStyle, external, relativeTo)

    Аргументы:
  • RowAbsoiute — допустимы два значения True и False, если используется значение True или аргумент опущен, то возвращается абсолютная ссылка на строку
  • ColumnAbsoiute — допустимы два значения True и False, если используется значение True или аргумент опущен, то возвращается абсолютная ссылка на столбец

  • ref erenceStyle — допустимы два значения xlAl и
    xiR1c1, если используется значение X1A1 или аргумент опущен, то возвращается ссылка в виде формата А1 П external — допустимы два значения True и False, если используется значение False или аргумент опущен, то возвращается относительная ссылка
    relativeTo — В случае, если rowAbsoiute и СolumnAbsoiute равны False, a referenceStyle X1R1C1, то данный аргумент определяет начальную ячейку диапазона, относительно которой производится адресация Следующий пример показывает различные результаты адресации.
    MsgBox Cells (1, 1). Address ()

    '

    ' В диалоговом окне отображается адрес $А$1 MsgBox Cells (1, 1) .Address (rowAbsoiute:=False)

    '

    ' В диалоговом окне отображается адрес $А1 '

    MsgBox Cells (1, 1) .Address (ref erenceStyle :=x1R1C1) '

    ' В диалоговом окне отображается адрес R1C1 '
    		•
    <



    Clear, ClearComments , Clear Contents, ClearFormats

    И
    		 Метод clear очищает диапазон. В следующем примере очищается диапазон Al :G37 . Range ("A1:G37") .Clear

    Методы ClearComments, ClearContents, ClearFormats и ClearNotes очищают В диапазоне
    AutoFit

    		 Автоматически настраивает ширину столбца и высоту строки
    ClearNotes

    		 комментарии, содержание, форматы и примечания соответственно.
    Copy

    		 Копирует диапазон в другой диапазон или в буфер обмена.

    Синтаксис:

    Copy (destination)

    Аргумент destination определяет диапазон, куда копируется данный диапазон. Если аргумент destination опушен, то копирование происходит в буфер обмена. В данном примере диапазон AI : D4 рабочего листа Лист! копируется в диапазон Е5:Н8 листа лист2:

    Worksheets ("Лист1" ) . Range ( "А1 : D4 " ) .Сору destination :=Worksheets ("Лист2") .Range ("E5")
    Cut

    		 Копирует диапазон с удалением в указанный диапазон или в буфер обмена,
    Синтаксис:

    Cut (destination)

    Аргумент destination определяет диапазон, в который копируется данный диапазон. Если аргумент destination опущен, то диапазол копируется в буфер обмена. В данном примере диапазон AI : D4 рабочего листа лист! копируется с удалением в буфер обмена:

    Worksheets ( "Лист1 " ) . Range ( "А1 : D4 " ) . Cut
    Delete

    		 Удаляет диапазон. В данном примере удаляется третья строка активной рабочей страницы:

    Rows (3) .Delete
    Columns, Rows

    		 Возвращают соответственно семейства столбцов и строк, из которых состоит диапазон. В следующем примере переменным i и j присваиваются значения, равные количеству столбцов и строк в выделенном диапазоне соответственно:

    i = Selection. Columns . Count j = Selection. Rows . Count
    Insert

    		 Вставка ячейки или диапазона ячеек. В следующем примере вставляется новая строка перед четвертой строкой рабочего листа Лист1:

    Worksheets ( "Лист1" ) . Rows (4 ) .Insert
    Offset

    		 Возвращает диапазон, смещенный относительно данного на величины, специфицированные в аргументах.
    Синтаксис:

    Of fset (rowOffset, columnOf f set )

    Аргументы:
  • rowOffset — целое число, указывающее сдвиг по строкам
    columnOf f set — целое число, указывающее сдвиг по столбцам Например, в следующем примере активизируется ячейка, расположенная на три строки ниже и на два столбца левее относительно предыдущей активной ячейки:

    ActiveCell.Offset (rowOf fset :=3, columnOf fset : =-2) .Activate
    		•
    <




    Select
    Выделение диапазона

    PasteSpecial
    Специальная вставка из буфера обмена.
    Синтаксис:

    BasteSpecial (paste, operation, skipBlanks, transpose)
    Аргументы:
  • Paste — определяет ту часть содержимого буфера обмена, которая должна быть вставлена в диапазон. Допустимые значения:
  • xlAll (все)

  • xl Formulas (формулы)

  • xlvaiues (значения)
  • xlFormats (форматы)
  • xlNotes (примечания)
  • xlAllExceptBorders (без рамки)
  • Operation — определяет операции.Допустимые значения:

  • xlNone (нет)
  • xlAdd (СЛОЖИТЬ)
  • xlSubtract (ВЫЧИСТЬ)
  • xlMultiply (УМНОЖИТЬ)

  • xlDivide (разделить)
  • SkipBlanks — допустимые значения: True (пустые ячейки при вставке не учитываются) и False (пустые ячейки учитываются)
  • Transpose — допустимые значения True (диапазон выводится транспонированным) и False (не транспонированным)
    В приведенном ниже примере данные из диапазона C1:C5 рабочего листа лист1 вставляются в диапазон D1 : D5 того же листа, причем они не заменяют уже существующие данные в диапазоне D1:D5, а прибавляются к ним данные из диапазона C1 : С5 :

    Worksheets ( "Лист1 " ) . Range ( "С1 : С5 " ) . Сору Worksheets ("Лист1") .Range ("D1: D5") . PasteSpecial operation : =xlAdd
    Метод PasteSpecial программирует выполнение на рабочем листе команды Правка, Специальная вставка (Edit, Paste Special). Аргументы метода PasteSpecial соответствуют установкам диалогового окна Специальная вставка (Paste Special), отображаемого с помощью этой команды (рис. 3.2)

    		•


    Рис. 2.2. Диалоговое окно Специальная вставка



    AddComment
    Добавляет примечание к диапазону.

    Синтаксис:

    AddComment (Text)
    Text — строковое выражение добавляемое в качестве примечания В следующем примере создается примечание внимание ! ячейки AI активного рабочего листа:

    Range ( "А! " ) . AddComment "Внимание!"
    Содержание раздела