Volume 7B: XView Reference Manual

PANEL_NOTIFY_STATUS

This attribute is overloaded by the Path Name package to represent whether or not the PANEL_

NOTIFY_PROC succeeded in validating the the last directory it was called with. The return value

from the notify procedure is of type Panel_setting and does not exactly match the same condi-

tion. Expected values are XV_OK or XV_ERROR in the case of an invalid path name. For a

PATH_ITEM, see the preceding PANEL_NOTIFY_STATUS explanation.

Argument: int

Default:

XV_OK

Procs: create, get, set

PANEL_NOTIFY_STRING

String of characters that triggers notification when one of the characters is typed in a text item. Ap-

plies only when PANEL_NOTIFY_LEVEL is PANEL_SPECIFIED. The string is copied when this attri-

bute is set.

Argument: char *

Default: \n \r \t (i.e., newline, carriage return, and tab)

Procs: create, get, set

Objects: Panel_numeric_text_item, Panel_text_item,

Panel_multiline_text_item

See Also: 7.15.3

PANEL_OPS_VECTOR

The panel operations vector, which is the method by which the panel package dispatches events to

panel items. For more information, see Section 25.11, “The Wizzy Package” in the XView Program-

ming Manual.

Argument: Panel_ops *

Procs: get,set

Objects: Panel_item

PANEL_PAINT

Controls the panel item’s painting behavior in xv_set calls. The specified value applies only to the

xv_set call. As the xv_set call exits, it restores

PANEL_PAINT to its previous value. Possible val-

ues are

PANEL_CLEAR, PANEL_NO_CLEAR, or PANEL_NONE. PANEL_PAINT operates on Panel and

Panel_item objects. The default for Panel item objects is the value of PANEL_PAINT for the Panel to

which the Panel item is attached. This attribute is used strictly for performance enhancements and,

normally, is not required.

Argument: Panel_setting

Default:

PANEL_CLEAR for panel objects, the panel’s PANEL_PAINT for panel item objects

Procs: create, set

Objects: Panel,Panel_item

See Also: 7.19.3

PANEL_PRIMARY_FOCUS_ITEM

The current or last panel item that is or was a primary (First-Class) focus client.

Warning: This attribute should only be used from within a panel item extension.

Argument: Panel_item

Procs: get,set

Objects: Panel

Usage:

if (xv_get(panel_public, PANEL_PRIMARY_FOCUS_ITEM) == item_public)

xv_set(panel_public, PANEL_PRIMARY_FOCUS_ITEM, NULL, NULL);

XView Attributes

XView Attributes 121

This example should be executed when an item’s remove procedure is called, if the item

is a primary focus client.

PANEL_READ_ONLY

If TRUE, editing is disabled; if FALSE, editing is enabled. Note that xv_set does not apply to scrol-

ling lists. PANEL_READ_ONLY mode defaults to TRUE for the FILE_LIST package as opposed to

FALSE for the PANEL_LIST package.

Argument: Bool

Default:

FALSE

TRUE

for a FILE_LIST.

Procs: create, get, set

Objects: Panel_list_item, Panel_multiline_text_item, Panel_numer-

ic_text_item, Panel_text_item, Panel_slider_item, File_list

PANEL_REPAINT_PROC

Specifies the name of the client-supplied panel background repaint procedure.

Argument: void (*panel_repaint_proc) ()

Default:

NULL

Procs: create, get, set

Objects: Panel

Callback:

void

panel_repaint_proc(panel, pw, repaint_area)

Panel panel;

Xv_Window pw; /* paint window */

Rectlist *repaint_area;

See Also: 7.19.2

PANEL_SHOW_RANGE

If

TRUE, shows the minimum and maximum slider or gauge values.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Panel_slider_item, Panel_gauge_item

See Also: 7.13

PANEL_SHOW_VALUE

If TRUE

, shows current slider value.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Panel_slider_item

See Also: 7.13

PANEL_SLIDER_END_BOXES

Shows or hides the slider end boxes.

Argument: Bool

Default:

FALSE

Procs: create,get,set

Objects: Panel_slider_item

See Also: 7.13

122 XView Reference Manual

PANEL_SLIDER_WIDTH

Specifies the length of the slider bar in pixels. The length is set whether the slider is horizontally or

vertically oriented.

Argument: int

Default: 100

Procs: create, get, set

Objects: Panel_slider_item

See Also: 7.13

PANEL_STATUS

Returns the state of the panel. See <xview/panel.h> for more information.

Warning: This attribute should only be used from within a panel item extension.

Argument: Panel_status *

Procs: get

Objects: Panel

PANEL_TEXT_SELECT_LINE

Selects and highlights the entire contents of the text field.

Argument: No value

Procs: set

Objects: Panel_text_item

Usage:

xv_set(ptext, PANEL_TEXT_SELECT_LINE, NULL);

See Also: 7.15.2

PANEL_TICKS

Specifies the number of evenly-spaced tick marks to be displayed on slider or gauge panel items.

