Содержание

GetElement

Получает элемент в активной вкладке, удовлетворяющий указанным условиям

Синтаксис

function GetElement(aTagName: string='*'; aIndex: integer=-1;
  aAttributes, aValues: array of string=[];
  aStrong: boolean=false; aAntiAttributes, aAntiValues: array of string=[];
  aAntiStrong: boolean=false): TCSElement;

Параметры

  • aTagName
    • тип: string
    • назначение: тэг искомого элемента
  • aIndex
    • тип: integer
    • назначение: индекс искомого элемента
  • aAttributes
    • тип: array of string
    • назначение: массив атрибутов искомого элемента
  • aValues
    • тип: array of string
    • назначение: массив значений атрибутов, соответствующий массиву атрибутов искомого элемента
  • aStrong
    • тип: boolean
    • назначение: флаг точности совпадения значений атрибутов
  • aAntiAttributes
    • тип: array of string
    • назначение: массив исключающих атрибутов
  • aAntiValues
    • тип: array of string
    • назначение: массив значений исключающих атрибутов
  • aAntiStrong
    • тип: boolean
    • назначение: флаг точности совпадения значений исключающих атрибутов

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

  • тип: TCSElement
  • назначение: структура, содержащая параметры найденного элемента

Замечания

  • При поиске элемента скрипт перебирает все элементы, которые имеют значения aValues атрибутов aAttributes. Из этих элементов скрипт выбирает те элементы, которые не имеют значения aAntiValues атрибутов aAntiAttributes. Если флаг aStrong равен true, то будет найден элемент, значения aValues свойств aAttributes которого строго равны указанным (регистр при поиске не учитывается). В противном случае будет найден элемент, в значения свойств aAttributes которого входят соответствующие значения aValues. Аналогично и с флагом aAntiStrong.
  • Если индекс искомого элемента aIndex равен -1, то будет получен случайный элемент из найденных
  • Если элемент не найден, то поля результирующей структуры будут пусты.
  • Найденный элемент будет подсвечен пунктирной рамкой

Примеры

  1. //Получаем случайный элемент из всех, имеющих тег "a" (получаем случайную ссылку)
var element:=GetElement('a');
//Если элемент найден, то 
if element.varName<>'' then
//эмулируем клик по нему
ClickElement(element);
  2. //Загружаем страницу google.com
LoadURI('google.com');
//Получаем кнопку поиска
var search:=GetElement('button',0,['class'],['gbq']);