Interface modding

在《钢铁雄心IV》中，接口是指玩家用来与游戏交互的用户界面。

概述

接口文件的组件可以分为两组：容器和元素。例如，containerWindowType 是一个容器，而 iconType 是一个元素。

接口文件使用 .gui 文件类型。所有接口文件都可以在 /Hearts of Iron IV/interface/ 中找到。

当出现 internal 字样时，这个部分的源代码是只有P社可以修改的，即它所指的主题是不可修改的。

宏

可以在界面文件中使用宏，以便更轻松地调整位置。

例如，这将使一个名为 WINDOW_X_POS 的宏，其值为 10。

@WINDOW_X_POS = 10

可以在元素中这样引用它：

containerWindowType = {
    name = "my_container"
    position = { x = @WINDOW_X_POS y = -600 }

    # ...
}

容器

容器用于将元素组合在一起，并将它们与内部函数相关联。

除非通过脚本化 GUI，否则无法添加新容器。这是因为容器的 name 属性在内部链接到容器所需的任何数据。常见的例外是，您可以在 countrytechtreeview.gui 中为自定义技术文件夹添加新容器。

容器定义的顺序和嵌套会影响它们的显示方式。

containerWindowType

最常见的容器类型，用于保存任何一组元素。

通常使用以下属性：

name - 容器的名称。
background - 容器的背景。
position - 容器的屏幕位置。
size - 容器的边界框。接受百分数( 如 100%% )。
moveable - 设置是否可以拖动容器。
fullscreen -设置是否将容器全屏化。
orientation - 设置 position 属性的方向原点。
clipping - 设置容器是否将修剪其他元素（如在边界处剪切其元素）。

以下属性用于动画容器：

show_position - 容器在显示模式下移动到的屏幕位置。
hide_position - 容器在隐藏模式下移动到的屏幕位置。
show_animation_type - The animation type used to show the container (always decelerated).用于显示容器的动画类型（始终减速）。
hide_animation_type - The animation type used to hide the container (always accelerated).用于隐藏容器的动画类型（始终加速）。
animation_time - 动画播放时间（始终为 300）。
upsound - 当容器移动到显示位置时要播放的声音。
downsound - 当容器移动到隐藏位置时要播放的声音。
fade_time - 淡入淡出的时间。
fade_type - 淡入的类型（始终为线性）。

以下属性很少或从不使用：

dontRender - 不渲染
horizontalBorder - 水平边界
verticalBorder - 垂直边界

scrollbarType

滚动条类型用于定义滚动条由哪些元素组成。

使用以下属性：

name - 滚动条名称。
slider - 用作滚动条滑块的按钮元素。
track - 用作滚动条跟踪器的按钮元素。
leftbutton - 用作滚动条左增量按钮的按钮元素。
rightbutton - 用作滚动条右增量按钮的按钮元素。
position - 滚动条的屏幕位置。
size - 滚动条的边界框。
priority - 滚动条相对于其他元素的优先级。
borderSize - 滚动条边框的边界框。
maxValue - 滚动条能移动的最大值（用于控制增量）。
minValue - 滚动条能移动的最小值（用于控制增量）。
stepSize - 使用增量按钮的单次增量大小。
startValue - 滚动条滑块的初始大小。
horizontal - 设置滚动条是水平（1）还是垂直（0）。

Elements

容器中使用了多种元素类型。所有元素都必须在容器内使用，它们不会在容器之外工作。

元素将继承它们所在的容器的方向，除非为自己指定了方向。

以下元素可以自由添加，并可用于脚本化 GUI。

iconType - 用于静态图像。
instantTextBoxType - 用于文本。
buttonType - 用于按钮。

以下元素依赖于内部代码。您可以添加新元素，它们不会填充数据。

smoothListboxType - 用于平滑滚动列表。
listboxType - 用于滚动列表。
checkboxType - 用于复选框。
OverlappingElementsBoxType - 用于重叠元素。
editBoxType - 用于可编辑的文本框。
shieldtype - 用于显示国家/地区旗帜。

