Builder Xcessory Resources

actionCounts

Specifies the number of Button/Key actions to count between automatic saves of the interface. Setting this value to 0 disables the autosave feature. (Autosave Interval text field located on the General tab of the Browser User Preferences menu.)

alphabeticOrder

Specifies whether resources in the Resource Editor will be listed in alphabetical order. If True, the resources are displayed in alphabetical order sorted by their resource names. If False, the resources are displayed in the widget internal order. (Alphabetical Order toggle on the Options menu of the Resource Editor.)

alwaysGeneratePixmaps

Specifies whether pixmaps will always be output, even if none are referenced in the generated application. If True, all pixmaps are output always, whether referenced or not. If False, all pixmaps are generated only if at least one of them is referenced in the generated application. (Always Generate Pixmaps on the Save File tab of the Browser User Preferences menu.)

autoCheckOut

Specifies Builder Xcessory's response when you attempt to Open or Read a UIL file which has read-only file permissions, If True, you are prompted to check the file out from the version control system before reading it into Builder Xcessory. If False, Builder Xcessory reads the file and marks it as read-only.

autoDismissStartup

Automatically dismisses the Startup Panel when you start Builder Xcessory. Set on the User Preferences Behavior tab from the Browser Options menu.

autoMenuPopup

Specifies whether or not the associated menu will pop up when you select a Cascade Button, Option Menu, or Popup Menu. If True, the menu pops up automatically, as if the Show Menu command had been executed. If False, the menu does not pop up.

browserState

Specifies the geometry and iconification state of the Browser to use the next time Builder Xcessory runs. The string has the following format:

<width>x<height>+<x>+<y>:[normal|iconic]

brwsrToolbar

Specifies a list of items to place on the Browser tool bar. The list is comma separated and also specifies the order of placement. Unrecognized items are silently ignored. The last occurrence of a duplicate entry is used. Valid values include the following:

alignbtm

class

gilpref

open

saveclass

aligned

classhier

helpindex

palette

saveclassas

alignhctr

clearmsgs

i18npref

paste

selparent

alignlft

compchild

iconify

play

settings

alignrgt

constmgr

identmgr

print

showlists

aligntop

copy

importgil

printset

showtree

alignvctr

cut

keepparent

procmgr

snapgrid

appmgr

debug

lockclass

raise

stylemgr

apppref

deiconify

lower

read

subclass

brwssearch

delete

mainbrowser

readclass

toolpref

btoolbar

editfile

makeapp

receptor

topal

build

enlarge

menus

revert

typemgr

checkin

exit

messsages

rsceditor

unclass

checkout

filemgr

natural

save

unlockclass

chooselang

gencode

new

saveas

userpref

buttonOneShellString

Specifies the shell type to use when a widget is placed outside any parent using MB1. Valid options are ApplicationShell, TopLevelShell, TransientShell, and XmDialogShell.

buttonThreeShellString

Specifies the shell type to use when a widget is placed using MB3. Valid options are ApplicationShell, TopLevelShell, TransientShell, and XmDialogShell.

centerDialogs

Specifies whether the Builder Xcessory message dialogs should popup under the cursor or in the center of the screen.

clearcaseCCOCommand

The command to issue when the user requests a Cancel Check Out and configured the Source Code Control to ClearCase.

clearcaseCICommand

ClearCase Check In command.

clearcaseCOUCommand

ClearCase Check Out Unlocked command.

clearcaseCommand

ClearCase Check Out Locked command.

clearcaseHDRInfo

String to insert into all UIL files for ClearCase logging identification. Default is " ".

confirmWidgetDeletes

If True (default), displays a dialog requesting confirmation for a delete operation on the interface. If False, confirmation is not required to delete an object.

debug

Specifies whether the Builder Xcessory outputs additional debugging information.

debugger

Specifies the debugger and application build tool to use when you select Debug Mode or Build Application in the Browser.

The following are the possible values:

Environment-- user's development environment debugger

CenterLine-- CenterLine debugging environment (CodeCenter/ObjectCenter)

defaultBxType

Specifies the default type when you create an identifier in the Identifier Manager.

defaultGilArgs

When importing a GIL file, specifies the arguments passed to the GIL translator.

