Plugin:MirLua/ru/m core - Revision history

Unsane at 18:59, 14 December 2015

2015-12-14T18:59:10Z

@@ Line 6: / Line 6: @@
 __TOC__
 == Именованные события ==
@@ Line 19: / Line 32: @@
 : Возвращает дескриптор события, если событие было успешно создано, иначе '''nil'''
 ;Пример
-{{Content:MirLua/Example|code=local hEvent = m.CreateHookableEvent('MyEvent')}}
+{{Content:MirLua/Example|code=
 === HookEvent ===
@@ Line 38: / Line 56: @@
 : Возвращает дескриптор ловушки, если ловушка была успешно создана, иначе '''nil'''
 ;Пример
-{{Content:MirLua/Example|code=local hHook = m.HookEvent('MyEvent', function(w, l)
+{{Content:MirLua/Example|code=
    print('MyEvent is raised!')
 end)
@@ Line 109: / Line 128: @@
 : Возвращает результат выполнения сервиса или [[#CALLSERVICE_NOTFOUND|CALLSERVICE_NOTFOUND]]
 ; Пример
-{{Content:MirLua/Example|code=m.CallService('MyService', 0, 0)}}
+{{Content:MirLua/Example|code=
 === ServiceExists ===
@@ Line 190: / Line 214: @@
 {{Content:MirLua/Example|code=local profileName = m.ReplaceVariables('%miranda_profilename%')}}
 [[Category:Руководства]]

Unsane: /* UnhookEvent */

2015-12-10T15:48:50Z

UnhookEvent

← Older revision		Revision as of 18:48, 10 December 2015
Line 51:		Line 51:
	; Результат		; Результат
	: Тип: '''boolean'''		: Тип: '''boolean'''
	: Возвращает '''true''', если ~~функции-ловушки~~ успешно удалена, иначе '''false'''.		: Возвращает '''true''', если ловушка успешно удалена, иначе '''false'''.
	; Пример		; Пример
	{{Content:MirLua/Example\|code=m.UnhookEvent(hHook)}}		{{Content:MirLua/Example\|code=m.UnhookEvent(hHook)}}

ΡBot: /* HookEvent */trailing spaces clean up

2015-12-08T13:50:58Z

HookEvent: trailing spaces clean up

← Older revision		Revision as of 16:50, 8 December 2015
Line 24:		Line 24:
	Устанавливает функцию обратного вызова («ловушку») для реакции на вызов события. Ловушки вызываются в порядке добавления по цепочке друг за другом.		Устанавливает функцию обратного вызова («ловушку») для реакции на вызов события. Ловушки вызываются в порядке добавления по цепочке друг за другом.

	Сигнатура ловушки: <code>function (wParam, lParam) return 0 end</code>.		Сигнатура ловушки: <code>function (wParam, lParam) return 0 end</code>.

	Корректным результатом работы ловушки является 0. При возврате 1 следующие в цепочке ловушки не будут вызваны.		Корректным результатом работы ловушки является 0. При возврате 1 следующие в цепочке ловушки не будут вызваны.

RMN: parameters written in bold italics are obligatory

2015-12-07T21:29:45Z

parameters written in bold italics are obligatory

← Older revision		Revision as of 00:29, 8 December 2015
Line 1:		Line 1:
	{{PageLang\|ru}}		{{PageLang\|ru}}
	Этот модуль изначально импортирован в глобальную таблицу и доступен через переменную '''m''' в любом модуле. Он предоставляет доступ к основным возможностям ядра Miranda NG.		Этот модуль изначально импортирован в глобальную таблицу и доступен через переменную '''m''' в любом модуле. Он предоставляет доступ к основным возможностям ядра Miranda NG.

			{{Note\|Параметры, выделенные '''''жирным курсивом''''', являются обязательными.}}

RMN at 13:03, 7 December 2015

2015-12-07T13:03:31Z

← Older revision		Revision as of 16:03, 7 December 2015
Line 48:		Line 48:
	:: Дескриптор события, который был получен при вызове [[#CreateHookableEvent\|CreateHookableEvent]]		:: Дескриптор события, который был получен при вызове [[#CreateHookableEvent\|CreateHookableEvent]]
	; Результат		; Результат
	: Тип: '''boolean''		: Тип: '''boolean'''
	: Возвращает '''true''', если функции-ловушки успешно удалена, иначе '''false'''.		: Возвращает '''true''', если функции-ловушки успешно удалена, иначе '''false'''.
	; Пример		; Пример
Line 66:		Line 66:
	; Пример		; Пример
	{{Content:MirLua/Example\|code=m.NotifyEventHooks(hEvent)}}		{{Content:MirLua/Example\|code=m.NotifyEventHooks(hEvent)}}

	<!--		<!--
	=== DestroyHookableEvent ===		=== DestroyHookableEvent ===
Line 77:		Line 76:
	: Тип: '''boolean'''		: Тип: '''boolean'''
	: Возвращает '''true''', если событие успешно удалено, иначе '''false'''		: Возвращает '''true''', если событие успешно удалено, иначе '''false'''
	{{Content:MirLua/Example\|code=m.DestroyHookableEvent(hEvent)}}		{{Content:MirLua/Example\|code=m.DestroyHookableEvent(hEvent)}} -->
	-->

	== Именованные сервисные функции ==		== Именованные сервисные функции ==

ΡBot: angle quotes

2015-12-06T16:27:29Z

angle quotes

← Older revision		Revision as of 19:27, 6 December 2015
Line 20:		Line 20:

	=== HookEvent ===		=== HookEvent ===
	Устанавливает функцию обратного вызова (~~"ловушку"~~) для реакции на вызов события. Ловушки вызываются в порядке добавления по цепочке друг за другом.		Устанавливает функцию обратного вызова («ловушку») для реакции на вызов события. Ловушки вызываются в порядке добавления по цепочке друг за другом.

	Сигнатура ловушки: <code>function (wParam, lParam) return 0 end</code>.		Сигнатура ловушки: <code>function (wParam, lParam) return 0 end</code>.
Line 82:		Line 82:
	== Именованные сервисные функции ==		== Именованные сервисные функции ==
	=== CreateServiceFunction ===		=== CreateServiceFunction ===
	Создает сервисную функцию (~~"сервис"~~)		Создает сервисную функцию («сервис»)
	; Параметры		; Параметры
	: '''''name'''''		: '''''name'''''

RMN: Plugin:MirLua/ru/m core

2015-12-03T20:16:27Z

Plugin:MirLua/ru/m core

New page

{{PageLang|ru}}
Этот модуль изначально импортирован в глобальную таблицу и доступен через переменную '''m''' в любом модуле. Он предоставляет доступ к основным возможностям ядра Miranda NG.

__TOC__

== Именованные события ==
=== CreateHookableEvent ===
Создает событие

;Параметры
: '''''name'''''
:: Тип: '''string'''
:: Имя события
;Результат
: Тип: '''light userdata'''
: Возвращает дескриптор события, если событие было успешно создано, иначе '''nil'''
;Пример
{{Content:MirLua/Example|code=local hEvent = m.CreateHookableEvent('MyEvent')}}

=== HookEvent ===
Устанавливает функцию обратного вызова ("ловушку") для реакции на вызов события. Ловушки вызываются в порядке добавления по цепочке друг за другом.

Сигнатура ловушки: <code>function (wParam, lParam) return 0 end</code>.

Корректным результатом работы ловушки является 0. При возврате 1 следующие в цепочке ловушки не будут вызваны.
;Параметры
: '''''name'''''
:: Тип: '''string'''
:: Имя события.
: '''''hook'''''
:: Тип: '''function'''
:: Функция-ловушка, которая будет вызвана при наступлении события.
;Результат
: Тип: '''light userdata'''
: Возвращает дескриптор ловушки, если ловушка была успешно создана, иначе '''nil'''
;Пример
{{Content:MirLua/Example|code=local hHook = m.HookEvent('MyEvent', function(w, l)
print('MyEvent is raised!')
end)
}}

=== UnhookEvent ===
Удаляет ловушку из цепочки вызовов события.
; Параметры
: '''''hEvent'''''
:: Тип: '''light userdata'''
:: Дескриптор события, который был получен при вызове [[#CreateHookableEvent|CreateHookableEvent]]
; Результат
: Тип: '''boolean''
: Возвращает '''true''', если функции-ловушки успешно удалена, иначе '''false'''.
; Пример
{{Content:MirLua/Example|code=m.UnhookEvent(hHook)}}

=== NotifyEventHooks ===
Поочередно вызывает все ловушки в цепочке вызова события.
; Параметры
: '''''hEvent'''''
:: Тип: '''light userdata'''
:: Дескриптор события, который был получен при вызове [[#CreateHookableEvent|CreateHookableEvent]].
: ''wParam''
: ''lParam''
; Результат
: Тип: '''boolean'''
: Возвращает '''true''', если вызваны все функции-ловушки, иначе '''false'''.
; Пример
{{Content:MirLua/Example|code=m.NotifyEventHooks(hEvent)}}



== Именованные сервисные функции ==
=== CreateServiceFunction ===
Создает сервисную функцию ("сервис")
; Параметры
: '''''name'''''
:: Тип: '''string'''
:: Имя сервиса.
; Результат
: Тип: '''light userdata'''
: Возвращает дескриптор сервиса, если сервис бы успешно создан, иначе nil
; Пример
{{Content:MirLua/Example|code=local hService = m.CreateServiceFunction('MyService', function(w, l)
print('MyServiceis called!')
end)
}}

=== CallService ===
Вызывает сервис с параметрами
; Параметры
: '''''name'''''
:: Тип: '''string'''
:: Имя сервиса
: ''wParam''
: ''lParam''
; Результат
: Тип: '''number'''
: Возвращает результат выполнения сервиса или [[#CALLSERVICE_NOTFOUND|CALLSERVICE_NOTFOUND]]
; Пример
{{Content:MirLua/Example|code=m.CallService('MyService', 0, 0)}}

=== ServiceExists ===
Проверяет существование сервиса по имени
; Параметры
: '''''name'''''
:: Тип: '''string'''
:: Имя сервиса
; Результат
: Тип: '''boolean'''
: Возвращает '''true''', если сервис существует, иначе '''false'''
; Пример
{{Content:MirLua/Example|code=if m.ServiceExists('MyService') then
m.CallService('MyService')
end}}

=== DestroyServiceFunction ===
Удаляет сервисную функцию
; Параметры
: '''''hService'''''
:: Тип: '''light userdata'''
:: Дескриптор сервиса, полученный при вызове [[#CreateServiceFunction|CreateServiceFunction]]
; Пример
{{Content:MirLua/Example|code=m.DestroyServiceFunction(hService)}}

== Остальное ==
=== IsPluginLoaded ===
Проверяет загружен ли плагин по его uuid
; Параметры
: '''''uuid'''''
:: Тип: '''string'''
:: Uuid плагина в формате ''xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx''
; Результат
: Тип: '''boolean'''
: Возвращает '''true''', если плагин загружен, иначе '''false'''.
; Пример
{{Content:MirLua/Example|code=if m.IsPluginLoaded('{F0FDF73A-753D-499d-8DBA-336DB79CDD41}') then
print('Advanced auto away plugin is loaded!')
end
}}

=== Utf8DecodeA ===
Конвертирует содержимое lua строки в ANSI (кодовая страница берется из текущего языкового пакета).
: '''''text'''''
:: Тип: '''string'''
; Результат
: Тип: '''string'''
; Пример
{{Content:MirLua/Example|code=m.CallService("Quotes/Import", 0, Utf8DecodeA('c:\\quotes.xml'))}}

=== Utf8DecodeW ===
Конвертирует содержимое lua строки в unicode (utf-16)
: '''''text'''''
:: Тип: '''string'''
; Результат
: Тип: '''string'''
; Пример
{{Content:MirLua/Example|code=m.CallService("Popup/ShowMessageW", m.Utf8DecodeW('Hello, World!'), 2)}}

=== Translate ===
Переводит строку на язык текущего языкового пакета
: '''''text'''''
:: Тип: '''string'''
; Результат
: Тип: '''string'''
; Пример
{{Content:MirLua/Example|code=m.Translate('Exit')}}

=== ReplaceVariables ===
Заменяет переменные ядра Miranda NG в строке
: '''''text'''''
; Результат
: Тип: '''string'''
; Пример
{{Content:MirLua/Example|code=local profileName = m.ReplaceVariables('%miranda_profilename%')}}

== Константы ==
=== NULL ===
Нулевой указатель
: Тип: '''light userdata'''
;Пример
{{Content:MirLua/Example|code=
if hEvent == m.NULL then
print('Event handle is empty!')
end
}}

=== INVALID_HANDLE_VALUE ===
Невалидный дескриптор
:Тип: '''light userdata'''
;Пример
{{Content:MirLua/Example|code=
if hEvent == m.NULL then
print('Event handle is invalid!')
end
}}

=== CALLSERVICE_NOTFOUND ===
Результат вызова несуществующего сервиса
:Тип: '''number'''
;Пример
{{Content:MirLua/Example|code=
local result = m.CallService('MyService')
if result == m.CALLSERVICE_NOTFOUND then
print('Service is not found!')
end
}}

[[Category:Руководства]]