Volume 7B: XView Reference Manual

FILE_LIST_SHOW_DIR

Tells the FILE_LIST package to display its current directory path in the Title item of the list (uses the

PANEL_LIST_TITLE attribute).

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: File_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

FILE_LIST_SHOW_DOT_FILES

Specifies whether or not the FILE_LIST package should consider files beginning with the “.” prefix.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: File_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

FILE_LIST_UPDATE

Tells the FILE_LIST to re-read its current directory and update its display.

Argument: None

Procs: set

Objects: File_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

FILE_LIST_USE_FRAME

Tells the FILE_LIST package to display any error messages in the footer of the current Frame. If the

current Frame has no footer, or the attribute is

FALSE, the FILE_LIST package will use xv_er-

ror().

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: File_list

See Also: Appendix D, Version 3.2 and the File Chooser, of XView Programming Manual.

FONT_CHAR_HEIGHT

Returns the height (an int) of a specified character (a char) of the font. This is actually the height

of the bounding rectangle, good for any character of the font.

Return Type: int

Argument: char

Procs: get

Objects: Xv_Font

Usage:

Xv_font font;

int height;

height = (int)xv_get(font, FONT_CHAR_HEIGHT, ’m’);

See Also: 16.2

56 XView Reference Manual

FONT_CHAR_WIDTH

Returns the width (int) of a specified character (char) of the font.

Return Type: int

Argument: char

Procs: get

Objects: Xv_Font

See Also: 16.2

FONT_DEFAULT_CHAR_HEIGHT

Returns the default character height of the font. Does not take a value.

Return Type: int

Procs: get

Objects: Xv_Font

Usage:

Xv_font font;

int height;

height = (int)xv_get(font, FONT_DEFAULT_CHAR_HEIGHT);

See Also: 16.2

FONT_DEFAULT_CHAR_WIDTH

Returns the default character width of the font. Does not take a value.

Return Type: int

Procs: get

Objects: Xv_Font

See Also: 16.2

FONT_FAMILY

Specifies the name of a font family.

Argument: char *

Default: None

Procs: create, find, get

Objects: Xv_Font

See Also: 16.1.1

FONT_INFO

Returns a pointer to the X structure XFontStruct containing X-related information for the font.

Return Type: XFontStruct *

Default: N/A

Procs: get

Objects: Xv_Font

Usage:

#include <X11/Xlib.h>

Xv_font font;

XFontStruct *font_info;

font_info = (XFontStruct *)xv_get(font, FONT_INFO);

See Also: 16.2

XView Attributes

XView Attributes 57

FONT_NAME

Specifies the name of the font desired. This takes precedence over all other Font attributes. The list

of valid names that can be used can be displayed using the xlsfonts command.

Argument: char *

Procs: create,find

Objects: Xv_Font

Usage:

Xv_font font;

font = xv_create (frame, FONT,

FONT_NAME,

"-adobe-courier-bold-r-normal--14-140-75-75-m-90-iso8859-1"

NULL) ;

height = (int)xv_get(font, FONT_DEFAULT_CHAR_HEIGHT);

See Also: 16.1.4

FONT_PIXFONT

This attribute is for SunView compatibility. For more information, refer to the manual Converting

SunView Applications. Returns the pixfont representation of the font.

FONT_RESCALE_OF

Given an existing font and a rescale factor, the returned font will be a similar font in the specified

scale.

Argument1: Xv_Font

Argument2: Window_rescale_state (see <xview/window.h>)

Procs: create, find

Objects: Xv_Font

Usage:

Xv_font font1, font2;

/*

* Find a font similar to font1 but in the large

* scale

*/

font2 = (Xv_FONT) xv_find (frame, FONT,

FONT_RESCALE_OF, font1, WIN_SCALE_LARGE,

NULL) ;

See Also: 16.1.3,

FONT_SIZES_FOR_SCALE, FONT_SCALE

FONT_SCALE

Specifies the scale desired for a font. The scale settings map to certain pixel sizes (defaults are 10, 12,

14, and 19). If FONT_SIZE is used, it will take precedence over FONT_SCALE.

Argument: Window_rescale_state (see <xview/window.h> )

Default:

WIN_SCALE_MEDIUM

Procs: create, find, get

Objects: Xv_Font

See Also: 16.1.3,

FONT_RESCALE_OF, FONT_SIZES_FOR_SCALE

58 XView Reference Manual

FONT_SIZE

Specifies the size of a font in pixels. Note that the valid values for size depend on what font sizes are

available on the X server.

Argument: int

Default: 12

Procs: create, find, get

Objects: Xv_Font

Usage:

Xv_font font;

/*

* This creates a lucida font with normal style

* with its size = 14

*/

font = (Xv_FONT) xv_find (frame, FONT

FONT_FAMILY_LUCIDA,

FONT_STYLE, FONT_STYLE_NORMAL

FONT_SIZE, 14,

NULL) ;

See Also: 16.1.2

FONT_SIZES_FOR_SCALE

Specifies a set of four integral sizes (measured in points) to which a font can be scaled.

Argument 1: int, for fonts scaled in small size

Argument 2: int, for fonts scaled in medium size

Argument 3: int, for fonts scaled in large size

Argument 4: int, for fonts scaled in extra_large size

Default: 10, 12, 14, 19

Procs: create, find

Objects: Xv_Font

Usage:

Xv_font font;

/*

* This creates a lucida font with normal style

* with its size = 19

*/

font = (Xv_FONT) xv_find (frame, FONT,

FONT_FAMILY_LUCIDA,

FONT_STYLE, FONT_STYLE_NORMAL,

FONT_SIZES_FOR_SCALE, 12, 14, 19, 26,

FONT_SCALE, WIN_SCALE_LARGE,

NULL) ;

See Also: 16.1.3,

FONT_RESCALE_OF, FONT_SCALE

XView Attributes

XView Attributes 59

FONT_STRING_DIMS

Given a string and the address of a Font_string_dims structure (see <xview/font.h>), xv_get()

fills it in with the width and height dimensions of the string. The pointer to the structure is returned by

xv_get.

Return Type: Font_string_dims *

Argument1: char *

Argument2: Font_string_dims *

Procs: get

Objects: Xv_Font

Usage:

Xv_font font;

Font_string_dims dims;

(void)xv_get (font, FONT_STRING_DIMS, "Hello World", dims);

/*

* At this point ’dims’ will contain the width and height

* (in pixels) of the entire string "Hello World" as

* rendered in the font ’font’.

*/

See Also: 16.2

FONT_STYLE

Specifies a font style.

Argument: char *

Default:

FONT_STYLE_NORMAL

Procs: create, find, get

Objects: Xv_Font

See Also: 16.1.1

FRAME_ACCELERATOR

Specifies a window-level accelerator. The character in the first argument is used to call the procedure

in the second argument with the data in the third argument. On xv_get, the frame package searches

through the linked list of accelerators, and returns a pointer to the Frame_accelerator structure

whose code or keysym matches the specified code and keysym. Applications do not normally use

xv_get with this attribute. Note: Certain key combinations are reserved for semantic actions within

XView and should not be used for accelerators. These key combinations are listed in Appendix C,

Mouseless Model Keyboard Mappings, of the XView Programming Manual.

On create,set:

Argument 1: char

Argument 2: void (*)()

Argument 3: Xv_opaque

On get:

Argument 1: char

Argument 2: KeySym

Procs: create,get,set

Objects: Frame

60 XView Reference Manual