Rtl_chooseFont

Rtl_chooseFont
Prev	Appendix A. Reference	Next

Runtime Library Options

-creator

The RTL based option creator is used to instantiate the template rtl_chooseFont with a Tk Window. The used creator window must have a -class property.

Acceptable Tk Windows are: toplevel for floating windows, and frame for embedded windows.

Standard Options

-underline, -background, -highlightbackground, -highlightcolor, -borderwidth, -highlightthickness, -selectbackground, -selectborderwidth, -selectforeground, -font, -relief, -height, -width, -activeforeground, -activebackground, -disabledforeground: See the options manual entry for details on the standard options.

Window-specific Options

Command-Line Name: -name, Database Name: name, Database Class; -

The case-insensitive font family name. Tk guarantees to support the font families named Courier (a monospaced ``typewriter'' font), Times (a serifed ``newspaper'' font), and Helvetica (a sans-serif ``European'' font). The most closely matching native font family will automatically be substituted when one of the above font families is used. The name may also be the name of a native, platform-specific font family; in that case it will work as desired on one platform but may not display correctly on other platforms. If the family is unspecified or unrecognized, a platform-specific default font will be chosen.

Command-Line Name: -style, Database Name: style, Database Class; -

Combination of slant and weight.

Command-Line Name: -size, Database Name: size, Database Class; -

The desired size of the font. If the size argument is a positive number, it is interpreted as a size in points. If size is a negative number, its absolute value is interpreted as a size in pixels. If a font cannot be displayed at the specified size, a nearby size will be chosen. If size is unspecified or zero, a platform-dependent default size will be chosen.

Sizes should normally be specified in points so the application will remain the same ruler size on the screen, even when changing screen resolutions or moving scripts across platforms. However, specifying pixels is useful in certain circumstances such as when a piece of text must line up with respect to a fixed-size bitmap. The mapping between points and pixels is set when the application starts, based on properties of the installed monitor, but it can be overridden by calling the tk scaling command.

Command-Line Name: -overstrike, Database Name: overstrike, Database Class; -

The value is a boolean flag that specifies whether a horizontal line should be drawn through the middle of characters in this font. The default value for overstrike is false .

Command-Line Name: -variable, Database Name: variable, Database Class: -

Undocumented

Command-Line Name: -indicatoron, Database Name: indicatoron, Database Class: -

Undocumented

Command-Line Name: -msghighlightbackground, Database Name: msghighlightbackground, Database Class; -

The border color around the preview window.

Command-Line Name: -msghighlightcolor, Database Name: msghighlightcolor, Database Class; -

The border color around the preview window.

Command-Line Name: -msghighlightthickness, Database Name: msghighlightthickness, Database Class; -

The border width around the preview area. See also »-msghighlightbackground«.

Description

The »rtl_choosFont« command creates a »rtl_chooseFont« window.

»rtl_chooseFont« is a font selection dialog. Its design is fashioned after Microsoft® Windows®.

The »rtl_makeFont« dialog inside the Runtime Library uses »rtl_chooseFont«, and extends it with a Tk related font-object creator.

Window Command

A Window created through the rtl_chooseFont command exposes various functions. Using these functions has the following general form:

          pathName option ?arg arg ...?

PathName is the same as the window path name. Option and the args determine the exact behavior of the command. The following commands are possible for this window:

pathName cget option

Returns the current value of the configuration option given by option. Option may have any of the values accepted by the rtl_chooseFont command.

pathName configure ?option? ?value option value ...?

Query or modify the configuration options of the window. If no option is specified, returns a list describing all of the available options for pathName (see Tk_ConfigureInfo for information on the format of this list). If option is specified with no value, then the command returns a list describing the one named option (this list will be identical to the corresponding sublist of the value returned if no option is specified). If one or more option-value pairs are specified, then the command modifies the given window option(s) to have the given value(s); in this case the command returns an empty string. Option may have any of the values accepted by the rtl_chooseFont command.

pathName setItem type lb

pathName init