檢視原始碼 wxFontPickerCtrl (wx v2.4.3)

這個控制項允許使用者選擇字型。

泛型實作是一個按鈕,點擊後會顯示 wxFontDialog。原生實作可能有所不同,但通常是一個(小型)小部件,可讓使用者存取字型選擇對話框。它僅在 wxUSE_FONTPICKERCTRL 設定為 1(預設值)時可用。

樣式

此類別支援以下樣式

  • wxFNTP_DEFAULT_STYLE:預設樣式:wxFNTP_FONTDESC_AS_LABEL | wxFNTP_USEFONT_FOR_LABEL。

  • wxFNTP_USE_TEXTCTRL:在選擇器按鈕的左側建立一個文字控制項,該控制項完全由 wxFontPickerCtrl 管理,使用者可以使用它來指定字型(請參閱 SetSelectedFont)。文字控制項會自動與按鈕的值同步。使用 wxPickerBase 中定義的函數來修改文字控制項。

  • wxFNTP_FONTDESC_AS_LABEL:保持按鈕的標籤更新為字體名稱和字型大小。例如,從字型對話框中選擇「Times New Roman bold,斜體,大小 10」,會將標籤(覆蓋任何先前的標籤)更新為「Times New Roman, 10」文字。

  • wxFNTP_USEFONT_FOR_LABEL:使用目前選取的字型來繪製按鈕的標籤。

參見

此類別繼承自,且可以使用以下類別的函數

wxWidgets 文件:wxFontPickerCtrl

事件

由此類別發出的事件類型

摘要

函數

使用給定的參數建立此小部件。

銷毀物件

傳回使用者選擇的字型所允許的最大點大小值。

傳回目前選取的字型。

初始化物件並使用所有參數呼叫 create/4

設定使用者選擇的字型所允許的最大點大小值。

設定目前選取的字型。

類型

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

函數

連結到此函數

create(This, Parent, Id)

檢視原始碼
-spec create(This, Parent, Id) -> boolean()
                when This :: wxFontPickerCtrl(), Parent :: wxWindow:wxWindow(), Id :: integer().

等同於 create(This, Parent, Id, [])

-spec create(This, Parent, Id, [Option]) -> boolean()
                when
                    This :: wxFontPickerCtrl(),
                    Parent :: wxWindow:wxWindow(),
                    Id :: integer(),
                    Option ::
                        {initial, wxFont:wxFont()} |
                        {pos, {X :: integer(), Y :: integer()}} |
                        {size, {W :: integer(), H :: integer()}} |
                        {style, integer()} |
                        {validator, wx:wx_object()}.

使用給定的參數建立此小部件。

傳回值:如果控制項成功建立,則為 true,如果建立失敗,則為 false。

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

銷毀物件

-spec getMaxPointSize(This) -> integer() when This :: wxFontPickerCtrl().

傳回使用者選擇的字型所允許的最大點大小值。

-spec getSelectedFont(This) -> wxFont:wxFont() when This :: wxFontPickerCtrl().

傳回目前選取的字型。

請注意,此函數與 wxWindow:getFont/1 完全不同。

-spec new() -> wxFontPickerCtrl().
-spec new(Parent, Id) -> wxFontPickerCtrl() when Parent :: wxWindow:wxWindow(), Id :: integer().

等同於 new(Parent, Id, [])

-spec new(Parent, Id, [Option]) -> wxFontPickerCtrl()
             when
                 Parent :: wxWindow:wxWindow(),
                 Id :: integer(),
                 Option ::
                     {initial, wxFont:wxFont()} |
                     {pos, {X :: integer(), Y :: integer()}} |
                     {size, {W :: integer(), H :: integer()}} |
                     {style, integer()} |
                     {validator, wx:wx_object()}.

初始化物件並使用所有參數呼叫 create/4

連結到此函數

setMaxPointSize(This, Max)

檢視原始碼
-spec setMaxPointSize(This, Max) -> ok when This :: wxFontPickerCtrl(), Max :: integer().

設定使用者選擇的字型所允許的最大點大小值。

預設值為 100。請注意,大型字型在建立和呈現時都需要大量的記憶體和 CPU 時間;因此,特別是因為使用者可以選擇透過文字控制項指定字型大小(請參閱 wxFNTP_USE_TEXTCTRL),所以當大型字型沒有太大意義時,最好限制最大字型大小。

連結到此函數

setSelectedFont(This, Font)

檢視原始碼
-spec setSelectedFont(This, Font) -> ok when This :: wxFontPickerCtrl(), Font :: wxFont:wxFont().

設定目前選取的字型。

請注意,此函數與 wxWindow:setFont/2 完全不同。