(make-object mred:testable-text% parent func label value x y width height style name) -> mred:testable-text% object
parent : wx:panel% object
func : null or procedure of two arguments: a wx:text% object and a wx:command-event% object
label : string or null
value = "" : string
x = -1 : small integer
y = -1 : small integer
width = -1 : small integer
height = -1 : small integer
style = 0 : small integer
name = "text" : string
If func is not null, it is used as the callback for the
following event types:
- wx:const-event-type-text-command -- the text has changed
- wx:const-event-type-text-enter-command -- the enter
key has been pressed; this is only called when the
wx:const-process-enter style flag is used.
- wx:const-event-type-set-focus -- the item has received
the keyboard focus
- wx:const-event-type-skill-focus -- the item has lost
the keyboard focus
If label is not null, it will be used to label the text
item. Otherwise, no label will be used. The label string can mark a character of the label as the Windows shortcut by preceding the key with an ampersand (``&''). Ampersands are stripped from label before it is used as a label. Double ampersands are converted to a single (unstripped) ampersand.
The parameters x and y are used to specify an absolute position for the text item within the panel; if -1 is provided, a default position will be assigned such that the text item is placed next to the last item inserted into the panel. If width or height is -1, an appropriate size will be used for the text item based on the inital value string.
The style argument is a bitwise-ior combination of any of the
following:
- wx:const-process-enter -- the callback function will
receive the message wx:const-event-type-text-enter-command.
(Note: this will break tab traversal for this panel item under
Windows.)
- wx:const-password -- the text will be echoed as asterisks
- wx:const-readonly -- the text will not be user-editable
(Use 0 for no flags.)
The name argument is used to associate a name with the text field, allowing the application user to set X Windows resource values for each individual text field.