====== GetElement ======
Gets the element in the active tab, satisfying the specified conditions
===== Syntax =====
function GetElement(aTagName: string='*'; aIndex: integer=-1;
aAttributes, aValues: array of string=[];
aStrong: boolean=false; aAntiAttributes, aAntiValues: array of string=[];
aAntiStrong: boolean=false): TCSElement;
==== Parameters ====
* **//aTagName//**
* //type:// string
* //functions:// tag of the desired element
* **//aIndex//**
* //type:// integer
* //functions:// index of the desired element
* **//aAttributes//**
* //type:// array of string
* //functions:// array of attributes of the desired element
* **//aValues//**
* //type:// array of string
* //functions:// array of attribute values corresponding to the array of attributes of the desired element
* **//aStrong//**
* //type:// boolean
* //functions:// flag of match precision of the attribute values
* **//aAntiAttributes//**
* //type:// array of string
* //functions:// array of exclusive attributes
* **//aAntiValues//**
* //type:// array of string
* //functions:// an array of values of exclusive attributes
* **//aAntiStrong//**
* //type:// boolean
* //functions:// flag of match precision of an exclusive attribute values
==== Returned value ====
* //type:// [[en:wascript:pascal:records:tcselement|TCSElement]]
* //functions:// structure that contains the parameters of the found element
===== Notes =====
* When searching for an element the script enumerates all elements that have values aValues of aAttributes attributes. Of these elements, the script selects the elements that are not have values aAntiValues of aAntiAttributes attributes. If aStrong flag is true, the element is found, the values of properties aValues of aAttributes of which are strictly equal to the specified (sensitive search is not considered). Otherwise, the element is found, in property values aAttributes of which includes the corresponding values aValues. Similarly, with the flag aAntiStrong.
* If the index of the desired element aIndex is -1, it will be obtained a random element from found ones.
* If no elements are found, then the resulting structures of the field will be empty.
* Found element is highlighted by a dotted frame
===== Examples =====
-//Obtain a random element from all, having tag "a" (obtain random link)
var element:=GetElement('a');
//If the element is found, the
if element.varName<>'' then
//emulate a click on it
ClickElement(element);
-//Load a page google.com
LoadURI('google.com');
//Get the search button
var search:=GetElement('button',0,['class'],['gbq']);
{{ :wascript_getelement_1.png }}