hg/stx-libtool2: comparison UISpecificationTool.st

equal deleted inserted replaced

-:b182b42defd0
+:2dc82cdfdd90
 ! !
 !UISpecificationTool class methodsFor:'help specs'!
 helpSpec
-"return a dictionary filled with helpKey -> helptext associations.
+"This resource specification was automatically generated
-These are used by the activeHelp tool."
+by the UIHelpTool of ST/X."
-"
+"Do not manually edit this!! If it is corrupted,
-UIHelpTool openOnClass:UISpecificationTool
+the UIHelpTool may not be able to read the specification."
-"
+"
-^ super helpSpec addPairsFrom:#(
+UIHelpTool openOnClass:UISpecificationTool
+"
+<resource: #help>
+^super helpSpec addPairsFrom:#(
 #acceptChannel
 'acceptChannel for the view. This field specifies the name of the aspect (-method or binding) in your application, which is supposed to return a valueHolder on to the boolean accept-flag.\ If the holder changed its value to true, the contents will be accepted and the modifiaction flag is set to false.'
 #acceptImmediate
 #acceptOnTab
 'input will we sent to the model when the tab key is pressed'
 #action
-'action selector sent to the application when the button is activated. (either on-press or on-release; this depends on the setting of triggerOnDown flag). The selector may be for a one-arg message; in this case, the argument is passed (a string).'
+'Name of the selector which is sent to the application when the widget is pressed. (If the selector is a one-arg selector, the argument is passed as a string).'
 #actionArg
-'action argument passed to action method, if action selector is a one-arg selector (i.e. ends with '':''). The arg is passed as a string.'
+'Argument passed with the action selector. The action selector must end with '':''.'
 #appletParamText
 'Paste the complete appletTAGs HTML text here (i.e. all from <applet> up to and including the </applet>). Press parse to extract all parameters from it.'
 #appletTextParse
 #archiveEntry
 'The name of a zip-file archive, if the class(es) are to be loaded from a zip-archive.'
 #arrowButtonDirection
-'the direction of the arrow.'
+'Specifies the direction of the arrow.'
 #autoRepeat
-'repeat the action as long as the button is pressed; to have this behavior the ''isTriggerOnDown'' state must be enabled.'
+'Turns on/off that the action is evaluated repeatly as long as the button is pressed. To get this behavior, the check box ''Trigger On Down'' must be turned on.'
 #backgroundChannel
-'a holder, which provides the widgets backgroundColor. Useful if the labels bg color is to be changed dynamically (alerts).'
+'Aspect selector or binding for the background color of the widget''s view. It should return a ValueHolder with a Color. (It is useful, if the background color has to be changed dynamically.)'
 #backgroundColor
-'set the background color if the color-checkBox is turned on. Otherwise, the widget uses its default background color (which is specified in the styleSheet).'
+'Defines the background color of the widget. After selecting the check toggle the background color can be chosen by selecting the desired colored button. If no color is selected, the widget takes its default background color from the style sheet.'
 #beDefault
-'show/dont show a return-key image after the label'
+'Turns on/off displaying of a return-key after the label.'
 #beDependentOfRows
 'make each row in the list dependant. Thus, whenever a row raises a change notification, the row will be redrawn (if visible on the screen).'
 #booleanHolder
-'aspect of a boolean holder which keeps the state'
+'Aspect of a boolean holder which keeps the state'
 #borderWidth
 'width of the border'
 #canvas
 #doubleClickSelector
 'double click action which is evaluated on double click in case of a non-nil selection. \ If the selector ends with '':'' the method is invoked with the current selection as argument.'
 #downAction
-'action selector sent to the application when the down button is activated. The selector may be for a one-arg message; in this case, the argument is passed.'
+'Name of the selector which is sent to the application when the down(right)-button is pressed. If the selector is an one-arg selector, the argument is passed as a string.'
 #enableChannel
