TurboConf SDK - класс ТурбоКонф

Добавил: bolsun, 05 апреля 2018 16:34, обновлено: 03 августа 2023 00:37

Раздел: Помощь и обучение

TurboConf SDK API OneScript Помощь


Свойства и методы класса ТурбоКонф / TurboConf

ТурбоКонф / TurboConf

Методы

Клавиша / Key()

Выполжняет нажатие клавиши заданное количество раз

Параметры

  • key : Клавиша. Перечисление Клавиши коды клавиш

  • count : Количество нажатий. По умолчанию 1. Число

КонтролКлавиша / ControlKey()

Выполжняет нажатие клавиши с Control, заданное количество раз

Параметры

  • key : Клавиша. Перечисление Клавиши

  • count : Количество нажатий. По умолчанию 1. Число

ШифтКлавиша / ShiftKey()

Выполжняет нажатие клавиши с Shift, заданное количество раз

Параметры

  • key : Клавиша. Перечисление Клавиши

  • count : Количество нажатий. По умолчанию 1. Число

АльтКлавиша / AltKey()

Выполжняет нажатие клавиши с Alt, заданное количество раз

Параметры

  • key : Клавиша. Перечисление Клавиши

  • count : Количество нажатий. По умолчанию 1. Число

КонтролШифтКлавиша / ControlShiftKey()

Выполжняет нажатие клавиши с Control и Shift, заданное количество раз

Параметры

  • key : Клавиша. Перечисление Клавиши

  • count : Количество нажатий. По умолчанию 1. Число

АльтШифтКлавиша / AltShiftKey()

Выполжняет нажатие клавиши с Alt и Shift, заданное количество раз

Параметры

  • key : Клавиша. Перечисление Клавиши

  • count : Количество нажатий. По умолчанию 1. Число

КонтролАльтКлавиша / ControlAltKey()

Выполжняет нажатие клавиши с Ctrl и Alt, заданное количество раз

Параметры

  • key : Клавиша. Перечисление Клавиши

  • count : Количество нажатий. По умолчанию 1. Число

НажатьКлавишу / KeyDown()

Выполжняет нажатие клавиши и оставляет ее нажатой

Параметры

  • key : Клавиша. Перечисление Клавиши

ОтжатьКлавишу / KeyUp()

Выполняет отжатие клавиши

Параметры

  • key : Клавиша. Перечисление Клавиши

КликнутьПоЭлементу/ ClickOnElement()

Кликает по элементу с заданным названием и типом

Параметры

  • name : Название элемента. Строка

  • controlType : Тип элемента управления. Строка

    Значения controlType: панель, документ, поле, поле со списком, элемент списка, кнопка, меню, элемент меню, флажок.

  • mouseButton : Кнопка мыши 0 - левая, 1 - правая. Число

  • doubleClick : Определяет двойное нажатие. Булево

ВставитьТекст / PasteText()

Вставляет заданный текст

Параметры

  • text : Строка

ОтправитьТекст / SendText()

Вставляет заданный текст путем симуляции нажатий клавиш клавиатуры

Параметры

  • text : Строка

ПоказатьУведомление / ShowNotification()

Показывает уведомление в системном трее

Параметры

  • text : Текст уведомления. Строка

  • timeout : Период времени в милисекундах. По умолчанию 10000. Число

ПоказатьВсплывающееУведомление / ShowPopupNotification()

Показывает уведомление в системном трее в виде небольшого окна

Параметры

  • title : Заголовок уведомления. Строка

  • text : Текст уведомления. Строка

  • timeout : Период времени в милисекундах. По умолчанию 10000. Число

ПоказатьПодсказку / ShowHint()

Показывает подсказку в окне конфигуратора

Параметры

  • text : Текст уведомления. Строка

ПерейтиВПозицию / GoToPosition()

Выполняет установку каретки и переход в заданную позицию

Параметры

  • col : Номер колонки, начиная с 1. Число

  • row : Номер строки, начиная с 1. Число

ПолучитьЗначение / GetValue()

Возвращает текст текущего элемента

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

Текст элемента. Строка

Копировать / Copy()

Выполняет копирование текста

Вставить / Paste()

ПолучитьТекстМодуля / GetModuleText()

Получает текст модуля и позицию каретки

Параметры

  • selectedText : Выделенный текст. Строка

  • pos : Текущая позиция в строке, начиная с 0. -1 не удалось определить. Число

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

Текст модуля. Строка

ПолучитьТекстСПозицией / GetTextWithPos()

