PtFontSel

A widget for selecting font attributes

Class hierarchy:

PtWidget --> PtBasic --> PtContainer --> PtFontSel

For more information, see the diagram of the widget hierarchy.

PhAB icon:

Public header:

<photon/PtFontSel.h>

Description:

The PtFontSel widget lets you select font attributes.

A PtFontSel widget.

A PtFontSel widget includes noneditable comboboxes that you can use to select the:

• font family
• style (bold and/or italic)
• quality (plain or anti-aliased)

as well as:

• an editable combobox for the font size
• sample text that reflects the current choices.

New resources:

Pt_ARG_FONT_DISPLAY

Flags to filter the inclusion of font families in the selection dialog (see PtFontSelection() in the Photon Library Reference). You can OR these flags together:

• Pt_FONTSEL_SCALABLE -- Include scalable fonts.
• Pt_FONTSEL_BITMAP -- Include bitmap fonts.
• Pt_FONTSEL_FIXED -- Include fixed-width fonts.
• Pt_FONTSEL_PROP -- Include proportional-width fonts.

You can use Pt_FONTSEL_ALL_FONTS to override this filtering.

Pt_ARG_FONT_FLAGS

Flags to modify the appearance of the widget:

• Pt_FONTSEL_SAMPLE -- show a sample text string in the current font.
• Pt_FONTSEL_AA_CHECK -- allow the use of the anti-aliasing (A/A) button only for scalable fonts. For normal bitmap fonts, this button is dimmed. However, external font mapping rules may supplement bitmap fonts with scalable fonts at certain point sizes, allowing this attribute to be applied.
• Pt_FONTSEL_COLORSEL_BKGD -- display a sample of the background color to be used for the text. If you click on the sample, you can change the color.
• Pt_FONTSEL_COLORSEL_TEXT -- display a sample of the color to be used for the text. If you click on the sample, you can change the color.

Pt_ARG_FONT_LBL_FONT

The label beside the combo box for choosing the font.

Pt_ARG_FONT_LBL_QUALITY

The label beside the combo box for choosing the quality of the font.

Pt_ARG_FONT_LBL_QUALITY_ANTIALIASED

The string used in the Quality menu for anti-aliased quality.

Pt_ARG_FONT_LBL_QUALITY_PLAIN

The string used in the Quality menu for plain quality.

Pt_ARG_FONT_LBL_SIZE

The label used beside the font-size field.

Pt_ARG_FONT_LBL_STYLE

The label used beside the Style combo box.

Pt_ARG_FONT_LBL_STYLE_BOLD

The string used in the Style menu for the bold style.

Pt_ARG_FONT_LBL_STYLE_BOLDITALIC

The string used in the Style menu for the bold and italic style.

Pt_ARG_FONT_LBL_STYLE_ITALIC

The string used in the Style menu for the italic style.

Pt_ARG_FONT_LBL_STYLE_PLAIN

The string used in the Style menu for the plain style.

Pt_ARG_FONT_NAME

The name of the initial font. This resource also reflects the currently selected font, style, quality, and size.

Pt_ARG_FONT_SAMPLE

The string to be used as a sample display of the font (if the Pt_FONTSEL_SAMPLE flag is set).

Pt_ARG_FONT_SYMBOL

A character used to filter the inclusion of font families in the selection dialog. Only those fonts that define this character are included.

You can use this resource to display only Latin fonts (set it to 'A') or Cyrillic fonts (set it to Pk_Cyrillic_IO). You can use the value Pt_FONTSEL_ALL_SYMBOLS to override this filtering.

Pt_ARG_FONT_TEXT_COLOR

The color of the text. See PgColor_t in the Photon Library Reference.

Pt_ARG_FONT_TEXT_BKGD_COLOR

The background color of the text. See PgColor_t in the Photon Library Reference.

Pt_CB_FONT_MODIFY

A list of PtCallback_t structures that define the callbacks invoked when the selected font is modified.

If the widget has the Pt_CALLBACKS_ACTIVE bit set in its Pt_ARG_FLAGS resource, these callbacks are also invoked when your application changes the selected font by calling PtSetResource() or PtSetResources().

Each callback is passed a PtCallbackInfo_t structure that contains at least the following members:

reason

Pt_CB_FONT_MODIFY

event

A pointer to a PhEvent_t structure that describes the event that caused the callback to be invoked.

cbdata

A pointer to the name of the new font selection.

These callbacks should return Pt_CONTINUE.

Inherited resources:

If the widget modifies an inherited resource, the "Default override" column indicates the new value. This modification affects any subclasses of the widget.

Pt_ARG_DIM

The dimension of the PtFontSel widget is fixed at 216 wide * 136 high (when the Pt_FONTSEL_SAMPLE bit of the Pt_ARG_FONT_FLAGS resource is set), or 216 wide * 58 high (when the Pt_FONTSEL_SAMPLE bit is clear).

Convenience functions:

The PtFontSel class defines the following convenience function:

PtFontSelection()

Display a modal dialog for selecting a font. See the Photon Library Reference.