# Control **Control** 对象表示 [脚本对话框](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-8/readme.zh-4) 上的一个控件；它允许您读取和修改控件的值（和内容）。使用 [**Dialog**](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialog.zh)**.Control** 方法获取 **Control** 对象。 | 属性名称 | 返回类型 | 描述 | | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | bg | *string* | 设置或查询用于此控件背景（填充）的颜色。格式为 *#RRGGBB*（十六进制）或 *RRR,GGG,BBB*（十进制）。目前仅支持 *静态文本* 和 *列表视图* 控件的此属性。 | | charcase | *string* | 对于 *编辑* 控件，获取或设置控件的大小写设置。有效值为 **upper**、**lower** 和 **normal**。 | | columns | *object:*[**DialogListColumns**](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialoglistcolumns.zh) | 对于 *列表视图* 控件，返回一个 [**DialogListColumns**](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dialoglistcolumns.zh) 对象，允许您查询或修改 *详细信息* 模式下的列。 | | count | *int* | 返回控件中包含的项目数（例如，在 *组合框*、*列表框* 或 *列表视图* 中，返回列表中的项目数）。 | | cuetext | *string* | 获取或设置单行编辑控件的提示文本。这是在编辑控件为空时显示的文本，用于帮助用户。 | | cx | *int* | 设置或查询控件的宽度，以像素为单位。 | | cy | *int* | 设置或查询控件的高度，以像素为单位。 | | enabled | *bool* | 设置或查询控件的启用状态。如果控件已启用，则返回 **True**，如果已禁用，则返回 **False**。您可以设置此属性来更改状态。 | | fg | *string* | 设置或查询用于此控件文本（前景）的颜色。格式为 *#RRGGBB*（十六进制）或 *RRR,GGG,BBB*（十进制）。目前仅支持 *静态文本* 和 *列表视图* 控件的此属性。 | | focus | *bool* | 设置或查询控件的输入焦点状态。如果控件当前具有输入焦点，则返回 **True**，如果它没有焦点，则返回 **False**。设置为 **True** 以使控件获得输入焦点。 | | image |

string 或
object:Image