Получает текст модуля, позицию каретки, номер текущий строки и колонки

Параметры

  • selectedText : Выделенный текст. Строка

  • pos : Текущая позиция в строке, начиная с 0. -1 не удалось определить. Число

  • col : Номер текущей колонки, начиная с 1. Число

  • row : Номер текущей строки, начиная с 1. Число

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

Текст модуля. Строка

ПолучитьПозициюПоИндексу / GetPositionByIndex()

Получает позицию каретки, по индексу строки

Параметры

  • text : Выделенный текст. Строка

  • pos : Текущая позиция в строке, начиная с 0. Число

  • col : Возращаемый номер колонки, начиная с 1. Число

  • row : Возращаемый номер строки, начиная с 1. Число

ПерейтиВПозицию / GoToPosition()

Выполняет установку каретки в заданную позицию

Параметры

  • col : Номер колонки, начиная с 1. Число

  • row : Номер строки, начиная с 1. Число

Ждать / Sleep()

Остановка выполнения скрипта на заданное время в миллисекнудах

Параметры

  • milliseconds : Время ожидания в милисекундах. Число

ПерезагрузитьСкрипты / ReloadScripts()

Выполняет перезагрузку скриптов

Ждать / WaitFor()

Ожидает открытия и закрытия окна

Параметры

  • title : Заголовок окна. Строка

  • timeout : Время ожидания в милисекундах. Число

  • containsText : Искать вхождение строки. По умолчанию Ложь. Булево

ЖдатьОкно / WaitForWindow()

Ожидает открытия окна и возвращает указатель на него

Параметры

  • title : Заголовок окна. Строка

  • timeout : Время ожидания в милисекундах. Число

  • throwException : Вызывать исключение, если не удалось дождаться окна. Булево

  • containsText : Искать вхождение строки. По умолчанию Ложь. Булево

ЖдатьОкно / WaitForWindow()

Ожидает открытия окна и возвращает указатель на него

Параметры

  • title : Заголовок окна. Строка

  • timeout : Время ожидания в милисекундах. Число

ЖдатьЗакрытияОкна / WaitForWindowClosed()

Ожидает закрытия окна

Параметры

  • handle : Указатель на окно. Число

  • title : Заголовок окна. Строка

  • timeout : Время ожидания в милисекундах. Число

ЖдатьЗакрытияОкна / WaitForWindowClosed()

Ожидает закрытия окна

Параметры

  • handle : Указатель на окно. Число

  • title : Заголовок окна. Строка

  • timeout : Время ожидания в милисекундах. Число

  • throwException : Вызывать исключение. По умолчанию Истина. Булево

ЖдатьЗакрытияОкна / WaitForWindowClosed()

Ожидает закрытия окна

Параметры

  • handle : Указатель на окно. Число

  • title : Заголовок окна. Строка

  • timeout : Время ожидания в милисекундах. Число

  • containsText : Искать вхождение строки. По умолчанию Ложь. Булево

  • throwException : Вызывать исключение. По умолчанию Истина. Булево

Перейти / JumpTo()

Переход к объекту конфигурации

Пример:

ТурбоКонф.Перейти("Справочник.Банки");

Параметры

  • path : Путь к объекту. Строка

  • throwException : Вызывать исключение. По умолчанию Истина. Булево

ПолучитьБуферОбмена / GetClipboard()

Возвращает текущий буфер обмена

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

Содержимое буфера. Строка

УстановитьБуферОбмена / SetClipboard()

Устанавливает буфер обмена

Параметры

  • text : Устанавливаемое значение. Строка

ОбработатьСобытия / DoEvents()

Обрабатывает все сообщения Windows, которые в данный момент находятся в очереди сообщений

ОткрытьМеню / OpenMenu()

Открыть пункт главного меню конфигуратора

Параметры

  • text : Название меню. Строка
  • menuItem : Название пункта меню или подменю. Строка
  • submenuItem : Название пункта меню в подменю. Строка

ПолучитьЗаголовокТекущегоОкна / GetForegroundWindowTitle()

Возвращает заголовок текущего окна.

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

Заголовок текущего окна. Строка

ПереключитьРаскладкуКлавиатуры / SwitchKeyboardLayout()

Переключает раскладку клавиатуры.

Параметры

  • language : Код языка "auto" (следующий язык), "ru", "en". Строка

НайтиЭлементПоИмени()

НайтиЭлементПоТипу()

НайтиЭлементыПоТипу()

ПолучитьТипТекущегоЭлемента()