defaultGilTranslator

When importing a GIL file, specifies the GIL code translator.

defaultLanguage

Specifies the language selected in the Language dialog of the Browser Options menu

defaultPlacement

Specifies the list of resource data types that default to App placement. A comma-separated list of resource data type names (all lowercase) is supplied to the data.

delayShellRealize

If False, all shells of an interface are displayed when it is loaded; the hierarchy of every shell is displayed in the Browser. If True, the shells and their hierarchies are not displayed. Instead, the shell names are listed on the Browser, and you must click on each shell name to display it. This is most useful when you are working with a complex interface and need to conserve screen real estate. When true, the interface will also load faster.

demo

When the Builder Xcessory starts, it searches for the license data file. If it cannot find the license data file, it will not allow the user to save any work. This option allows Builder Xcessory to forego the search and run in demo mode. In demo mode, UIL code generation, autosave, and the Save/Save As features are disabled.

directoryPath

Specifies the directory where files will be written. This is initially the directory from where Builder Xcessory is started, but will change as UIL files are opened. It can also be changed explicitly.

editor

Specifies which editor to use: Vi, Emacs, or User Environment.

emacsCommand

The command to use when the editor is Emacs.

file

Specifies the file to load immediately after initialization. This is most useful when used with its command line variant.

firstNodeStateClosed

Specifies whether the Browser tree will start any hierarchy with the node closed. This is a useful setting when reading large hierarchies as it helps improve the Builder Xcessory startup time.

force

This resource is used only in conjunction with the load resource. Specifies that Builder Xcessory should generate Palette entries for any and all user defined widgets, even if they already appear in a WML file.

generateUnmodifiedDefaults

When Builder Xcessory is asked to place a resource value in the application defaults file, on rare occasions, it is unable to supply a valid string for the output value. If this resource is set to False, Builder Xcessory will skip over the resource specification. If it is set to True, Builder Xcessory will print a resource specification to the app-defaults file without a value string following the colon.

gilLookFeel

Sets Builder Xcessory to import GIL interface objects as having a Motif or OPENLOOK look and feel.

gilReposition

Specifies whether Builder Xcessory lays out the interface based on size changes encountered in Motif version of OPENLOOK objects.

gridUnit

Specifies the size, in pixels, of the grid to be used when snapToGrid is True.

hierarchyAutopanTimeout

Specifies the time in milliseconds before the Panner will automatically pan during a drag and drop operation on an object instance hierarchy in the Browser.

identifierLegalChars

The set of non-alphanumeric characters to accept as valid in identifier names. Default "_$.()[]&-><:"

installErrorHandlers

Specifies whether Builder Xcessory should install its catastrophic error handlers which try to save the interface in progress when a catastrophic error occurs. This is only useful if a core file is the desired end product. Specifying False for this resource will turn off the error handlers and produce a core file on a catastrophic error. If False, the interface will not be saved on catastrophic error.

integratePurify

Specifies whether memory test targets should be added to the various makefiles and imakefiles.

integrateXrunner

Specifies whether Xrunner targets should be added to the Makefile.

lieToWindowManager

Specifies whether Builder Xcessory uses USPosition to set x and y values. This is technically incorrect, but is necessary for most window managers to place the windows correctly.

load

Specifies whether Builder Xcessory should try to create a WML file and Palette entries for any user defined widgets.

loadDEC

Specifies whether or not to load the DEC widgets (if they are available) onto the Palette during Builder Xcessory startup.

loadICS

Specifies whether or not to load the EnhancementPak widgets onto the Palette during startup.


Note: The EnhancementPak widget set is a separate product. Please consult your ICS sales representative for further information.


localDirectory

Specifies the directory that Builder Xcessory uses for individual additions to the Palette, such as user collections. This directory must be writable.

matchPaletteColors

If True, Palette and toolbar pixmaps use the symbolic background and foreground colors. If False, the Palette and toolbar pixmaps are displayed with individual background colors.

memoryTool

Specifies which memory tool options to add to the application makefile: PURIFY, SENTINEL, or USER.

minimumWidgetHeight

Specifies the minimum height a widget can have when created.

minimumWidgetWidth

Specifies the minimum width a widget can have when created.

