Предлагаем внешнюю компоненту для 1С, в которой реализовано несколько небольших, но очень полезных системных функций:
Имя метода | Описание |
Звук | Воспроизводит WAV-файл |
Пауза | Приостанавливает выполнение текущего потока |
ПереключитьРаскладкуКлавиатуры | Переключает раскладку клавиатуры |
ПолучитьСписокРаскладокКлавиатуры | Возвращает доступные коды раскладок клавиатуры |
ПоместитьВБуферОбмена | Помещает строку в буфер обмена |
ПолучитьИзБуфераОбмена | Получает строку из буфера обмена |
Разрядность | Возвращает тип запущенного процесса (32 или 64) |
ПолучитьИдентификаторТекущегоПроцесса | Возвращает PID процесса 1С |
ПолучитьВерсиюФайла | Возвращает версию файла в виде xx.xx.xx.xx |
ВключитьОповещенияБуфераОбмена/ОтключитьОповещенияБуфераОбмена | Включает/отключает вызов внешнего события при изменении содержимого буфера обмена |
НазначитьГорячуюКлавишу | Позволяет перехватить нажание "горячей клавиши" |
Компонента выполнена по технологии Native API, предназначена для 1С от версии 8.2.9.356 и выше (8.2 и 8.3 любых версий) для ОС Windows x32 и x64.
Работает с веб-клиентом в браузерах Firefox и Google Chrome (для версии платформы 1С 8.3.6.2152 и выше).
Нужны еще функции? Пишите в комментариях, рассмотрим...
Содержание архива:
1. Компонента
2. Исходники С++ (проект VisualStudio)
3. Тестовая конфигурация
Описание методов компоненты
Звук (PlaySound)
Вариант синтаксиса: по имени файла
Синтаксис:
Звук(<ИмяФайла>)
Параметры:
<ИмяФайла>
Тип: Строка
Воспроизводит указанный WAV-файл. Если <ИмяФайла> не указано или равно пустой строке, тогда останавливает текущее воспроизведение.
Вариант синтаксиса: по двоичным данным
Синтаксис:
Звук(<ДвоичныеДанные>)
Параметры:
<ДвоичныеДанные>
Тип: ДвоичныеДанные
Воспроизводит WAV-файл, помещенный в <ДвоичныеДанные>.
Вариант синтаксиса: без параметров
Синтаксис:
Звук()
Останавливает текущее воспроизведение
Возвращаемое значение:
Тип: Булево
Истина – если удалось воспроизвести файл, Ложь – если возникла ошибка.
Описание:
Воспроизводит WAV-файл с помощью функции WinAPI sndPlaySound()
Пауза (Sleep)
Синтаксис:
Пауза(<КоличествоМиллисекунд>)
Параметры:
<КоличествоМиллисекунд>(обязательный)
Тип: Число
Описание
Приостанавливает выполнение текущего потока на указанное количество миллисекунд с помощью функции WinAPI Sleep()
ПереключитьРаскладкуКлавиатуры (ActivateKeyboardLayout)
Синтаксис:
ПереключитьРаскладкуКлавиатуры(<КодРаскладки>)
Параметры:
<КодРаскладки>(обязательный)
Тип: Строка
Описание
Переключает раскладку клавиатуры с помощью функции WinAPI ActivateKeyboardLayout()
ПолучитьСписокРаскладокКлавиатуры (GetKeyboardLayoutList)
Синтаксис:
ПолучитьСписокРаскладокКлавиатуры()
Возвращаемое значение:
Тип: Строка
Доступные коды раскладок клавиатуры (через разделитель «;»)
Описание
Возвращает доступные коды раскладок клавиатуры с помощью функции WinAPI GetKeyboardLayoutList()
ПоместитьВБуферОбмена (SetClipboardData)
Синтаксис:
ПоместитьВБуферОбмена(<Текст>)
Параметры:
<Текст>(обязательный)
Тип: Строка
Описание
Помещает текст в буфер обмена (используя формат CF_UNICODETEXT)
ПолучитьИзБуфераОбмена (GetClipboardData)
Синтаксис:
ПолучитьИзБуфераОбмена()
Возвращаемое значение:
Тип: Строка
Описание
Возвращает текст из буфера обмена (используя формат CF_UNICODETEXT)
Разрядность (Bits)
Синтаксис:
Разрядность()
Возвращаемое значение:
Тип: Число
Описание
Возвращает 32 или 64 в зависимости от типа запущенного процесса 1С.
GetCurrentProcessId (ПолучитьИдентификаторТекущегоПроцесса)
Синтаксис:
ПолучитьИдентификаторТекущегоПроцесса()
Возвращаемое значение:
Тип: Число
Описание
Возвращает PID процесса 1С с помощью функции WinAPI GetCurrentProcessId().
ПолучитьВерсиюФайла (GetFileVersion)
Синтаксис:
ПолучитьВерсиюФайла(<ИмяФайла>, <Версия>, <Подверсия>, <Релиз>, <Сборка>)
Параметры:
<ИмяФайла>(обязательный)
Тип: Строка
<Версия>(необязательный)
Тип: Число
<Подверсия>(необязательный)
Тип: Число
<Релиз>(необязательный)
Тип: Число
<Сборка>(необязательный)
Тип: Число
Возвращаемое значение:
Тип: Строка
Описание
Возвращает версию файла в виде строки x.x.x.x, а также составные части версии в параметрах <Версия>, <Подверсия>, <Релиз>, <Сборка>
ВключитьОповещенияБуфераОбмена (AddClipboardFormatListener)
Синтаксис:
ВключитьОповещенияБуфераОбмена()
Возвращаемое значение:
Тип: Булево
Описание
Включает вызов внешнего события при изменении содержимого буфера обмена
ОтключитьОповещенияБуфераОбмена (RemoveClipboardFormatListener)
Синтаксис:
ОтключитьОповещенияБуфераОбмена()
Возвращаемое значение:
Тип: Булево
Описание
Отключает вызов внешнего события при изменении содержимого буфера обмена
НазначитьГорячуюКлавишу (SetHotKey)
Синтаксис:
НазначитьГорячуюКлавишу(<СканКод>, <СтандартнаяОбработка>)
Параметры:
<СканКод>(обязательный)
Тип: Строка
Комбинация клавиш для назначения в качестве "горячей"
<СтандартнаяОбработка>(необязательный)
Тип: Булево
Признак выполнения стандартной (системной) обработки нажатия клавиши
Возвращаемое значение:
Тип: Булево
Истина, если горячая клавиша назначена
Описание
Назначает "горячую клавишу". В момент нажатия указаной клавиши будет вызвано внешнее событие. Допустимые названия клавиш:
BACK
TAB
CLEAR
RETURN
SHIFT
CTRL
ALT
PAUSE
CAPITAL
KANA
JUNJA
FINAL
HANJA
ESCAPE
CONVERT
NONCONVERT
ACCEPT
MODECHANGE
SPACE
PRIOR
NEXT
END
HOME
LEFT
UP
RIGHT
DOWN
SELECT
EXECUTE
SNAPSHOT
INSERT
DELETE
HELP
0
1
2
3
4
5
6
7
8
9
A
B
C
D
E
F
G
H
I
J
K
L
M
N
O
P
Q
R
S
T
U
V
W
X
Y
Z
WIN
APPS
SLEEP
NUMPAD0
NUMPAD1
NUMPAD2
NUMPAD3
NUMPAD4
NUMPAD5
NUMPAD6
NUMPAD7
NUMPAD8
NUMPAD9
MULTIPLY
ADD
SEPARATOR
SUBTRACT
DECIMAL
DIVIDE
F1
F2
F3
F4
F5
F6
F7
F8
F9
F10
F11
F12
F13
F14
F15
F16
F17
F18
F19
F20
F21
F22
F23
F24
NUMLOCK
SCROLL
LSHIFT
RSHIFT
LCONTROL
RCONTROL
LMENU
RMENU
BROWSER_BACK
BROWSER_FORWARD
BROWSER_REFRESH
BROWSER_STOP
BROWSER_SEARCH
BROWSER_FAVORITES
BROWSER_HOME
VOLUME_MUTE
VOLUME_DOWN
VOLUME_UP
MEDIA_NEXT_TRACK
MEDIA_PREV_TRACK
MEDIA_STOP
MEDIA_PLAY_PAUSE
LAUNCH_MAIL
LAUNCH_MEDIA_SELECT
LAUNCH_APP1
LAUNCH_APP2
OEM_1
OEM_PLUS
OEM_COMMA
OEM_MINUS
OEM_PERIOD
OEM_2
OEM_3
OEM_4
OEM_5
OEM_6
OEM_7
OEM_8
PROCESSKEY
PACKET
ATTN
CRSEL
EXSEL
EREOF
PLAY
ZOOM
NONAME
PA1
OEM_CLEAR
К названию клавиши можно добавлять модификаторы. Список допустимых названий клавиш-модификаторов:
CTRL, ALT, SHIFT, WIN (именно в такой последовательности). Примеры: CTRL+1, CTRL+ALT+1, CTRL+ALT+SHIFT+1, CTRL+ALT+SHIFT+WIN+1, ALT+SHIFT+1, ALT+WIN+1, WIN+1.
Примечание:
Не все клавиши могут быть назначены в качестве "горячих". Могут сказываться особенности используемой клавиатуры, драйвера или операционной системы. Стандартная (системная) обработка некоторых "горячих клавиш" не может быть отменена.