ПолучитьЗаголовокОкна()

АктивироватьОкно()/ActivateWindow()

ПолучитьАктивноеОкно()/GetForegroundWindow()

ЭтоТекстовоеПоле()

EnableScript()

ПолучитьКаталогСкрипта()

ПолучитьВерсиюAPI()

MaximizeWindowIfNeeded() Описание дополняется...

Конструкторы

По умолчанию

Страница разработки в соцсетях: https://vk.com/turboconf


К списку тем

Комментарии

nytlenc
01 июня 2018 17:52: #1

key : Клавиша. Перечисление Клавиши А где посмотреть список перечислений? Не могу подобрать нужный параметр. Как юзать? :)


nytlenc
01 июня 2018 17:53: #2

И еще у метода "Вставить / Paste()" нет описания


nytlenc
01 июня 2018 17:58: #3

Все разобрался - см. штатную подсказку 1С к "Клавиша" пример использования: ТК.НажатьКлавишу(Клавиша.BackSpace);


bolsun
15 января 2019 13:26: #4

Коды клавиш для перечисления Клавиши (Keys)

https://docs.microsoft.com/ru-ru/dotnet/api/system.windows.forms.keys?redirectedfrom=MSDN&view=netframework-4.5.2

bolsun
08 октября 2019 13:18: #5

bolsun переместил тему в раздел Помощь и обучение


Михаил К.
08 января 2020 15:27: #6

Добрый день. Как можно добраться до главного меню конфигуратора? Так-то нажимаю Alt подсвечивается Файл. Далее либо по подчеркнутой букве перехожу в нужное меню, либо стрелками. А в скрипте попробовал ТК.Клавиша(Keys.Alt) - не отрабатывает.


bolsun
09 января 2020 14:10: #7

(6) Михаил К.,добрый день. Используйте код LMenu Все коды клавиш для перечисления Клавиши (Keys) в комментарии #4


Михаил К.
10 января 2020 18:26: #8

Да, спасибо. Просто искал в списке по слову Аlt, а дальше не пошел. Похоже, что есть способ проще добраться до нужного мне меню Конфигурация. Например, в одном из скриптов опубликованных на сайте я увидел следующее: ТурбоКонф.OpenConfigurationMenu Это в этой статье здесь не задокументировано. Назрело пару вопросов: 1. Также можно добраться до любого меню шапки в конфигураторе? Если да, то какие команды для этого нужны. 2. Как добраться до подменю, кроме как КликнутьПоЭлементу. Например, нужно зайти в Конфигурация - Хранилище конфигурации и там кликнуть по нужной команде.


bolsun
16 января 2020 16:33: #9

(8) Михаил Кузнецов, 1. да с помощью ТурбоКонф.OpenConfigurationMenu можно вызывать пункты из меню Конфигурация. Постараюсь добавить возможность вызова подменю и сделать описание. 2. пока подменю можно вызвать с помощью нажатий клавиш или КликнутьПоЭлементу, как написал выше постараюсь сделать более удобные функции.


bolsun
20 января 2020 15:39: #10

(8) Михаил Кузнецов, в SDK 5.11 появится функция для вызова главного меню конфигуратора

https://turboconf.ru/Forum/Details/6592

glaviznin
30 мая 2020 22:14: #11

как получить выделенный текст в текущем выделеном модуле?


bolsun
31 мая 2020 08:34: #12

(11) glaviznin, см. метод ПолучитьТекстМодуля()


glaviznin
31 мая 2020 23:56: #13

(12) bolsun, какието есть возможности,идеи как выделенный текс передать в открыту 1с в режиме предприятия?
в идеале конечно отловить её там обработкавнешнегособытия.
всю голову сломал.


reborn85
01 июня 2020 00:08: #14

Есть команда
ТурбоКонф.Перейти("Справочник.Банки");
а как перейти просто в Справочники ?

задача свернуть все дерево МД до 1го уровня, думал перейти в каждый объект, потом клавишами на право а потом на лево и свернет


bolsun
01 июня 2020 10:10: #15

(13) glaviznin, не совсем понял, что Вы хотите сделать.


bolsun
01 июня 2020 10:16: #16

(14) reborn85, через дерево конфигурации


TurboConf.CtrlShiftKey(Keys.C);
TurboConf.Key(Keys.Home);
TurboConf.CtrlShiftKey(Keys.Subtract);
TurboConf.Key(Keys.Add);