-'enableHolder for the view. This field specifies the name of the aspect (-method or binding) in your application, which is supposed to return a valueHolder on to the boolean enable-flag. This is convenient, if many widgets are to be enabled/disabled depending on the setting of a single flag, because the application can change them all with a single setting of the enableHolders value.'
+'Aspect selector or binding for en-/disabling of the widget''s view. It should return a boolean ValueHolder.'
 #fileSelectionFilterClas
 'the name of the Item class used to create the entries into the hierarchical list. The class is oblegated to provide the whole interface of the FileSelectionItem class. If no class is specified, the FileSelectionItem class is used. \ Thus you can define your own filter operations, icons, ....'
 #fileSelectionTreeRoot
 #fitLastRow
 'fit rows to tab horizontal or vertical extent'
 #fontMenu
-'set the font for the widget if the font-checkBox is turned on. Otherwise, the widget uses its default font (which is specified in the viewStyle).'
+'Defines the font style of the widget. After selecting the check toggle the font style can be chosen by selecting one of the Family/Face/Style/Size buttons. If no font style is selected, the widget takes its default font style from the style sheet.'
 #forceRecursiveBackground
 'also change all subcomponents viewBackground (recursively).'
 #foregroundChannel
-'a holder, which provides the widgets foregroundColor. Useful if the labels fg color is to be changed dynamically (alerts).'
+'Aspect selector or binding for the foreground color of the widget''s view. It should return a ValueHolder with a Color. (It is useful, if the foreground color has to be changed dynamically.)'
 #foregroundColor
-'set the foreground color if the color-checkBox is turned on. Otherwise, the widget uses its default foreground color (which is specified in the styleSheet).'
+'Defines the foreground color of the widget. After selecting the check toggle the foreground color can be chosen by selecting the desired colored button. If no color is selected, the widget takes its default foreground color from the style sheet.'
 #galleryLabels
 'a list of tab labels'
 #galleryModel
 #horizontalSpace
 'horizontal space between elements on pixels'
 #id
-'the symbolic name of the component.  This ID can be used by the application to access components, using #componentAt:<ID>'
+'Unique symbolic name (ID) of the widget. This ID can be used by the application to access the view via builder>>componentAt:ID.'
 #initiallyDisabled
-'if on, the widget is initially disabled (to be enabled programatically with "(self componentAt:<ID>) enable").'
+'Turns on/off that the view of the widget is initially disabled.'
 #initiallyInvisible
-'if on, the widget is initially invisible (to be made visible programatically with "(self componentAt:<ID>) beVisible")).'
+'Turns on/off that the view of the widget is initially invisible.'
 #inputFieldGroup
 'symbolic ID of the input group - fields within a group can be reached via cursor up/down.'
 #isMultiSelect
 #isOpaque
 'define how the widget is displayed; opaque or not opaque'
 #isTriggerOnDown
-'if true, the action is evaluated when the button is pressed; otherwise, when released.'
+'Turns on/off that the action is evaluated when the button is pressed; otherwise, when released.'
 #label
-'the label of the widget. If ''label is image'' is off, this is the label string. Otherwise, it specifies the applications selector, which returns the label - either a string or a bitmap image.'
+'The label of the button. If the check box ''Label Is Image'' is turned off, this is the label string. Otherwise, it is the name of the selector, which returns the label - either a string or a bitmap image from the application.'
 #labelChannel
-'a holder, which provides the widgets label. Useful if the label is to be changed dynamically.'
+'Aspect selector or binding for the label of the widget''s view. It should return a ValueHolder with a String. (It is useful, if the label has to be changed dynamically.)'
 #labelIsImage
-'if ''label is image'' is off (the default), the widgets label is the string as entered in the label aspect. Otherwise, its the name of the message sent to the application - this should return a string or bitmap image, which is used as logo in the widget.'
+'Turns on/off that the name of the label is taken as selector. The selector should return a string or bitmap image used as logo in the widget.'
 #labelPositionList
 'define the position of the label'
 #lampColor