motifVersion

Specifies the version of the Motif toolkit for which Builder Xcessory will generate code. The Builder Xcessory will read in code written in any version of UIL.

newMrmStyle

Specifies how MRMRegisterArg is output and initialized in code when outputting UIL code. If True, MRMRegisterArg is output as an uninitialized array and is initialized in code. If False, MRMRegisterArg is output and initialized as a static array.

objectcenterCommandLine

Specifies the command line to start ObjectCenter.

paletteState

Specifies the geometry, iconification, view mode and catalog file of each Palette to display when Builder Xcessory is next executed. The string has the following format:

<width>x<height>+<x>+<y>:[normal|iconic]:<catalog>:[outline|tab]:[IconOnly|IconNone|IconTop],...

pixmapBackground

Specifies the color to use in the Palette and toolbar pixmaps for the symbolic background color.

pixmapForeground

Specifies the color to use in the Palette and toolbar pixmaps for the symbolic foreground color.

pixmapMode

Specifies which set of pixmaps, if any, are used on the Palette. May be either BEST_FIT, FORCE_BW, or FORCE_COLOR. When pixmapMode is set to BEST_FIT, Builder Xcessory uses either the black and white pixmaps or the color pixmaps depending on the display. When pixmapMode is set to FORCE_BW, Builder Xcessory uses the black and white pixmaps. When pixmapMode is set to FORCE_COLOR, Builder Xcessory uses the color pixmaps.

printAppendText

When an object instance hierarchy is printed to the screen, this resource determines how the text will be displayed in the output window. When True, the text from the hierarchy will be appended to the output window. If False, the text will replace the current text in the output window.

printClassNames

When an object instance hierarchy is printed. this resource determines whether or not the class names of widgets will be printed. When True, the class names will be printed. If False, they will not.

printCommand

This resource determines what command is used to print an object instance hierarchy to your printer. By default, the print command is lp.

printExpandUserClasses

When an object instance hierarchy is printed to the screen. this resource determines how much information about class instances is printed. If True, information about all of the widgets that make up any user-defined class is printed. If False, only information about the class instance is printed

printIndentAmount

When an object instance hierarchy is printed to the screen. this resource determines how many spaces to indent for each child level. The default value is 4.

printInstanceNames

When an object instance hierarchy is printed. this resource determines whether or not the instance names of the objects in the hierarchy should be printed. When True, the instance names are printed. If False, they are not.

printSelected

When an object instance hierarchy is printed. this resource determines how many of the objects in the Browser window are printed. When True, only the selected object(s) and their descendents are printed. If False, all objects that are currently displayed on the Browser are printed.

printToPrinter

When an object instance hierarchy is printed, determines the result of selecting Print Hierarchy from the File menu on the Browser. If True, the hierarchy is printed by your printer. If False, it is not.

printToWidget

Determines the result of selecting Print Hierarchy from the File menu on the Browser. If True, the object instance hierarchy is printed to an output window. If False, it is not.

printXtHierarchy

When an object instance hierarchy is printed. this resource determines the format in which the hierarchy is printed. When False, the hierarchy is printed as interpreted by Builder Xcessory. If True, the hierarchy is printed as it is implemented in Xt.

procLegalChars

The set of non-alphanumeric characters to accept as valid in procedure names. Default: "_$<>:"

purifyCommand

Specifies the command used to make a memory test target in the application makefile.

raiseRscShellOnDoubleClick

Specifies whether the Resource Editor should be raised to the top of the stacking order whenever a widget is updated.

rcsCCOCommand

Specifies the command line for the RCS Cancel Check Out command.

rcsCICommand

Specifies the command line for the RCS Check In command.

rcsCommand

Specifies the command line for the RCS Check Out Locked command.

rcsCOUCommand

Specifies command line for RCS Check Out Unlocked command.

rcsHDRInfo

String to insert into all UIL files for RCS source code control login identification. Default is "$ID$"

removeNewline

Specifies whether the Resource Editor will remove the last newline at the end of a string, typically typed in accidentally.

resourceEditorAutoUpdate

Specifies whether the Resource Editor will be in Automatic Update mode or not. If True, the Resource Editor will update its display automatically each time a widget instance is selected. If False, the editor will only be updated on request. The default value is False.