//Общий модуль
TurboConf.Key(Keys.Down);
TurboConf.Key(Keys.Add);
TurboConf.Sleep(200);
TurboConf.Key(Keys.Down);
TurboConf.Key(Keys.Down);
TurboConf.Key(Keys.Insert);

//Справочник
TurboConf.Key(Keys.Down);
TurboConf.Key(Keys.Down);
TurboConf.Key(Keys.Down);
TurboConf.Key(Keys.Insert);

//Документ
TurboConf.Key(Keys.Down, 4);
TurboConf.Key(Keys.Insert);

//Перечисление
TurboConf.Key(Keys.Down, 6);
TurboConf.Key(Keys.Insert);

//Отчет
TurboConf.Key(Keys.Down, 7);
TurboConf.Key(Keys.Insert);

//Обработка
TurboConf.Key(Keys.Down, 8);
TurboConf.Key(Keys.Insert);

glaviznin
01 июня 2020 10:29: #17

(15) bolsun, Расскажу подробнее.
Программист работает в какой то базе в режиме Предприятия, там у него есть задачи на работу.
Так же дорабатывает базу(она центральная и постоянная) в ней в момент доработки он вставляет дату и номер документа задачи.
Хотелось бы при выделении такого комментария в конфигураторе, передать его в Предрприятие , там определить документ и открыть форму.
Вот если я правильно рассуждаю, то это можно сделать только отловив внешнеее событие .
У меня есть свое внешняя библиотека постоянно подключенная к базе.
Теоретически в ней можно сделать систему которая будет мониторить какую то очередь/стек/память/каталог и в случае появления события, вызывать ExternalEvent
Но думаю вдруг что то готовое есть.


bolsun
01 июня 2020 12:30: #18

(17) glaviznin, не знаю насколько это реально сделать. Все таки программа предназначена для работы в конфигураторе и взаимодействие с режимом предприятия выходит за рамки предполагаемого применения.


glaviznin
01 июня 2020 13:19: #19

Ок. Спасибо. Буду делать тогда через каталог файлов, с опросом его через предприятие.


Михаил К.
12 апреля 2022 10:45: #20

Добрый день! Как запомнить значение галочки в окошке после изменения?
ПолучитьЗначение() возвращает пустую строку в любом случае.

Пишу скрипт которое открывает окошко, кликает по галочке и закрывает окошко. Это происходит очень быстро. Мне необходимо запомнить значение галочки, чтобы сообщить её значение пользователю.


bolsun
12 апреля 2022 14:26: #21

(20) Михаил Кузнецов, добрый день!
Получить значение флажка в текущей версии API нельзя.
Добавлю в следующей тестовой версии, она в ближайшее время будет доступна.


Михаил К.
12 апреля 2022 19:02: #22

(21) bolsun, понятно. Тогда подскажите, как после ОткрытьМеню поставить паузу, чтобы увидеть отображение окошка?
Пример:
Турбоконф.ОткрытьМеню("Отладка", "Остановка по ошибке...");
Турбоконф.Клавиша(Keys.Space);
<Что я тут ни вставлял и sleep(5000) и WaitForWindow(...) ничего не помогало и просто было какое-то зависание без отображения окошка. Раньше вроде с КликнутьПоЭлементу пауза прокатывала>
Турбоконф.КонтролКлавиша(Keys.Enter);


bolsun
13 апреля 2022 15:57: #23

(20) Михаил К., получение состояния и установка флажка добавлено в TurboConf 5.16.8138.30305


bolsun
13 апреля 2022 16:02: #24

(22) Михаил К., можете подробнее объяснить что Вы хотите сделать скриптом? После показа окна "Остановка по ошибке", что должно происходить?


Михаил К.
13 апреля 2022 18:31: #25

(24) bolsun, с помощью скрипта включаю и отключаю остановку по ошибке. Но это происходит очень быстро и не видно установил ты галочку или снял. С последним обновлением можно уже и устанавливать и получать значение флага и сообщать его. Но была идея просто не сразу закрывать окно, а сделать паузу чтобы можно было увидеть этот чекбокс визуально. В общем хотелось бы задержать окошко открытым на некоторое время, например на секунду.


Михаэль
19 апреля 2023 12:51: #26

Добрый день. А есть какая-то возможность отобразить диалоговое окно с выбором кнопок?
Пробовал Вопрос() и для списка значения .ВыбратьЭлемент() - не срабатывает.


нашел https://turboconf.ru/Forum/Details/3626


TurboConf

Расширение возможностей

Конфигуратора 1С

Скачать

Бесплатный пробный период 14 дней