IsKeyComboActive - Revision history

Admin: 1 revision imported

2021-11-20T17:07:25Z

1 revision imported

1>Admin at 07:16, 20 September 2021

2021-09-20T07:16:36Z

Admin: 1 revision imported

2021-02-07T06:51:36Z

1 revision imported

Admin at 08:58, 19 August 2020

2020-08-19T08:58:09Z

New page

{{infobox function
|name=IsKeyComboActive
|object=[[Функции общего назначения]]
|caption=Системные функции
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Объекты]]
* [[Функции общего назначения]]}}
Функция проверяет, активирована ли в данный момент пользователем заданная комбинация клавиш. Комбинация записывается в формате <code>[<Модификаторы>+]<Название клавиши></code>, модификаторами могут выступать слова '''Ctrl''', '''Alt''' и '''Shift''' (к примеру, <code>"Ctrl+Alt+D"</code>). Также можно проверить только состояние клавиши-модификатора, к примеру, <code>IsKeyComboActive("Ctrl")</code>. Для визуального клиента проверяется статус того, что основное окно клиента активно, если оно не активно, функция возвратит 0, вне зависимости от того, активирована для комбинация или нет.

== Синтаксис ==
<code>
'''IsKeyComboActive'''(''<Комбинация клавиш (STRING)>''):''<Комбинация активирована в данный момент, 0 или 1 (INT)>''
</code>
==== Аргументы ====
* <code>''<Комбинация клавиш (STRING)>''</code> - Строка, описывающая комбинацию клавиш.
==== Возвращаемое значение ====
Возвращает 1, если комбинация активирована (и клиент активен), иначе возвращает 0.

== Примеры ==
<pre>
//Функцию удобно использовать, к примеру, при печати большого количества таблиц из разных модулей (печатных форм документов и пр.)
//Так как модули вызываются постоянно, у пользователя нет возможности прекратить выполнение, оно остановит вызываемый модуль, но
// при отсутствии специальных проверок внутри, вслед за ним сразу же загрузится следующий
//Использование особой комбинации клавиш для остановки цикла является одним из вариантов разрешения этой ситуации.
Message("Удерживайте Ctrl+S, чтобы остановить печать до ее завершения...","I");

While 1 Do
...

If IsKeyComboActive("Ctrl+S") Then
Message("Печать остановлена!","!");
Break;
EndIf;

...
EndDo;

</pre>

← Older revision	Revision as of 17:07, 20 November 2021
(No difference)

@@ Line 13: / Line 13: @@
 * [[Объекты]]
 * [[Функции общего назначения]]}}
-Функция проверяет, активирована ли в данный момент пользователем заданная комбинация клавиш. Комбинация записывается в формате <code>[<Модификаторы>+]<Название клавиши></code>, модификаторами могут выступать слова '''Ctrl''', '''Alt''' и '''Shift''' (к примеру, <code>"Ctrl+Alt+D"</code>). Также можно проверить только состояние клавиши-модификатора, к примеру, <code>IsKeyComboActive("Ctrl")</code>. Для визуального клиента проверяется статус того, что основное окно клиента активно, если оно не активно, функция возвратит 0, вне зависимости от того, активирована для комбинация или нет.
+Функция проверяет, активирована ли в данный момент пользователем заданная комбинация клавиш. Комбинация записывается в формате <code>[<Модификаторы>+]<Название клавиши>[+...]</code>, модификаторами могут выступать слова '''Ctrl''', '''Alt''' и '''Shift''' и др. (к примеру, <code>"Ctrl+Alt+D"</code>). Также можно проверить только состояние клавиши-модификатора, к примеру, <code>IsKeyComboActive("Ctrl")</code>. Для визуального клиента проверяется статус того, что основное окно клиента активно, если оно не активно, функция возвратит 0, вне зависимости от того, активирована для комбинация или нет.
 == Синтаксис ==
@@ Line 20: / Line 20: @@
 </code>
 ==== Аргументы ====
-* <code>''<Комбинация клавиш (STRING)>''</code> - Строка, описывающая комбинацию клавиш.
+* <code>''<Комбинация клавиш (STRING)>''</code> - Строка, описывающая комбинацию клавиш. Клавиши разделяются знаком '''+''' и могут быть заданы тремя способами:
 ==== Возвращаемое значение ====
 Возвращает 1, если комбинация активирована (и клиент активен), иначе возвращает 0.

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)