> For the complete documentation index, see [llms.txt](https://chaoses-ib.gitbook.io/directory-opus/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/msg.zh.md). # Msg **Msg** 对象表示一个 [脚本对话框](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-4.md) 输入事件消息。它由 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.GetMsg** 方法返回，该方法在您为 [独立对话框](/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-4/readme.zh/detached_dialogs.zh.md) 运行消息循环时调用。 | 属性名称 | 返回类型 | 说明 | | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *<默认值>* | *bool* | 如果消息有效，则返回 **True**，如果对话框已关闭，则返回 **False**（这意味着您应退出消息循环）。 | | | buttons | *string* | 返回一个字符串，表示生成消息时按下了哪个鼠标按钮。可能的值为 **left**、**right** 和 **middle**。 | | | checked | *int* |

如果事件类型为 checked，则表示该项目的选中状态。如果在自动模式下使用复选框，这将是该项目的新选中状态。在手动模式下，这将表示 现有 状态，并且由您决定是否更改状态。

选中状态为：

string

|

返回事件中涉及的控件的名称。您可以通过将此字符串传递给 Dialog.Control 方法来获取表示该控件的 Control 对象。

| | | | | | | **0** | 未选中 | | | | **1** | 选中 | | | | **2** | 不确定 | | | | **3** | 未选中/禁用 | | | | **4** | 选中/禁用 | | | | **5** | 不确定/禁用 | | | | | | | | | | | | | | control | | | | | cx | *int* | 对于 **resize** 事件，该属性返回对话框的新宽度。 | | | cy | *int* | 对于 **resize** 事件，该属性返回对话框的新高度。 | | | data | *int* 或// bool// |

如果事件类型为 focus，则表示控件的新焦点状态 - 如果控件获得了焦点，则为 True；如果失去了焦点，则为 False。

对于 组合框 或 列表框 控件：如果事件类型为 selchange 或 dblclk，则返回与选定项目关联的数据值。

对于 复选框 控件或 单选按钮：如果事件类型为 click，则返回一个 bool，表示当前选中状态。

对于三态 复选框：如果事件类型为 click，则返回一个 int，表示当前状态。

如果事件类型为 timer，则此值表示自上次触发此计时器以来经过的毫秒数。

如果事件类型为 tab，并且 value 属性设置为 filechange，则这表示在受监控的标签页中发生了哪些文件更改事件。 1 = 添加，2 = 删除，4 = 更改。这些值将被相加（例如 6 表示至少有一项被更改并且至少有一项被删除）。

| | | dialog | *string* | 返回父对话框的名称。 | | | event | *string* |

返回一个字符串，表示发生的事件。当前定义的事件为：

bool

| 如果控件在生成消息时有焦点，则返回 **True**。 | | | | | | | **invalid** | 对话框已关闭 | | | | **checked** | 对于启用了 ***Checkboxes*** 属性的列表视图控件，表示已单击了列表项的复选框。 | | | | **click** | 单击了该控件（例如按钮、复选框、单选按钮、启用 ***Notify Clicks*** 属性的标记文本或静态控件）。 | | | | **close** | 用户单击了对话框的关闭按钮。仅在将 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.want\_close** 属性设置为 **True** 时才生成。您需要使用 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.EndDlg** 方法手动关闭对话框。 | | | | **dblclk** | 双击了列表中的项目（列表框、组合框或列表视图）或双击了控件（启用 \***Notify Clicks** 的静态控件）。 | | | | **dirchange** | 通过 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.WatchChanges** 方法建立了对其进行监视的文件或文件夹已发生更改。 **control** 属性告诉您触发哪个观察器。 | | | | **drag** | 用户已从静态控件或列表视图控件启动拖放。您可以通过调用 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.Drag** 方法来响应。必须在控件上启用 ***Drag Source*** 属性才能生成此事件。 | | | | **拖放** | 文件已拖放到你的对话框上。对话框模板必须将它的 ***接受拖放*** 属性设置为 **True**，才能启用拖放支持。 | | | | **编辑变更** | 编辑字段的内容已修改。对于列表视图，这个事件表示列表项的标记已编辑。 | | | | **获取焦点** | 控件获得或失去焦点。 | | | | **热键** | 已按下一个按键组合，其使用 [**对话框**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.AddHotkey** 方法添加为热键。 | | | | **调整大小** | 对话框已被用户调整大小。仅当 [**对话框**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.want\_resize** 属性已设置为 **True** 时才会生成。不要将手动调整大小和自动调整大小与同一个控件混合：如果你在响应此事件时移动或调整控件大小，则该控件不应在对话框编辑器中设置任何 **调整大小** 标志。 | | | | **右键单击** | 列表中的某一项已右键单击（列表框，列表视图），或已右键单击控件（启用了 ***通知单击*** 属性的静态控件）。 | | | | **选择更改** | 选择项已更改（列表框，组合框，列表视图或标签页）。 | | | | **计时器** | 已过使用 [**对话框**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.SetTimer** 方法创建的周期性计时器。 | | | | **标签页** | 在使用 [**对话框**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.WatchTab** 方法监控的标签页中已发生事件。 | | | | | | | | | | | | | | focus | | | | | index | *int* | 返回 *组合框*、*列表框* 或 *标签页控件* 的当前选择索引。 | | | mousex | *int* | 返回消息生成时鼠标光标的水平位置。 | | | mousey | *int* | 返回消息生成时鼠标光标的垂直位置。 | | | object | 对于 **拖放** 事件，此属性返回 [**Vector**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/vector.zh.md) [**Item**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/item.zh.md) 对象，代表拖放到你的对话框上的文件。 | | | | qualifiers | *string* |

返回指示在生成消息时按下的限定键（如果有的）的字符串。

该字符串可能包含以下任意或全部内容：shift、ctrl、alt、lwin、rwin

如果没有按任何限定键，则字符串为：none

| | | result | *bool* | 如果消息有效，则返回 **True**；如果对话框已关闭，则返回 **False**。 | | | tab | *string* |

对于对话框标签页控件，如果控件位于标签页控件内部的对话框中，则返回父标签页的名称。

如果事件类型为 tab，则返回一个 Tab 对象，该对象代表发生事件的受监控标签页。反复调用此操作可能会导致效率低下。

| | | value | *string* |

对于 dblclk、editchange和 selchange 事件，返回编辑字段（或选定项标签）的当前内容。

对于 tab 事件，指示在受监控标签页中发生的事件。可能的值包括 select、navigate、filechange、activate、srcdst、view、flat 和 close（在你监控时如果标签页已关闭，则会发送）。

对于 drag 事件，这表示用于拖动的按钮（left 或 right）。

对于来自标记文本控件的 click 事件，这表示已单击的链接的 ID。

| | | | | | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - | | **invalid** | 对话框已关闭 | | | **checked** | 对于启用了 ***Checkboxes*** 属性的列表视图控件，表示已单击了列表项的复选框。 | | | **click** | 单击了该控件（例如按钮、复选框、单选按钮、启用 ***Notify Clicks*** 属性的标记文本或静态控件）。 | | | **close** | 用户单击了对话框的关闭按钮。仅在将 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.want\_close** 属性设置为 **True** 时才生成。您需要使用 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.EndDlg** 方法手动关闭对话框。 | | | **dblclk** | 双击了列表中的项目（列表框、组合框或列表视图）或双击了控件（启用 \***Notify Clicks** 的静态控件）。 | | | **dirchange** | 通过 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.WatchChanges** 方法建立了对其进行监视的文件或文件夹已发生更改。 **control** 属性告诉您触发哪个观察器。 | | | **drag** | 用户已从静态控件或列表视图控件启动拖放。您可以通过调用 [**Dialog**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.Drag** 方法来响应。必须在控件上启用 ***Drag Source*** 属性才能生成此事件。 | | | **拖放** | 文件已拖放到你的对话框上。对话框模板必须将它的 ***接受拖放*** 属性设置为 **True**，才能启用拖放支持。 | | | **编辑变更** | 编辑字段的内容已修改。对于列表视图，这个事件表示列表项的标记已编辑。 | | | **获取焦点** | 控件获得或失去焦点。 | | | **热键** | 已按下一个按键组合，其使用 [**对话框**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.AddHotkey** 方法添加为热键。 | | | **调整大小** | 对话框已被用户调整大小。仅当 [**对话框**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.want\_resize** 属性已设置为 **True** 时才会生成。不要将手动调整大小和自动调整大小与同一个控件混合：如果你在响应此事件时移动或调整控件大小，则该控件不应在对话框编辑器中设置任何 **调整大小** 标志。 | | | **右键单击** | 列表中的某一项已右键单击（列表框，列表视图），或已右键单击控件（启用了 ***通知单击*** 属性的静态控件）。 | | | **选择更改** | 选择项已更改（列表框，组合框，列表视图或标签页）。 | | | **计时器** | 已过使用 [**对话框**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.SetTimer** 方法创建的周期性计时器。 | | | **标签页** | 在使用 [**对话框**](/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh.md)**.WatchTab** 方法监控的标签页中已发生事件。 | | | | | | | | | | | focus | | | | | | | | ------- | ------ | - | | **0** | 未选中 | | | **1** | 选中 | | | **2** | 不确定 | | | **3** | 未选中/禁用 | | | **4** | 选中/禁用 | | | **5** | 不确定/禁用 | | | | | | | | | | | control | | |