resourceEditorView

Specifies the Resource Editor view. This setting determines which group of resources is displayed--all resources are displayed by default. Other settings include simple, programmer, modified, and not equal (for use with multiply-selected instances). You usually select these from the Resource Editor Resources menu.

reToolbar

This resource is a list of the items to place on the Resource Editor tool bar. The list is comma separated and also specifies the order of placement. Unrecognized items are silently ignored. The last occurrence of a duplicate entry is used. Valid values include the following:

allform

dfltplace

modform

search

update

alphabetic

gad

neqform

simpleform

wid

autoupdate

gen_class

progform

storage

classfile

header

ref_class

typed

creation

manage

retoolbar

unmanage

rscEditorState

Specifies the geometry and iconification state of the Resource Editor the next time Builder Xcessory executes. The string has the following format:

<width>x<height>+<x>+<y>:[normal|iconic]

saberCMessage

Specifies the message Builder Xcessory sends to CodeCenter when CenterLine Mode is invoked.

saberCPlusMessage

Specifies the message Builder Xcessory sends to ObjectCenter when Centerline Mode is invoked.

saberCommandLine

Specifies the command line Builder Xcessory uses to invoke CodeCenter.

saberExec

Specifies whether Builder Xcessory should execute CodeCenter when CenterLine mode is invoked.

saberResetMessage

Specifies the message Builder Xcessory sends to CodeCenter to reset CenterLine Mode.

saberUILMessage

Specifies the message Builder Xcessory sends to ObjectCenter when Centerline Mode is invoked.

saveState

Specifies whether Builder Xcessory should save Browser, Resource Editor, and Palette states on exit. Valid values are SaveState or UseDefault.

sccCCOCommand

Specifies the command line for the User Specified Cancel Check Out command.

sccCICommand

Specifies the command line for the User Specified Check In command.

sccCommand

Specifies the command line for the User Specified Check Out Locked command.

sccCOUCommand

Specifies the command line for the User Specified Check Out Unlocked command.

sccHDRInfo

String to insert into all UIL files for user-defined source code control logging identification. Default is " ".

sccsCCOCommand

Specifies the command line for the SCCS Cancel Check Out command.

sccsCICommand

Specifies the command line for the SCCS Check In command.

sccsCommand

Specifies the command line for the SCCS Check Out Locked command.

sccsCOUCommand

Specifies the command line for the SCCS Check Out Unlocked command.

sccsHDRInfo

String to insert into all UIL files for RCS logging identification. Default: "%W % %D% %T%"

sentinelCommand

Memory test command to use when the memory tool is set to SENTINEL.

setPortholeLocation

When True, this resource will cause Builder Xcessory to center the Browser tree to center automatically about the selected object node. When False, the tree will not be moved when an object is selected.

showBrowserToolbar

If True, specifies that the Browser Toolbar should be displayed at start up time. If False, the Browser Toolbar will be hidden initially.

showCompositeChildren

When True, the compound children of any compound widgets are displayed in the Browser tree hierarchy. If False, compound children will not be displayed.

showInstanceData

If True, specifies that the Resource Editor Instance Data Field header should be shown at start up. If False, the Resource Editor Instance Data Field Header is hidden initially.

showMessages

When True, this resource will cause Builder Xcessory to start with the message window in the Browser displayed rather than hidden.

showRscEdSearch

If True, specifies that the Resource Editor Search Field should be shown at start up. If False, the Resource Editor Search Field is hidden initially.

showRscEdToolbar

If True, specifies that the Resource Editor Instance Data Field header should be shown at start up. If False, the Resource Editor Instance Data Field Header is initially hidden.

showWidgetSearch

If True, specifies that the Browser Widget Search/Select Field be shown at start up. If False, the Browser Widget Search/Select Field is initially hidden.

snapToGrid

Specifies whether widgets are placed in accordance with the grid. See also gridUnit.

sourceCodeControl

Specifies which Source Code Control (or version control) system to use for Check In and Check Out requests.

Possible values include the following:

ENV

Use the user's development environment source code control tool.

RCS

Use RCS source code control commands.

SCCS

