查看源代码 wxStaticText (wx v2.4.3)

静态文本控件显示一行或多行只读文本。

wxStaticText 支持三种经典文本对齐方式、标签省略（即如果标签不适合提供的空间，则用省略号“...”替换部分文本）以及使用 wxControl::SetLabelMarkup() 进行格式化标记（在 wx 中未实现）。

样式

此类支持以下样式

wxALIGN_LEFT：将文本向左对齐。
wxALIGN_RIGHT：将文本向右对齐。
wxALIGN_CENTRE_HORIZONTAL：将文本水平居中对齐。
wxST_NO_AUTORESIZE：默认情况下，当调用 setLabel/2 时，控件将调整其大小以完全适应文本的大小。如果给定此样式标志，则控件不会更改其大小（此样式对于也具有 wxALIGN_RIGHT 或 wxALIGN_CENTRE_HORIZONTAL 样式的控件特别有用，因为否则在调用 setLabel/2 后它们将不再有意义）。
wxST_ELLIPSIZE_START：如果标签文本宽度超过控件宽度，则用省略号替换标签的开头；使用 wxControl::Ellipsize（在 wx 中未实现）。
wxST_ELLIPSIZE_MIDDLE：如果标签文本宽度超过控件宽度，则用省略号替换标签的中间；使用 wxControl::Ellipsize（在 wx 中未实现）。
wxST_ELLIPSIZE_END：如果标签文本宽度超过控件宽度，则用省略号替换标签的末尾；使用 wxControl::Ellipsize（在 wx 中未实现）。

参见

此类派生自以下类，并可以使用其函数：

wxWidgets 文档：wxStaticText

概要

类型

wxStaticText()

函数

create(This, Parent, Id, Label)

等效于 create(This, Parent, Id, Label, [])。

create/5

创建函数，用于两步构造。

destroy(This)

销毁对象

getLabel(This)

返回控件的标签，如传递给 wxControl:setLabel/2 的那样。

new()

默认构造函数。

new(Parent, Id, Label)

等效于 new(Parent, Id, Label, [])。

new/4

构造函数，创建并显示一个文本控件。

setLabel(This, Label)

更改控件中显示的标签。

wrap(This, Width)

此函数包装控件的标签，使其每行宽度（如果可能）最多为 width 像素（行在单词边界处断开，因此如果单词太长，则可能不是这种情况）。

类型

wxStaticText()

-type wxStaticText() :: wx:wx_object().

函数

create(This, Parent, Id, Label)

-spec create(This, Parent, Id, Label) -> boolean()
                when
                    This :: wxStaticText(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Label :: unicode:chardata().

等效于 create(This, Parent, Id, Label, [])。

create/5

-spec create(This, Parent, Id, Label, [Option]) -> boolean()
                when
                    This :: wxStaticText(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Label :: unicode:chardata(),
                    Option ::
                        {pos, {X :: integer(), Y :: integer()}} |
                        {size, {W :: integer(), H :: integer()}} |
                        {style, integer()}.

创建函数，用于两步构造。

有关详细信息，请参见 new/4。

destroy(This)

-spec destroy(This :: wxStaticText()) -> ok.

销毁对象

getLabel(This)

-spec getLabel(This) -> unicode:charlist() when This :: wxStaticText().

返回控件的标签，如传递给 wxControl:setLabel/2 的那样。

请注意，如果将助记符（“&”字符）传递给 wxControl:setLabel/2 函数，则返回的字符串可能包含助记符；如果不需要，请使用 GetLabelText()（在 wx 中未实现）。

另请注意，返回的字符串始终是传递给 wxControl:setLabel/2 的字符串，但可能与传递给 SetLabelText()（在 wx 中未实现）的字符串不同（因为最后一个会转义助记符字符）。

new()

-spec new() -> wxStaticText().

默认构造函数。

new(Parent, Id, Label)

-spec new(Parent, Id, Label) -> wxStaticText()
             when Parent :: wxWindow:wxWindow(), Id :: integer(), Label :: unicode:chardata().

等效于 new(Parent, Id, Label, [])。

new/4

-spec new(Parent, Id, Label, [Option]) -> wxStaticText()
             when
                 Parent :: wxWindow:wxWindow(),
                 Id :: integer(),
                 Label :: unicode:chardata(),
                 Option ::
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()}.

构造函数，创建并显示一个文本控件。

参见：create/5

setLabel(This, Label)

-spec setLabel(This, Label) -> ok when This :: wxStaticText(), Label :: unicode:chardata().

更改控件中显示的标签。

请注意，由于 wxWidgets 3.1.1，如果标签没有真正更改，则此函数保证不会执行任何操作，因此在应用程序代码中检查新标签是否与当前标签不同没有任何好处。

参见：wxControl:setLabel/2

wrap(This, Width)

-spec wrap(This, Width) -> ok when This :: wxStaticText(), Width :: integer().

此函数包装控件的标签，使其每行宽度（如果可能）最多为 width 像素（行在单词边界处断开，因此如果单词太长，则可能不是这种情况）。

如果 width 为负数，则不进行换行。请注意，此宽度不一定是控件的总宽度，因为可能会添加一些像素作为边框（取决于控件的边框样式）。

自：2.6.2