Argument: int

Default: 0

Procs: create, get, set

Objects: Panel_slider_item, Panel_gauge_item

See Also: 7.13

PANEL_TOGGLE_VALUE

Specifies the value (argument 2) of a particular toggle choice (argument 1).

Argument 1: int

Argument 2: int

Default:

NULL

Procs: create, get, set

Objects: Panel_choice_item

PANEL_VALUE

Indicates the current value of a panel item. Its type varies depending on the type of panel item speci-

fied. See Chapter 7, Panels, in the Xview Programming Manual for details.

Argument: Varies with panel item type

Procs: create, get, set

Objects: Panel_item

See Also: 7.6

XView Attributes

XView Attributes 123

PANEL_VALUE_DISPLAY_LENGTH

Maximum number of characters to display in a text string. Note that the length of the value display

may not be less than the combined width of the left and right “more text” buttons. In 12-point font,

this is four characters. This attribute is intended for use with fixed-width fonts. For variable-width

fonts, use the attribute PANEL_VALUE_DISPLAY_WIDTH. For a Multiline Text Item, this specified the

length of each row (line) in the Multiline Text Field, expressed in characters.

Argument: int

Default: 80 (for Slider, Text, and Numeric Text Items)

40 (for a Multiline Text Item)

Procs: create,get,set

Objects: Panel_slider_item , Panel_numeric_text_item, Panel_text_item,

Panel_multiline_text_item

See Also: 7.17, 7.15

PANEL_VALUE_DISPLAY_WIDTH

The width, in pixels, of a text field’s value. For a Multiline Text Item, this is the width of each row

(line) in the Multiline Text Field.

Argument: int

Default: 80 default character widths (for Text and Numeric Text Items).

Width corresponding to value of

PANEL_VALUE_DISPLAY_LENGTH (for a Multiline Text

Item)

Procs: create,get,set

Objects: Panel_text_item, Panel_numeric_text_item,

Panel_multiline_text_item

See Also: 7.17, 7.15

PANEL_VALUE_FONT

Specifies the font to use in the value portion of the Panel Item.

Warning: Use of this attribute may cause your application to violate the OPENLOOK Graphical User

Interface Functional Specification.

Argument: Xv_Font

Default: Panel’s font

Procs: create,get,set

Objects: Panel_numeric_text_item, Panel_slider_item, Panel_text_item

PANEL_VALUE_STORED_LENGTH

Maximum number of characters allowed in string value for a text item. For Multiline Text Items, if

PANEL_VALUE_STORED_LENGTH

is greater than PANEL_VALUE_DISPLAY_LENGTH times

PANEL_DISPLAY_ROWS

, then a scrollbar will be visible on the Multiline Text Field. (An outstanding

bug in

TEXTSW_MEMORY_MAXIMUM

prevents PANEL_VALUE_STORED_LENGTH from being set to less

than 1024; thus a Multiline Text Item will always have a scrollbar.)

Argument: int

Default: Same as

TEXTSW_MEMORY_MAXIMUM default (for Multiline Text Item)

80 (for a Text or Numeric Text Item )

Procs: create,get,set

Objects: Panel_numeric_text_item, Panel_text_item,

Panel_multiline_text_item, Panel_list_item, Panel

See Also: 7.17, 7.15

124 XView Reference Manual

PANEL_VALUE_UNDERLINED

Show or hide the text field value’s underlining.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Panel_text_item, Panel_numeric_text_item

PANEL_VALUE_X

Specifies the x coordinate of the value portion of panel items that have separate label and value enti-

ties (e.g., text items).

Argument: int

Default: (See Chapter 7, Panels, in the XView Programming Manual.)

Procs: create, get, set

Objects: Panel_item

See Also: 7.4.3,

PANEL_LABEL_X

PANEL_VALUE_Y

Specifies the y coordinate of the value portion of panel items that have separate label and value enti-

ties (e.g., Text Items).

Argument: int

Default: (See Chapter 7, Panels, in the XView Programming Manual.)

Procs: create, get, set

Objects: Panel_item

See Also: 7.4.3,

PANEL_LABEL_Y

PATH_IS_DIRECTORY

Specifies if the PATH_NAME package should accept a path name as a directory or a full path to a file

name. Changing this value from

FALSE to TRUE has the side effect of setting the PATH_LAST_

VALIDATED value to NULL if it is not a directory.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Path_name

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

PATH_LAST_VALIDATED

PANEL_VALUE

returns the current contents of the Textfield, PATH_LAST_VALIDATED returns the last

path name to pass validation in the Textfield. This means that you are always guaranteed of receiving

a valid path name with this attribute. Note that this is always the expanded version of the path name,

whereas

PANEL_VALUE

will return the current contents of the field.

Warning: if no path name has passed validation, this will return a

NULL. Also, setting PATH_IS_

DIRECTORY will cause this value to become NULL.

Argument: char *

Default:

NULL

Procs: get

Objects: Path_name

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

XView Attributes

XView Attributes 125