Use SCCS source code control commands.

USER

Use User-specified source code control commands.

strictDialogs

Specifies whether Builder Xcessory should allow only widgets that are subclasses of XmBulletinBoard to be the child of an XmDialogShell.

symbolicUIL

Specifies whether Builder Xcessory should use symbolic names when generating UIL code. If True, and motifVersion is 1.0, the output UIL file will include the file XmAppl.uil. If False, this file will not be included and Builder Xcessory will generate the actual constant values instead of the symbolic names.

system

When load is True, specifies that the WML file and Palette entries should be put in the system directory instead of the local directory. Typically, root privileges are necessary for this option.

systemDirectory

Specifies the directory that Builder Xcessory searches for its system initialization files.

toolEnvironment

Specifies that the Builder Xcessory integration with a development environment should be used. Valid values include:

None

do not communicate with an IDE.

SUNTT

communicate with SunSoft WorkShop (version 2 or 3)

SGITT

communicate with SGI Developer Magic


Note: Communication with the DEC FUSE environment will only work when Builder Xcessory is started from the DEC FUSE Control Panel.


toolbarButtonMode

Specifies how the buttons in both the Browser and Resource Editor Toolbars should be displayed.

Possible values include the following:

· XiIconLeft--Display both labels and icons

· XiIconNone--Display labels only

· XiIconOnly--Display icons only

typeLegalChars

The set of non-alphanumeric characters to accept as valid in type names. Default values are "_ $ < > &"

typeOrder

Specifies whether resources in the Resource Editor will be listed in order of their type. If True, the resources are ordered according to their resource type. If alphabeticOrder is also True, then the resources are ordered alphabetically within each resource of the same type.

uilIncludePath

Specifies the directory or directories that Builder Xcessory searches for files included by the uil include directive. Additional include directories may be specified by separating with a comma.

uilPixmapBehavior

This resource affects the generation of icon values in UIL code. If True, the icon's color table will be generated in a separate value statement immediately preceding the icon value to which it applies. If False, the icon's color table will be generated as a part of the icon value. This is a legal UIL value specification, but most UIL compilers flag this syntax as an error or do not compile it correctly.

uniqueSubclassNames

If True, prepends the subclass name and an underscore (_) to all subclass widget names in order to make them unique from their corresponding superclass widgets. If False, allows subclass widgets to have the same names as their corresponding superclass widgets--you must then rename the subclass widgets yourself.

useOpenGL


Note: Valid on SGI Platforms only.


If True, load the OpenGL Drawing Area widget on the Palette. If False (default), load the IRIS GL Drawing Area widget on the Palette.

userDefinedUIL

Useful for users generating UIL code and unable to extend the UIL compiler to understand new widgets. Set to True only when generating the UIL file that will be compiled because the resulting UIL file becomes much larger and more confusing.

If True, writes UIL files with all non-motif widgets fully specified as user-defined UIL objects.

If False (default), writes UIL files treating all widgets as if defined to the UIL compiler.

userEditorCommand

Specifies the command to use for a user-defined editor.

userMemCommand

Specifies the command to use for a user-specified memory test tool.

viCommand

Specifies the format of the command to use for the vi editor.

viewSingleClass

If True, shows only one class at a time in the Browser and Class Hierarchy, when in Classes view. If False, show any number of classes at the same time in the Browser and Class Hierarchy.

uilWrapLines

Specifies whether or not long strings should be broken into shorter lines during UIL code generation. Some compilers cannot handle lines longer than 132 or 256 characters, a limit often exceeded by font lists or multi-font label strings. This option lets the user break these into multiple lines separated with a backslash and return character sequence.

wmPositionIsFrame

Specifies whether the window manager interprets X, Y locations relative to the window decorations. By default, most window managers take a window's X and Y location as relative to the decorations. Change this value if you notice that the main Builder Xcessory windows are not restoring their positions correctly from session to session.

xrunnerCommand

Specifies the libraries used to make an Xrunner object.

xtI nstanceNameCompliant

If False, allows instance names of widgets to begin with an upper case letter. If True, forces a lower case letter. Capitalized widget names may cause problems with the proper inheritance of application defaults resource values and conflicts with Xt specifications.

Documentation: