Загрузка в глобальном модуле:
Перем MAG Экспорт;
ЗагрузитьВнешнююКомпоненту("MagicESC.dll");
MAG=СоздатьОбъект("AddIn.MagicEsc");
Методы:
DisableEsc() - блокировать клавишу Esc.
EnableEsc() - разблокировать клавишу Esc.
Повторный вызов одноименного метода не оказывает влияние на состояние блокировки.
Пример использования:
MAG.DisableEsc();
Для Н=1 По 100000 Цикл
Состояние(Н);
КонецЦикла;
MAG.EnableEsc();
Начиная с версии 2.x.x.x добавлены методы работы с экраном.
Save(<Режим>,<Лево>,<Верх>,<Ширина>,<Высота>,<ИмяФайла>,<Флаг2>)
Назначение:
Сохраняет область экрана в файл (формат BMP) или в оперативную память.
Параметры:
<Режим> - Позволяет задать относительно чего используются координаты области:
0 - Относительно рабочего стола Windows.
-1 - Относительно основного окна 1С.
Число (отличное от 0 или -1) - Относительно формы. В качестве значения необходимо передать HWND окна формы, которое можно получить с помощью объекта "РасширениеФормы" или "АтрибутФормы" из атрибута (свойства) "Дескриптор" внешней компоненты FormEx™.
<Лево> - Расстояние от левой границы стола/окна/формы до левой границы области.
<Верх> - Расстояние от верхней границы стола/окна/формы до верхней границы области.
<Ширина> - Ширина области.
<Высота> - Высота области.
<ИмяФайла> - Строковое выражение с именем файла. Если не задано, область сохраняется в оперативной памяти.
<Флаг2> - Управляет контролем полной видимости области на экране. Если задано значение отличное от нуля, то контроль отключается.
Возвращает:
<0 - Операция не выполнена.
=0 - Никогда не возвращается.
>0 - Успешное завершение.
Compare(<Режим>,<Лево>,<Верх>,<Ширина>,<Высота>,<Флаг1>,<Флаг2>)
Назначение:
Сравнивает образ, заданный в параметрах вызова данного метода, с образом (ранее сохраненного методом "Save") в оперативной памяти.
Параметры:
<Режим>,<Лево>,<Верх>,<Ширина>,<Высота>,<Флаг2> - Описание эквивалентно описанию параметров метода "Save".
<Флаг1> - Управляет удалением образа (ранее сохраненного методом "Save") из оперативной памяти. Если задано значение отличное от нуля, то образ не удаляется из оперативной памяти до очередного вызова метода "Save" или до завершения сессии 1С. В противном случае (нулевое значение или отсутствует) образ удаляется после выполнения метода "Compare".
Возвращает:
<0 - Операция не выполнена.
=0 - Образ (ранее сохраненный методом "Save") отличается от образа определенного координатами вызова метода "Compare".
>0 - Образ (ранее сохраненный методом "Save") равен образу определенного координатами вызова метода "Compare".
GetRetCod()
Назначение:
Возвращает значение уточняющего кода возврата, если из методов "Save" и "Compare" вернулось значение меньше нуля. Предыдущее значение уточняющего кода возврата сбрасывается в начале выполнения всех методов, кроме "GetRetCod". Значение уточняющего кода возврата сбрасывается после выполнения "GetRetCod".
Параметры:
Нет параметров.
Возвращает:
0 - Нет причин для установки значения уточняющего кода возврата.
1-5 - Системные проблемы. Следует обратиться к разработчику MagicEsc.
6-16 - Сбой при записи файла в методе "Save", заданного параметром <ИмяФайла>.
17 - В параметр <Режим> передан неверный HWND окна формы.
18-21 - Системные проблемы. Следует обратиться к разработчику MagicEsc.
22 - В параметр <Режим> передан неверный HWND окна формы.
23-30 - Область не имеет полной видимости на экране, а значение параметра <Флаг2> равно нулю или параметр отсутствует.
31 - Системные проблемы. Следует обратиться к разработчику MagicEsc.
32 - Площадь образа (ранее сохраненного методом "Save") отличается от площади образа определенного координатами в вызове метода "Compare". Или образ отсутствует в оперативной памяти.
33-35 - Системные проблемы. Следует обратиться к разработчику MagicEsc.
SetDebug(<Уровень>)
Назначение:
Позволяет управлять уровнем выдачи отладочной информации.
Параметры:
<Уровень> - Позволяет задать уровень детализации выдаваемой отладочной информации.
<0 - Отключает выдачу отладочной информации.
=0 - Отключает выдачу отладочной информации.
>0 - Включает выдачу отладочной информации. Минимальный уровень детализации - единица. Если уровень задан более допустимого в MagicEsc, то используется максимально возможный.
Возвращает:
Ничего не возвращает - вызывается как процедура.
GetTextSize(<Режим>,<Шрифт>,<Текст>)
Назначение:
Позволяет получить ширину и высоту текста в пикселях.
Параметры:
<Режим> - Описание эквивалентно описанию параметра метода "Save".
<Шрифт> - Задаёт шрифт, которым планируется отображать текст. В качестве значения необходимо передать значение из атрибута (свойства) "Шрифт" объекта "АтрибутФормы" внешней компоненты FormEx™.
<Текст> - Задаёт текст, который планируется отображать.
Возвращает:
<0 - Операция не выполнена.
=0 - Передан текст нулевой длины.
>0 - Успешное завершение. Возвращаемая величина будет содержать ширину текста в пикселях - как целое от деления на 10000, а высоту текста в пикселях - как остаток от деления на 10000. Пример: SizeX=Цел(RetVal/10000); SizeY=RetVal%10000;
