====== Документация к библиотеке hWindow ======

Кроссплатформенная и кроссбраузерная компонента для создания интерфейса в бизнес приложениях на платформе 1С с использованием web-технологий. [[:hwindow|Подробнее...]]

<code>Тип компоненты: NativeAPI
Платформа: 8.2, 8.3
Назначение: пользовательский интерфейс
Текущая версия: 0.4</code>

===== Описание интерфейса =====
=== Свойства ===

<code 1c>Version : Строка</code>

=== Методы ===
<code 1c>
Булево CreateWindow(Строка Guid)
Булево DestroyWindow(Строка Guid)
Строка ExecuteJavaScript(Строка Guid, Строка Code)
Булево SetAttribute(Строка Guid, Строка Attribute)
Булево SetHtml(Строка Guid, Строка Html)
Булево Show(Строка Guid)
Булево ShowMaximized(Строка Guid)
</code>

=== События ===
<code 1c>LinkClicked : Строка</code>


===== Описание свойств =====

<code 1c>Version : Строка</code>
Содержит текущую версию библиотеки. \\ \\
**Доступность:** чтение.


===== Описание методов =====

<code 1c>Булево CreateWindow(Строка Guid)</code>
Создает новый экземпляр окна hWindow. Помещает идентификатор созданного окна в параметр //Guid//.\\ \\
**Возвращает:** //Истина//, если метод отработал успешно.\\ \\
Это первый метод, который необходимо вызвать перед началом работы с библиотекой. Значение, которое будет помещено в параметр //Guid//, необходимо использовать при вызове других методов библиотеки. Количество создаваемых окон не ограничено. Параметр //Guid// используется для определения конкретного созданного окна, всегда идет первым параметром и действителен вплоть до вызова метода //DestroyWindow//.

<code 1c>Булево DestroyWindow(Строка Guid)</code>
Удаляет экземпляр окна hWindow. Идентификатор окна //Guid// становиться недействительным. \\ \\
**Возвращает:** //Истина//, если метод отработал успешно.

<code 1c>Строка ExecuteJavaScript(Строка Guid, Строка Code)</code>
Выполняет код, переданный в параметре //Code//, на языке JavaScript в указанном окне hWindow. Допускается выполнение произвольного кода, соответствующего синтаксису и семантике языка, а также вызов функций ранее загруженных методом //SetHtml//. Выполнение метода прерывается, только после окончания исполнения JavaScript кода и может занимать продолжительное время. Если в специфика кода предусматривается вычисление или вызов функций, то результат вычисления будет помещен в значение возвращаемое методом.\\ \\
**Возвращает:** Результат вычислений преобразованный в строку.

<code 1c>Булево SetAttribute(Строка Guid, Строка Attribute)</code>
Изменяет внешний вид окна, добавляя новые атрибуты визуализации. \\ \\
Параметр //Attribute// принимает значения:
  * //NoFrame// - убирает рамку во круг окна;
  * //StayOnTop// - переводит окно в режим "поверх остальных окон";
  * //Transparent// - убирает рамку окна и делает всю область окно прозрачным, за исключением web-содержимого.

**Возвращает:** //Истина//, если метод отработал успешно.

<code 1c>Булево SetHtml(Строка Guid, Строка Html)</code>
Загружает html код в указанное окно hWindow. Вызов метода осуществляется асинхронно. Это означает, что после выполнения метода, процесс обработки html кода может еще не быть завершен. Допускается передача кода содержащего описание стилей CSS и кода JavaScript, в том числе и для последующего вызова методом //ExecuteJavaScript//.\\ \\
**Возвращает:** //Истина//, если метод отработал успешно.

<code 1c>Булево Show(Строка Guid)</code>
Отображает окно на экране с действующими значениями параметров размера и расположения окна. \\ \\
**Возвращает:** //Истина//, если метод отработал успешно.

<code 1c>Булево ShowMaximized(Строка Guid)</code>
Отображает окно на экране, разворачивая его на всю рабочую область. \\ \\
**Возвращает:** //Истина//, если метод отработал успешно.


===== Описание событий =====

Обработка событий выполняется обработчиком формы 1С //ВнешнееСобытие(Источник, Событие, Данные)//. Параметр //Источник// всегда равен hWindow. Параметр //Событие// принимает одно из ниже описанных значений.

<code 1c>LinkClicked : Строка</code>
Вызывается при нажатии на гиперссылку. Передает адрес, указанный в гиперссылке.