Scintilla icon SciTE Helper - ActiveX Control для SciTE
Документация   FAQ   Регулярные выражения   SciTE Extension   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
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-ru.org>"
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: 2.0

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

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

SciTE Helper требует для своей работы библиотеки msvbvm60.dll. Если на Вашей системе данная библиотека отсутствует, то ее необходимо скачать самостоятельно.

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