MsgPlus::CreateWnd

The MsgPlus::CreateWnd function creates a new window based on an Interface XML file. For more information, see Windows for your Script.

该msgplus ： ： createwnd功能，创建一个新的窗口的基础上，
接口XML文件。如需详细资讯，请参阅
在Windows为您的脚本。

Syntax

[object] CreateWnd(
    [string] XmlFile,
    [string] WindowId,
    [number,optional] Options
);

Parameters

XmlFile

[string] Path to the Interface XML file. This is where the entire window is defined. The path is relative to the script's directory by default, to override this behavior, prefix the path with "\". Example: "\C:\directory\windows.xml".

WindowId

[string] Unique identifier of the window to create. A window with the same identifier has to be found in the XML file for the function to succeed.

Options

[number,optional] If specified, this parameter can be one of the following numbers:

WNDOPT_NORMAL (0) WNDOPT_INVISIBLE (1) WNDOPT_NOACTIVATE (2) wndopt_normal （ 0 ） wndopt_invisible （ 1 ） wndopt_noactivate （ 2 ）

Display the window normally (default) Don't show the window after it's been created Don't activate the window after its creation 展示的窗口，通常（默认） 不显示窗口后，它的创造 不激活窗口后，其创造

The following flags can also be added to specify additional characteristics:

WNDOPT_RTL (128) wndopt_rtl （ 128 ）

Display the window with a right-to-left layout (if supported by the system). Requires Messenger Plus! 4.10 or above. 展示窗口与从右到左布局（如支持由 系统） 。需要Messenger Plus！ 4.10或以上。

Return Value

A PlusWnd object that you can use to control every aspect of the new window. If the window cannot be created, the return value is null.

1 pluswnd对象，您可以使用控制的各个方面，新
窗口。如果窗口无法建立，返回值是
空。

This function typically fails for the following reason:

这项功能通常失败，原因如下：

• The specified XML interface file is not valid.

Remarks

Interface XML files should always be validated for both syntax and compliance with the interface windows' schema file. In some occasions, the file can appear to be validated but still fail to load. This can be caused by a missing required attribute (like Height for some controls), duplicated control/element identifiers and other runtime specific reasons.

接口XML文件应始终验证双方的语法和
遵守界面
Windows的架构文件。在某些情况下，该文件可以出现在被
验证，但仍无法负荷。这可以造成一人失踪
必要的属性（如高度为一些
控制） ，重复控制/元素的标识符和其他运行
具体理由。

Images specified in a script's interface file are searched in two places. First, Messenger Plus! looks in the "Images" sub-directory of the script's directory. That's where you should store all your custom made pictures. If the image cannot be found there, Messenger Plus! looks in its own resources for a matching name. This can be useful to reuse pictures seen in Messenger Plus! windows without having to bundle them with your script. Be careful to check if the images are still there when an update of Messenger Plus! is released though.

图像指定在一个脚本的接口文件是搜查，在两个地方。
第一，Messenger Plus！看来，在“图片”分目录脚本的
目录。这也就是你应该存放所有您的自定义所作的图片。如果
图片不能在那里发现，Messenger Plus！看来在自己的资源，为
匹配的名称。这可以是有益的重用的图片看到，在Messenger Plus！
在Windows不必捆绑他们与您的脚本。仔细检查，如果
图像仍然存在，当一个更新的Messenger加！虽然是释放。

You should refrain from creating windows when the user has enabled Messenger Lock. This can be checked with MessengerIsLocked.

你应避免创建Windows当用户启用信使
锁。这可以检查与
messengerislocked 。

Messenger Plus! 4.23 and earlier: enumeration names are not available, numbers must be used instead.

Function Information

See Also

MsgPlus Object, Windows for your Script, Interface Windows Reference.

  Sponsor

  Links