檢視原始碼 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