| SciTE Helper - ActiveX Control for SciTE
Документация FAQ Регулярные выражения LUA SciTE Director Команды SciTE и Scintilla Сборка Ru-Board Ядро SciTE-Ru Shell SciTE Helper История

### Описание

Freeware ActiveX компонент для организации взаимодействия между текстовым редактором SciTE и любыми скриптами и приложениями поддерживающими COM интерфейс.

### Установка, инициализация и удаление

Для регистрации SciTE Helper в вашей системе запустите `Setup.vbs` (он выполнит команду OC regsvr32 SciTE.dll)

Для работы с SciTE Helper необходимо в Вашем скрипте произвести инициализацию объекта:

On Error Resume Next
Set SciTE = CreateObject("SciTE.Helper")
If Err.Number <> 0 Then
WScript.Echo "Please install SciTE Helper before!"
WScript.Quit 1
End If
On Error GoTo 0

Для отмены регистрации запустите `Setup.vbs` повторно (он выполнит команду OC regsvr32 /U SciTE.dll)

В SciTE-Ru регистрация SciTE Helper и ее отмена происходит автоматически при выборе пункта меню 'Tools' - 'Настройка интеграции с Windows...'

### Свойства

Left() As Long [read only] Top() As Long [read only] Width() As Long [read only] Height() As Long [read only] | Возвращает размеры и позицию окна SciTE. Эти свойства эквивалентны параметрам SciTE position.left, position.top, position.width, position.height Пример использования: WScript.Echo "position.left = " & SciTE.Left WScript.Echo "position.top = " & SciTE.Top WScript.Echo "position.width = " & SciTE.Width WScript.Echo "position.height = " & SciTE.Height
Get GetText() As String [read only] | Возвращает весь текст из активного буфера SciTE. Это свойство работает аналогично lua директиве editor:GetText() Пример использования: WScript.Echo SciTE.GetText
GetSelText() As String [read only] | Возвращает выделенный текст из активного буфера SciTE. Возвращаемый текст, идентичен тому, что содержится во внутренней переменной SciTE $(CurrentSelection) Пример использования: WScript.Echo SciTE.GetSelText
Props(ByVal Key As String) As String [read] Props(ByVal Key As String, RHS As String) [write] | Возврат и установка значения любого из параметров SciTE. Эквивалентно lua директиве props["property.name"] Пример использования: SciTE.Props("my.key") = WScript.Name WScript.Echo SciTE.Props("my.key")
WindowID() As Long [read] WindowID(RHS As Long) [write] | Возвращает значение идентификатора того окна SciTE из которого был запущен данный скрипт или программа. Позволяет установить (при наличии нескольких окон SciTE) одно, с которым будет осуществляться обмен через `SciTE Director Interface`. Пример использования: SciTEWindowID = SciTE.WindowID WScript.Echo SciTEWindowID

### Методы

Send(ByVal Data As String) As String | Осуществляет отправку в SciTE заданной последовательности команд, используя `SciTE Director Interface`. Возвращает в вызывающий скрипт или программу полученное значение. Список всех доступных команд - в файле SciTEDirector_rus.html Пример использования: WScript.Echo SciTE.Send("askproperty:character.set")
LUA(ByVal Command As String) As String | Позволяет выполнить в SciTE заданные lua команды. Возвращает в вызывающий скрипт или программу полученное значение. Пример использования: WScript.Echo SciTE.LUA("editor.CurrentPos")
ReplaceSel (ByVal ReplaceText As String) | Заменяет выделенный на активной странице SciTE текст. Экивалентен lua директиве editor:ReplaceSel(string). Возвращаемое значение отсутствует. Пример использования: SciTE.ReplaceSel "<http://scite.net.ru>"
MenuCommand (ByVal IDM_Command As String) | Выполняет любую команду меню SciTE. Возвращаемое значение отсутствует. Список всех доступных команд - в файле CommandValuesExt_rus.html Пример использования: SciTE.MenuCommand 902
Trace (ByVal Data As String) | Выводит текст в окне консоли SciTE (без префикса и перевода строки). Экивалентен директиве trace(string). Возвращаемое значение отсутствует. Пример использования: SciTE.Trace "First line" & "\r\n" & "Second line" & "\r\n"
OnTop (ByVal WindowName As String, ByVal OnTop As Boolean) | Устанавливает для окна приложения режим "поверх всех окон". Возвращаемое значение отсутствует. Пример использования: SciTE.OnTop document.title, True
Focus () | Переводит фокус ввода в окно SciTE. Возвращаемое значение отсутствует. (Полезно, когда скрипт или программа похищает фокус из SciTE) Пример использования: SciTE.Focus
About () | Показывает сообщение "О программе". Возвращаемое значение отсутствует. Пример использования: SciTE.About

### Загрузка

Текущая версия SciTE Helper: 1.4

SciTE.dll (включая документацию и примеры скриптов)
Исходный код

### Известные недостатки

`SciTE Helper` написан на Visual Basic 5.0 и требует для своей работы библиотеки `msvbvm50.dll`, которая имеется во всех версиях Windows, до Windows XP SP1 включительно. В более поздних версиях данная библиотека отсутствует и ее необходимо скачать самостоятельно.
Предложение по решению данной проблемы изложено в Issue 62

`SciTE Helper` в настоящее время не ловит события SciTE. Реализация данной возможности стоит в планах.