WSO 1.1: Интерфейс WindowSystemObjectExtensions

AddMessageHandler	(	[in] IDispatch *	Control,
		[in] LONG	Message,
		[in] VARIANT	MessageHandler
	)

Позволяет задать обработчик оконного события для контрола.

Аргументы:

	Control	контрол.
	Message	ID оконного сообщения.
	MessageHandler	обработчик события.

Параметр Control может быть:

Control.
WindowSystemObject, в этом случае обработчик события будет вызываться для любого компонента (начиная с версии 1.1.16).

Заметки:: Если компонент - ActiveXControl, то обработчик события будет срабатывать для каждого его дочернего окна (начиная с версии 1.1.16).

Обработчик события будет вызываться до обработки события контролом с параметрами:

Sender - контрол
Message - ID оконного сообщения
WPARAM - первый параметр сообщения.
LPARAM - второй параметр сообщения.
bHandled - объект типа Result. Установка в данном объекте значения на true приведет к запрету дальнейшей обработки события контролом.
MessageResult - объект типа Result. Результат обработки сообщения (целое число) (начиная с версии 1.1.9).

Пример, запрет контекстного меню ActiveX компонента (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 500
f.ClientHeight = 300
f.CenterControl()
f.Text = "Web Browser"

t = f.Menu.Add("File")
t.Add("Exit","ESC").OnExecute = CloseFormHandler

Browser = f.CreateActiveXControl(0,0,0,0,"{8856F961-340A-11D0-A96B-00C04FD705A2}")
Browser.Align = o.Translate("AL_CLIENT")


f.Show()

Browser.Control.Navigate(StartupDir() + "ActiveXNoContextMenu.js.htm")

ext = new ActiveXObject("Scripting.WindowSystemObjectExtensions")

ext.AddMessageHandler(Browser,WM_RBUTTONDOWN = 0x0204, MessageHandler)
ext.AddMessageHandler(Browser,WM_RBUTTONDBLCLK = 0x0206, MessageHandler)


o.Run()

function MessageHandler(Sender,Message,WParam,LParam,Handled,Result)
{
        Handled.Value = true
}


function CloseFormHandler(Sender)
{
        Sender.Form.Close()
}


function StartupDir() {s = WScript.ScriptFullName; s = s.substring(0,s.lastIndexOf("\\")+1); return s; }

Начиная с:: 1.1.5.

CreateClipboard	(	[in, defaultvalue(FALSE)] VARIANT_BOOL	ClipboardViewer,
		[out, retval] IDispatch **	Clipboard
	)

Создает объект Clipboard.

Аргументы:

ClipboardViewer

Задает свойство ClipboardViewer объекта Clipboard.

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

Clipboard

Созданный объект.

Начиная с:: 1.1.9.

CreateExecutor ( [out, retval] IDispatch ** Result )

Создает объект Executor.

Начиная с:: 1.1.17.

CreateIconBuilder ( [out, retval] IDispatch ** Result )

Создает объект IconBuilder.

Начиная с:: 1.1.17.

EnumWindows ( [out, retval] IDispatch ** Result )

Возвращает список объектов Window, соответствующим всем окнам верхнего уровня.

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

Список

объектов Window.

Начиная с:: 1.1.9.

GetFileSysIconIndexLarge	(	[in] BSTR	pVal,
		[in, defaultvalue(0)] ULONG	FileAttributes,
		[out, retval] ULONG *	Result
	)

Возвращает индекс в системном списке больших иконок файлов для заданного файла.

Аргументы:

	pVal	Имя файла
	FileAttributes	Атрибуты файла (0 - при определении иконки система может обращаться к файлу).

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

Result

Индекс иконки.

Начиная с:: 1.1.10.

GetFileSysIconIndexSmall	(	[in] BSTR	pVal,
		[in, defaultvalue(0)] ULONG	FileAttributes,
		[out, retval] ULONG *	Result
	)

Возвращает индекс в системном списке маленьких иконок файлов для заданного файла.

Аргументы:

	pVal	Имя файла
	FileAttributes	Атрибуты файла (0 - при определении иконки система может обращаться к файлу).

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

Result

Индекс иконки.

Начиная с:: 1.1.10.

PostCopyData	(	[in] VARIANT	Control,
		[in] BSTR	Data,
		[out, retval] VARIANT *	pVal
	)

Посылает сообщение WM_COPYDATA окну.

Это может быть окно Form .

Аргументы:

	Control	Окно.
	Data	Данные.

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

pVal

Результат обработки сообщения (TRUE/FALSE).

Начиная с:: 1.1.9.

PostMessage	(	[in] VARIANT	Control,
		[in] LONG	Message,
		[in] LONG	wParam,
		[in] VARIANT	lParam,
		[out, retval] VARIANT *	pVal
	)

Посылает сообщение контролу.

По смыслу аналогичен функции PostMessage WinAPI.

Начиная с:: 1.1.5.

RegisterWindowMessage	(	[in] BSTR	Message,
		[out, retval] ULONG *	MessageId
	)

Регистрирует оконное сообщение.

См. также:: RegisterWindowMessage в WinAPI.

Аргументы:

Message

Имя сообщения.

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

MessageId

ID Сообщения.

Начиная с:: 1.1.9.

SendCopyData	(	[in] VARIANT	Control,
		[in] BSTR	Data,
		[out, retval] VARIANT *	pVal
	)

Посылает сообщение WM_COPYDATA окну.

Это может быть окно Form .

Аргументы:

	Control	Окно.
	Data	Данные.

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

pVal

Результат обработки сообщения.

Начиная с:: 1.1.9.

SendMessage	(	[in] VARIANT	Control,
		[in] LONG	Message,
		[in] LONG	wParam,
		[in] VARIANT	lParam,
		[out, retval] VARIANT *	pVal
	)

Посылает сообщение контролу.

По смыслу аналогичен функции SendMessage WinAPI.

Начиная с:: 1.1.5.

UuidCreate ( [out, retval] BSTR * Result )

Генерирует UUID.

См. также:: UuidCreate в MSDN.

Начиная с:: 1.1.16.

VARIANT_BOOL R IsThemeActive

Возвращает "TRUE", если темы активны.

См. также:: WindowSystemObject::EnableVisualStyles.

Начиная с:: 1.1.16.

VARIANT_BOOL R IsWindows7

Возвращает "TRUE", если текущая операционная система Windows 7 или более поздней версии.

Начиная с:: 1.1.10.

VARIANT_BOOL R IsWindows8

Возвращает "TRUE", если текущая операционная система Windows 8 или более поздней версии.

Начиная с:: 1.1.10.

VARIANT_BOOL R IsWindowsVista

Возвращает "TRUE", если текущая операционная система Windows Vista или более поздней версии.

Начиная с:: 1.1.10.

VARIANT_BOOL R IsWindowsXP

Возвращает "TRUE", если текущая операционная система Windows XP или более поздней версии.

Начиная с:: 1.1.10.

IDispatch* R SystemImageListLarge

Возвращает ImageList который является системным списком больших иконок файлов.

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

pVal

ImageList.

Начиная с:: 1.1.10.

IDispatch* R SystemImageListSmall

Возвращает ImageList который является системным списком маленьких иконок файлов.

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

pVal

ImageList.

Начиная с:: 1.1.10.

Интерфейс WindowSystemObjectExtensions

Открытые члены

Свойства

Подробное описание

Методы

Полный список свойств


Открытые члены
	SendMessage ([in] VARIANT Control,[in] LONG Message,[in] LONG wParam,[in] VARIANT lParam,[out, retval] VARIANT *pVal)
	Посылает сообщение контролу.
	PostMessage ([in] VARIANT Control,[in] LONG Message,[in] LONG wParam,[in] VARIANT lParam,[out, retval] VARIANT *pVal)
	Посылает сообщение контролу.
	AddMessageHandler ([in] IDispatch *Control,[in] LONG Message,[in] VARIANT MessageHandler)
	Позволяет задать обработчик оконного события для контрола.
	RegisterWindowMessage ([in] BSTR Message,[out, retval] ULONG *MessageId)
	Регистрирует оконное сообщение.
	EnumWindows ([out, retval] IDispatch **Result)
	Возвращает список объектов Window, соответствующим всем окнам верхнего уровня.
	SendCopyData ([in] VARIANT Control,[in] BSTR Data,[out, retval] VARIANT *pVal)
	Посылает сообщение WM_COPYDATA окну.
	PostCopyData ([in] VARIANT Control,[in] BSTR Data,[out, retval] VARIANT *pVal)
	Посылает сообщение WM_COPYDATA окну.
	CreateClipboard ([in, defaultvalue(FALSE)] VARIANT_BOOL ClipboardViewer,[out, retval] IDispatch **Clipboard)
	Создает объект Clipboard.
	GetFileSysIconIndexSmall ([in] BSTR pVal,[in, defaultvalue(0)] ULONG FileAttributes,[out, retval] ULONG *Result)
	Возвращает индекс в системном списке маленьких иконок файлов для заданного файла.
	GetFileSysIconIndexLarge ([in] BSTR pVal,[in, defaultvalue(0)] ULONG FileAttributes,[out, retval] ULONG *Result)
	Возвращает индекс в системном списке больших иконок файлов для заданного файла.
	UuidCreate ([out, retval] BSTR *Result)
	Генерирует UUID.
	CreateIconBuilder ([out, retval] IDispatch **Result)
	Создает объект IconBuilder.
	CreateExecutor ([out, retval] IDispatch **Result)
	Создает объект Executor.
Свойства
IDispatch *R	SystemImageListSmall `[]`
	Возвращает ImageList который является системным списком маленьких иконок файлов.
IDispatch *R	SystemImageListLarge `[]`
	Возвращает ImageList который является системным списком больших иконок файлов.
VARIANT_BOOL R	IsWindowsXP `[]`
	Возвращает "TRUE", если текущая операционная система Windows XP или более поздней версии.
VARIANT_BOOL R	IsWindowsVista `[]`
	Возвращает "TRUE", если текущая операционная система Windows Vista или более поздней версии.
VARIANT_BOOL R	IsWindows7 `[]`
	Возвращает "TRUE", если текущая операционная система Windows 7 или более поздней версии.
VARIANT_BOOL R	IsWindows8 `[]`
	Возвращает "TRUE", если текущая операционная система Windows 8 или более поздней версии.
VARIANT_BOOL R	IsThemeActive `[]`
	Возвращает "TRUE", если темы активны.