Initializes the BTextControl by assigning it a label and some text, both of which can be NULL. If the label is NULL, the entire bounds rectangle is assigned to the text. Otherwise, half the view is assigned to the label and half to the text, though the exact proportion can be changed by the SetDivider() function. The label always is on the left and the text always on the right. By default, both label and text are aligned at the left margins of their respective sections; call SetAlignment() to alter the alignment.

The message parameter is the same as the one declared for the BControl constructor. It establishes a model for the messages the BTextControl will send when it's invoked. It can be NULL. See SetMessage() and SetTarget() in the BInvoker class and Invoke() in the BControl class for more information.

The frame, name, resizingMode, and flags arguments are the same as those declared for the BView class and are passed up the inheritance hierarchy to the BView constructor without change. When the BTextControl is attached to a window, it will be resized to the optimal height for displaying the label and text.

Frees memory allocated by the BTextControl and its BTextView child.

Augments the BControl version of AttachedToWindow() to set up its child BTextView and to make the view and low colors of the BTextControl the same as the background view color of its new parent . This function also adjusts the height of the BTextControl to fit the height of the label and text, given the fonts used to display them.

See also: BView::AttachedToWindow()

Draws the label. (The BTextControl defers to its child BTextView to draw the editable text string.)

See also: BView::Draw()

GetPreferredSize() calculates the optimal size for the BTextControl to display the label and the text, given its current font and the current font of its BTextView child; it places the result in the variables that the width and height arguments refer to.

ResizeToPreferred() resizes the BTextControl to its preferred size, keeping its left and top sides constant, and adjusts the size of the BTextView to fit.

See also: BView::GetPreferredSize()

Handles scripting requests for the BTextControl.

See also: BHandler::MessageReceived()

Makes the child BTextView the focus view when the user clicks in the BTextControl but outside the text.

See also: BTextView::MouseDown()

Makes sure that the BTextControl is redrawn when the window is activated and deactivated, if its child BTextView is the current focus view. This gives the BTextControl a chance to draw or erase the indication that it's the current focus for keyboard navigation.

Calls the inherited version of Archive(), which will archive the child BTextView if the deep flag is true, then adds the alignment of the label and the text, the modification message, and the divider to the BMessage archive.

See also: BArchivable::Archive(), Instantiate() static function

Passes the MakeFocus() instruction on to the child BTextView. If the flag is true, this function selects all the text in the child BTextView, which becomes the new focus view for the window. If the flag is false, the child will no longer be the focus view. If the text has changed when the child ceases to be the focus view, the BTextControl is considered to have been invoked; a copy of its model message is posted so that it will be delivered to the target handler.

Note that the BTextControl itself never becomes the focus view, so will return false to all IsFocus() queries.

See also: BView::MakeFocus()

Resolves specifiers for the Label and Value properties. See "Scripting" section of The Application Kit chapter for more information.

See also: BHandler::ResolveSpecifier()

These functions set and report the alignment of the label and the text within their respective portions of the view. Three settings are possible:

The default alignment is B_ALIGN_LEFT for both label and text.

See also: SetDivider()

These functions set and return the x coordinate value that marks the division between the label portion of the view rectangle on the left and the text portion on the right. It's stated in the coordinate system of the BTextControl.

See also: The BTextControl constructor

Disables the BTextControl if the enabled flag is false, and reenables it if enabled is true. BTextControls are enabled by default.

This function augments the BControl version of SetEnabled(). When the control is disabled, it makes the text unselectable (and therefore uneditable) and draws it in a way that displays its disabled state. When the control is re-enabled, it makes the text editable (and therefore selectable) and draws it as normal text.

These functions set and return the message that the BTextControl sends to its target when the user begins to enter or edit text.

SetModificationMessage() assigns message to the BTextControl, freeing the message previously assigned, if any. The message becomes the responsibility of the BTextControl object and will be freed only when it's replaced by another message or the BTextControl is freed; you shouldn't free it yourself. Passing a NULL pointer to this function deletes the current modification message without replacing it.

The assigned BMessage becomes the model for the message that the BTextControl sends whenever the user modifies the text when the child BTextView is the focus view.

Before sending the message, the BTextControl adds these two pieces of information to it:

These names should not be used for any data that you place in the model message.

ModificationMessage() returns the model message.

These functions set and return the text displayed by the BTextControl—or rather by its child BTextView. The text is first set by the constructor.

Returns the child BTextView object that handles the BTextControl's editing chores.

Returns a new BTextControl object, allocated by new and created with the version of the constructor that takes a BMessage archive. However, if the archive message doesn't contain data for a BTextControl object, Instantiate() returns NULL.

See also: BArchivable::Instantiate(), instantiate_object(), Archive()