-'set the lamp color if the color-checkBox is turned on. Otherwise, the widget uses its default lamp color (which is specified in the styleSheet).'
+'Defines the lamp color of the widget. After selecting the check toggle the lamp color can be chosen by selecting the desired colored button. If no color is selected, the widget takes its default lamp color from the style sheet.'
 #level
 'the 3D-level relative to its superView. If left blank, the components default is used.'
 #listHolder
 #maxYField
 'the maximum height - the user will not be allowed to resize the topView to a larger height.'
 #menuButton
-'open a menu editor on the specified menu selector.'
+'Opens a Menu Editor on the application  class and the defined selector.'
 #menuHolder
 'aspect selector or holder which provides the middle button menu'
 #menuId
-'the aspect of the menu. The application may respond to this message by returning a menu.'
+'Aspect selector or binding for the  building of the tool bar components. It should return a menu spec.'
 #menuPerformer
-'aspect providing an object which gets the menu messages. If left blank, the menu sends its menuMessages to the application.'
+'Aspect selector or binding for sending the messages of the tool bar items to an  object.  It should return an object which can receive the messages.'
 #middleButtonPressed
 'called if the middle button is pressed; you can open a menu'
 #minSize
 #openSubSpecGuiHelp
 'Start a GUI Builder for this subspecification.'
 #orientation
-'define the orientation of the widget; horizontal or vertical.'
+'Defines the direction of the alignment of the two arrows (horizontal or vertical).'
 #paramAdd
 'Adds a name-value pair to the parameters collection.'
 #paramList
 #showFrame
 'show the frame'
 #showLamp
-'enable/disable display of the toggles lamp.'
+'Turns on/off that a colored lamp is shown.'
 #showLines
 'show or hide lines'
 #showPercentage
 #showSeparatingLines
 'seperate each menu item by a vertical or horizontal line dependant on its vertical layout'
 #sizeAsDefault
-'let the widget compute its size to include space for the default (return) image. Useful for buttons which are not default buttons initially, but may become a default button dynamically.'
+'Turns on/off that the widget computes its size including space for the default (return) image. Useful for buttons which are initially not default buttons , but may become a default button dynamically.'
 #specHolder
 'holder which provides the selector to access the windowspec used to open the sub application derived from the application holder. If no selector is defined, the #windowSpec selector is used.'
 #start
 #tabWidget
 'select the tab style (windows- or mac look)'
 #tabable
-'if on, the widget can be reached by tabbing.'
+'Turns on/off that the view of the widget can be reached by tabbing.'
 #translateLabel
-'if on, the labelString is translated via the resource mechanism to a national language string (if a translation for that string is present in the resource file of the application).'
+'Turns on/off that the label string is translated via the resource mechanism to a national language string. A translation for that string must be defined in the resource file of the application class.'
 #typeConverter
 'convert the fields string value to some other object. Needed if the aspectValue is not a string (typically numbers).'
 #upAction
-'action selector sent to the application when the up button is activated. The selector may be for a one-arg message; in this case, the argument is passed.'
+'Name of the selector which is sent to the application when the up(left)-button is pressed. If the selector is an one-arg selector, the argument is passed as a string.'
 #useIndex
 'set/clear the useIndex flag. If set, the index of the selection is stored into the model; otherwise the selected string.'
 #usePreferredExtent
 #windowLabel
 'the windows label. This will be displayed by the windowManager in the windows frame.'
 )
-"Modified: / 6.2.1998 / 14:08:44 / stefan"
 ! !
 !UISpecificationTool class methodsFor:'interface specs'!
 windowSpec
 spec := specification class perform:((slices at:idx) last).
 ]
 ].
 spec ~= selection ifTrue:[
 self releaseResources.
 frame := builder componentAt:#Frame.
 frame destroySubViews.
 spec notNil ifTrue:[
 builder buildFromSpec:spec in:frame.
 frame allViewBackground:(frame viewBackground).
-frame realizeAllSubViews.
+masterApplication updateFonts.
+frame realizeAllSubViews.
 ]
 ].
 selection := spec.
 ! !

changeset 752	2dc82cdfdd90
parent 610	c6dc33689c6a
child 759	f0c325edcc6c