以下元素已过时：

guiButtonType - 与 buttonType 相同。
textBoxType -与 instantTextBoxType 相同。
eu3dialogtype - 与 windowType 相同。
shieldtype - 仅在 eu3dialogtype 中使用。较新的文件中的标志使用不同的元素。

iconType

图标元素用于向接口添加图像。它的用法与 buttonType 重叠，但后者作为按钮运行。

使用以下属性：

name - 图标名称。
position - 图标的屏幕位置。
orientation - 设置位置属性的方向原点。
spriteType - 用于图标的图像。引用 spriteType 定义。
quadTextureSprite - 用于图标的图像。引用动态的 spriteType 定义（例如旗帜）或多帧的 spriteType 定义。
frame - 使用多帧图像时要用于图标的帧。
alwaystransparent - 强制图标无法被点击，如点击只能一个元素后面的另一个元素。
hint_tag - 设置鼠标悬停在图标上方时用于显示提示的关键字。
pdx_tooltip - 设置要向玩家显示的提示。采用本地化关键字。
pdx_tooltip_delayed - 设置要向玩家延迟显示的提示。采用本地化关键字。
centerposition - 设置位置是否以图标的中心为原点。

instantTextBoxType

实例文本框元素用于向界面添加文本。在某些情况下，元素的文本是在内部生成的（如regiment_count）。在这些情况下，除非文本在本地化字符串中公开，否则无法对其进行编辑。

使用以下属性：

name - 文本框名称。
position - 文本框的屏幕位置。
orientation - 设置位置属性的方向原点。
text - 文本框显示的文本。
font - 用于文本的字体。
maxWidth - 显示文本的总宽度，以像素为单位。
maxHeight - 显示文本的总高度，以像素为单位。
format - 文本的对齐方式。
fixedsize - 文本框是否截断超出其边框的文本。
borderSize - 文本框边框的边界框。
alwaystransparent - 强制文本无法被点击，如点击只能一个元素后面的另一个元素。
pdx_tooltip - 设置要向玩家显示的提示。采用本地化关键字。
pdx_tooltip_delayed - 设置要向玩家延迟显示的提示。采用本地化关键字。

以下属性很少或从不使用：

textureFile - 从不使用。

可用的 format 值:

left
centre
right

buttonType

guiButtonType 元素用于向界面添加按钮。按钮由图像和文本组成，因此它们的操作方式与 iconType 和 instantTextBoxType 类似。

使用以下属性：

name - 按钮名称。
position - 按钮名称。
orientation - 设置位置属性的方向原点。
spriteType - 用于按钮的图像。引用 spriteType 定义。
quadTextureSprite - 用于按钮的图像。引用动态的 spriteType 定义（如旗帜）或多帧的 spriteType 定义。
frame - 使用多帧图像时要用于按钮的帧。
alwaystransparent - 强制按钮无法被点击，如点击只能一个元素后面的另一个元素。
buttonText - 按钮显示的文本。
buttonFont - 用于按钮文本的字体。
shortcut - 为此按钮添加的快捷方式。
clicksound - 点击时要播放的声音。
oversound - 悬停时要播放的声音。
hint_tag - 设置鼠标悬停在按钮上方时用于显示提示的关键字。
pdx_tooltip - 设置要向玩家显示的提示。采用本地化关键字。
pdx_tooltip_delayed - 设置要向玩家延迟显示的提示。采用本地化关键字。
scale - 缩放按钮大小。

以下属性很少或从不使用：

tooltip - 从未使用过。
tooltipText - 从未使用过。
delayedTooltipText - 从未使用过。

smoothListboxType

The smoothListboxType element is used to define a listbox, which is a scrollable list that is populated with entries. Typically these elements are internally linked with another container, which composes the actual entry used in the list box.