↑  ←  Описание функции


_IEPropertyGet

Возвращает выбранное свойство браузера или элемент DOM.

#include <IE.au3>
_IEPropertyGet(ByRef $o_object, $s_property)

Параметры

$o_object Переменная объекта InternetExplorer.Application или элемент DOM
$s_property Выбранное свойство (см. примечание)

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

Успех:Возвращает значение выбранного свойства
Ошибка:Возвращает 0 и устанавливает @error
@error:0 ($_IEStatus_Success) = Нет ошибок
3 ($_IEStatus_InvalidDataType) = Неверный тип данных
4 ($_IEStatus_InvalidObjectType) = Неверный тип объекта
5 ($_IEStatus_InvalidValue) = Неверное значение
@extended:Содержит номер неверного параметра

Примечания

Дополнительную информацию можно найти на MSDN.

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

Browser Properties

СвойствоОписание
"addressbar"Возвращает логическое значение, которое определяет, отображается ли адресная строка.
"browserx"Возвращает x-координату левого верхнего угла элемента документа, относительно браузера.
"browsery"Возвращает y-координату левого верхнего угла элемента документа, относительно браузера.
"busy"Возвращает логическое значение, которое определяет, занят ли объект операцией навигации или загрузки.
"contenteditable"Возвращает логическое значение, которое определяет, может ли объект отредактирован с помощью мыши и клавиатуры.
"fullscreen"Возвращает логическое значение, которое определяет, является ли браузер в полноэкранном или нормальном режиме окна.
"height"Возвращает высоту главного окна браузера или элемента документа.
"hwnd"Возвращает дескриптор главного окна Internet Explorer. Может быть использован в большинстве функций AutoIt Win*.
"innerhtml"Возвращает HTML-код отображаемого документа, исключая теги начала и конца.
"innertext"Возвращает отображаемый текст (без тегов) документа. Обычно идентично outertext.
"isdisabled"Возвращает логическое значение, которое определяет, может ли пользователь взаимодействовать с объектом.
"left"Возвращает координаты левого края основного окна объекта.
"locationname"Возвращает the name of the resource, отображаемый в данный момент в Internet Explorer.
"locationurl"Возвращает URL, отображаемый в данный момент в Internet Explorer.
"menubar"Возвращает логическое значение, которое определяет, отображается ли меню браузера.
"offline"Возвращает логическое значение, которое определяет, работает ли браузер в настоящее время в автономном режиме.
"outertext"Возвращает отображаемый текст (без тегов) документа. Обычно идентично innertext.
"outerhtml"Возвращает HTML-код отображаемого документа, включая теги начала и конца.
"readystate"Retrieves the ready state of the object.
"referrer"Retrieves a string of the URL of the page from which the current page was accessed (but only if accessed via a link on that page, else the string is null).
"resizable"Retrieves a value that indicates whether the object can be resized.
"screenx"Возвращает x-координату левого верхнего угла объекта документа, относительно экрана.
"screeny"Возвращает y-координату левого верхнего угла объекта документа, относительно экрана.
"silent"Возвращает логическое значение, которое определяет, может ли браузер показывать диалоговые окна.
"statusbar"Возвращает логическое значение, которое определяет, является ли строка состояния видимой.
"statustext"Возвращает текст, находящийся в строке состояния объекта.
"theatermode"Возвращает логическое значение, которое определяет, является ли браузер в режиме "Во весь экран". В этом режиме главное окно браузера располагается на весь экран и отображает панель инструментов с минимальным набором кнопок навигации.
"title"Возвращает заголовок документа. Обратите внимание, что это отличается от заголовка окна, которое обычно начинается с заголовка документа, but has additional text specified in the windows registry appended to it.
"toolbar"Возвращает логическое значение, которое определяет, отображается ли панель инструментов браузера.
"top"Возвращает координаты верхнего края основного окна объекта.
"visible"Возвращает логическое значение, которое определяет, отображается ли объект.
"width"Возвращает ширину главного окна браузера или элемента документа.
"uniqueid"Retrieves an ID assigned by the DOM that is unique among all elements. This can be used in any context that requires an element ID.

ClientInfo Properties

СвойствоОписание
"appcodename"Retrieves the code name of the browser (the property has a default value of Mozilla).
"appminorversion"Retrieves the application's minor version value.
"appname"Возвращает имя браузера (это свойство по умолчанию имеет значение "Microsoft Internet Explorer").
"appversion"Возвращает платформу и версию браузера.
"browserlanguage"Возвращает текущий язык браузера (значение будет одно из следующих Language Codes).
"cookieenabled"Возвращает, включено ли cookies. Retrieves whether client-side persistent cookies are enabled in the browser. Persistent cookies are those that are stored on the client-side computer.
"cpuclass"Возвращает строку с обозначением класса CPU (возвращаемые значения могут быть найдены здесь).
"javaenabled"Возвращает, включено ли Java.
"online"Retrieves a value indicating whether the system is in global offline mode.
"platform"Возвращает название платформы операционной системы пользователя (возвращаемые значения могут быть найдены здесь).
"systemlanguage"Возвращает язык, используемый операционной системой по умолчанию (значение будет одно из следующих Language Codes).
"useragent"Возвращает строку User-Agent (идентификатор клиентской программы)
"userlanguage"Возвращает разговорный язык, используемый операционной системой (значение будет одно из следующих Language Codes).
"vcard"Returns an array containing each attribute in the userProfile object (список атрибутов может быть найден здесь). The return is a two dimentional array, where the first dimention has two elements. The first element (0) contains the attribute names, the second element (1) contains the corresponding values. The second dimention has 29 elements (0 to 28).

См. также

_IEPropertySet, _IEBodyReadHTML, _IEBodyReadText, _IEBodyWriteHTML, _IEDocInsertHTML, _IEDocInsertText, _IEHeadInsertEventScript

Пример

#include <IE.au3>

; Пример 1

$oIE = _IE_Example ("basic") ; Открывает браузер с базовым примером
If _IEPropertyGet ($oIE, "addressbar") Then
    MsgBox(4096, "Адресная строка", "Адресная строка отображается, выключаем отображение")
    _IEPropertySet ($oIE, "addressbar", False)
Else
    MsgBox(4096, "Адресная строка", "Адресная строка не отображается, включаем отображение")
    _IEPropertySet ($oIE, "addressbar", True)
EndIf

; Пример 2

$oIE = _IE_Example("form") ; Открывает браузер с примером элементов

$oForm = _IEFormGetObjByName($oIE, "ExampleForm")
$oTextArea = _IEFormElementGetObjByName($oForm, "textareaExample") ; Получает объект-ссылку на элемент "текстовое поле"

; Получает координаты и размеры текстовой области
$iScreenX = _IEPropertyGet($oTextArea, "screenx")
$iScreenY = _IEPropertyGet($oTextArea, "screeny")
$iBrowserX = _IEPropertyGet($oTextArea, "browserx")
$iBrowserY = _IEPropertyGet($oTextArea, "browserY")
$iWidth = _IEPropertyGet($oTextArea, "width")
$iHeight = _IEPropertyGet($oTextArea, "height")

; Обойти элемент "текстовое поле" мышью и остановится в центре
MouseMove($iScreenX, $iScreenY)
MouseMove($iScreenX + $iWidth, $iScreenY)
MouseMove($iScreenX + $iWidth, $iScreenY + $iHeight)
MouseMove($iScreenX, $iScreenY + $iHeight)
MouseMove($iScreenX, $iScreenY)
MouseMove($iScreenX + $iWidth/2, $iScreenY + $iHeight/2)