| 对于设置为图像模式的按钮或静态控件，这会将图像分配给控件。您可以提供文件名（或内部图标名称 - 例如 `#about` 用于内部关于图标），或从 [**DOpus**](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/dopus.zh)**.LoadImage** 或 [**Script**](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/script.zh)**.LoadImage** 方法获取的 [**Image**](https://chaoses-ib.gitbook.io/directory-opus/guan-fang-shou-ce/readme.zh-10/readme.zh-3/readme.zh/image.zh) 对象。 | | label |

string 或
object:Image

|

设置或查询控件的标签或标题。并非所有控件都有标签 - 这不会对没有标签的控件（如 列表视图）产生影响。

请注意，对于 组合框 控件，此属性仅对可编辑组合框有效 - 也就是说，您可以键入自己的文本。您可以使用此属性来设置或查询可编辑文本的当前值。

对于设置为“图像”模式的静态控件，您还可以提供从 DOpus.LoadImage 或 Script.LoadImage 方法获取的 Image 对象。这与使用 image 属性相同。

对于 标签页 控件，您可以通过指定索引来设置或查询各个标签页的标签；例如，Control.label(0) 将引用第一个标签页的标签。

| | mode | *string* | 对于 *列表视图* 控件，允许您更改或查询当前视图模式。有效值为 **icon**、**details**、**smallicon**、**list**。 | | readonly | *bool* | 设置或查询 *编辑* 控件的 *只读* 状态。 | | redraw | *bool* | 设置或查询控件的重绘状态。某些控件允许您关闭重绘，以便在进行多个更改时不会出现可见的闪烁（例如，在 *列表视图* 中添加大量项目）。设置为 **False** 以关闭重绘，或设置为 **True** 以在更改控件后重新打开重绘。 | | rotate | *int* | 对于设置为“图像”模式的 *静态文本* 控件，您可以设置此属性以旋转显示的图像。提供的值是从图像初始方向旋转的度数。 | | style | *string* |

设置或查询用于显示此控件标签的字体样式。字符串包含零个或多个字符；有效字符为 b 表示粗体，i 表示斜体。

目前仅支持 静态文本 控件的此属性。

| | textbg | *string* |

设置或查询用于此控件文本背景（填充）的颜色。格式为 #RRGGBB（十六进制）或 RRR,GGG,BBB（十进制）。

目前仅支持 列表视图 控件的此属性。

| | title |

string 或
object:Image

| **label** 属性的替代名称。术语 **title** 用于对话框编辑器和 XML 资源中，也可以在这里用作方便的术语。 | | value |

string 或
bool 或
int 或
object:DialogListItem 或
object:Vector

|

设置或查询控件的值。此属性的含义取决于控件的类型：

请注意，对于多选 列表框 或 列表视图，此值将返回一个 Vector，其中包含 DialogListItem 对象，表示当前选中的所有项目。

| | visible | *bool* | 设置或查询控件的可见状态。如果控件可见，则返回 **True**，如果隐藏，则返回 **False**。您可以设置此属性以隐藏或显示控件。 | | x | *int* | 设置或查询控件的左（x）位置，以像素为单位。 | | y | \*int \* | 设置或查询控件的顶部（y）位置，以像素为单位。 |
方法名称参数返回类型描述
AddGroup<string:name>
<int:id>
[<string:flags>]		int

向 列表视图 控件添加一个新组。您可以选择将添加到列表的项目放在组中。每个组必须具有唯一的 ID。

可选的标志为“c”（组可折叠）和“d”（组最初处于折叠状态）。例如，AddGroup("Unimportant", 100, "cd") 将添加一个名为 Unimportant 的组，该组最初是折叠的。

AddItem

<string:name>
[<int:value>]
[<int:groupid>]

或

<object:item>

int

向控件（列表框、组合框 或 列表视图）添加一个新项目。第一个参数是项目的名称，可选的第二个参数是与项目关联的数据值。

在向分组的 列表视图 添加项目时，可选的第三个参数提供要向其添加项目的组的 ID（在这种情况下必须提供第二个参数，如果不需要值，则可以将其设置为 0）。

该项目将添加到列表的末尾。

您还可以传递从另一个控件获取的 DialogListItem 对象。

返回值指示新项目的列表位置。

如果您要添加到列表视图控件并需要添加具有多列的项目，您可以执行以下操作（JScript）：

var i = listview.AddItem("This is col 1");
listview.GetItemAt(i).subitems(0) = "This is col 2";
listview.GetItemAt(i).subitems(1) = "This is col 3";
AutoSize[<bool:height>]bool

自动调整控件大小，如果控件类型支持自动调整大小。如果控件已自动调整大小，则返回 True。

如果可选的 height 参数设置为 true，则控件将垂直和水平自动调整大小。

DeselectItem

<int:position>

或

<object:item>

int

此方法主要用于多选 列表框 和 列表视图 控件。它允许您取消选择控件中的单个项目，同时保留其它项目被选中（或不受影响）。

您可以指定要选择的项目的索引（0 表示第一个项目，1 表示第二个项目，依此类推），或者指定从 GetItemAt 或 GetItemByName 方法获取的 DialogListItem 对象。

您还可以指定 -1 以取消选择列表框中的所有项目。

EnableGroupView<bool:enable>none仅适用于 列表视图 控件。默认情况下，组视图处于关闭状态；在使用 AddGroup 方法添加组后，使用 EnableGroupView 打开组视图。
GetGroupById<int:id>object:DialogListGroup返回一个 DialogListGroup 对象，表示您之前使用 AddGroup 方法添加到 列表视图 控件的具有指定 ID 的组。
GetItemAt<int:position>object:DialogListItem返回一个 DialogListItem 对象，表示控件中指定索引位置的项目（列表框、组合框 或 列表视图）。项目 0 表示列表中的第一个项目，项目 1 表示第二个项目，依此类推。
GetItemByLabel
GetItemByName		<string:name>object:DialogListItem返回一个 DialogListItem 对象，表示控件中具有指定名称的项目（列表框、组合框或列表视图）。此方法有两个名称（...Label 和 ...Name），出于历史原因，您可以互换使用任一方法名称）。
InsertItemAt

<int:position>
<string:name>
[<int:value>]
[<int:groupid>]

或

<int:position>
<object:item>

int

在控件（列表框、组合框或列表视图）中插入一个新项目。第一个参数是要插入项目的位置（0 表示列表开头，1 表示第二个位置，依此类推）。第二个参数是项目的名称，可选的第三个参数是与项目关联的数据值。

在向分组的 列表视图 添加项目时，可选的第四个参数提供要向其添加项目的组的 ID（在这种情况下必须提供第三个参数，如果不需要值，则可以将其设置为 0）。

除了 name 和 value 之外，您还可以传递从另一个控件获取的 DialogListItem 对象。

返回值指示新项目的列表位置。

MoveItem<int:position>
or
<object:item>
<int:newposition>		int

将现有项目移动到新位置（列表框、组合框 或 列表视图）。第一个参数是要移动的项目（您可以传递其索引或 DialogListItem 对象），第二个参数是项目要移动到的新位置。

返回值指示已移动项目的列表位置。

RemoveGroup<int:id>none从 列表视图 控件中删除指定的组。
RemoveItem<int:position>
or
<object:item>		none

从控件（列表框、组合框或列表视图）中删除一个项目。您可以提供要删除项目的索引（0 表示第一个项目，1 表示第二个项目，依此类推），或者提供从 GetItemAt 或 GetItemByName 方法获取的 DialogListItem 对象。

您还可以指定 -1 以完全清除控件的内容，一次性删除所有项目。

SelectItem<int:position>
or
<object:item>
or
<string:tab>		int

在控件中选择一个项目。对于 列表框、组合框或列表视图，您可以指定要选择的项目的索引（0 表示第一个项目，1 表示第二个项目，依此类推），或者提供从 GetItemAt 或 GetItemByName 方法获取的 DialogListItem 对象。

对于多选 列表框 或 列表视图，您还可以指定 -1 以选择控件中的所有项目。

对于 标签页 控件，您可以通过指定要显示的页面名称（即子对话框的名称）来更改可见的页面。

返回值指示新的选中索引。

SelectRange

<int:start>
<int:end>

或

<object:item1>
<object:item2>

object:Vector

在 编辑控件（或 组合框 控件中的编辑字段）中选择文本。这两个参数表示所需选择的开始和结束位置。要选择整个内容，请将 0 用于开始，将 -1 用于结束。

返回值是一个 Vector，它有两个成员，提供选择的当前开始和结束位置。要查询范围而不更改它，只需在不带任何参数的情况下调用 SelectRange 方法即可。

在 列表框 或 列表视图 控件中，此方法会选择一系列项目。

SetFont<int:id>none将控件使用的字体设置为指定的字体。id 参数必须来自对 Dialog.CreateFont 的先前调用。您可以使用 0 将字体重置为默认值。
SetItemWidth<int:width>none设置设置为 list 或 smallicon 模式的列表视图控件中项目的宽度（以像素为单位）。指定 -1 以自动调整项目大小。
SetPos<int:x>
<int:y>		none设置此控件的位置。x 和 y 坐标以像素为单位。
SetPosAndSize<int:x>
<int:y>
<int:cx>
<int:cy>		none以单个操作设置控件的位置和大小。所有坐标均以像素为单位。
SetSize<int:cx>
<int:cy>		none设置此控件的大小。cx（宽度）和 cy（高度）值以像素为单位。