1.85.2 Send methods

label ->catch_all: name, unchecked ...

Messages not understood are delegated to the current label<-selection. If the selection is a name object and the method is known to class string, the selection will automatically be translated into a string object. This implies that a label that displays a name still understands all methods defined on class string. Notably string->append, and string->format are commonly used methods.

label ->compute:

Computes the graphical<-area of the label from the label<-selection. If the selection is text and the width of the text is smaller than label<-length times label<-fontlabel<-ex, the width is made equal to this value. This will reserver sufficient space when the label is placed by the automatic‘dialog graphical->layout’mechanism.

label ->event: event

Make the button behave as a button object if dialog_item<-message is defined.

First invokes dialog_item->event. If this fails and graphical<-active == @on and dialog_item<-message is not @nil, forward dialog_item<-message on a left-click. Uses @_button_gesture.

label ->execute:

Execute dialog_item<-message. Arguments:

@receiver	the label

This method is normally invoked from label->event through a click_gesture object.

label ->format: name, any ...

Create a formatted string from the arguments and make it the label<-selection. Equivalent to:

send(Label, selection, string(Format, Argument ...)).

label ->initialise: name=[name], selection=[string|image], font=[font]

Create a label from its name (used to reference it in its device; see device<-member) and its selection. The default name is reporter, which makes the label the reporter of the dialog (see dialog<-report_to). The default selection is” . The default font is determined by label.font.

The width a label object requires on the window is determined by label->length, whose default is determined by the resource label.length.

label ->report: kind={status,inform,progress,done,warning,error,fatal}, format=[char_array], argument=any ...

label->format the message in the label. If the type of the information is either warning or error it will invoke graphical->flash on @reportee.

Note that class dialog redefines visual<-report_to (see dialog<-report_to). If a label is called reporter (see graphical<-name), the dialog will delegate label->report messages to this label.

Kind is progress is equivalent to status, but sends label->flush to update the display immediately after changing the label<-selection. Kind is done appends the formatted text to the current label<-selection of the label. If format is @default, done is appended to the selection.

See also

dialog<-report_to

label ->status: {inactive,active,preview,execute}

Status of the label with regard to event processing. Not used.

label ->width: [0..]

Width of the label in pixels. This is used to achieve clean alignment. If label<-selection is an image object the image is scaled to this width and the height is scale proportionally.