This class contains other Locana objects (except Lwindow and Ldisplay objects). This is Based on the Lcontainer class. It supports Lscrollbar objects (and other objects as well) on any border, and will soon support window dressing (title bar that looks and acts like a window). Scrollbars are automatic by default, you will see them only when they are needed. This class can also contain a Lmenubar object in the North border. This class also supports the following additional attributes:

• :vscroll => "Values are nil, :off, :on, :auto. :on turns a vertical scroll bar on; :off and nil turns the scroll bar off; :auto turns the scroll bar only when needed; nil reverts back to the default setting. The scroll bar sits on the right edge or border of the object.",
• :hscroll => "Values are nil, :off, :on, :auto. :on turns a horizontal scroll bar on; :off and nil turns the scroll bar off; :auto turns the scroll bar only when needed; nil reverts back to the default setting. The scroll bar sits on the bottom edge or border of the object.",

Create an instance variable indicating if this object has any borders.

Activates the menubar associated with this Lframe object. If this object does not have a menubar, then the parent objects are checked for a menubar. This first menubar found is activated.

Checks for Lmenubar and Lmenu_popup objects because they require special action. If object is a Lmenubar, it must be added to the top border rather than becoming a child object. If object is a Lmenu_pop, this object must point to it rather than becoming a child object.

• object - any Lobject object

Checks for Lmenubar and Lmenu_popup objects because they require special action. If object is a Lmenubar, it must be added to the top border rather than becoming a child object. If object is a Lmenu_pop, this object must point to it rather than becoming a child object.

• object - any Lobject object

Adds object to the north (top) border of the frame. The add(Lmenubar object) method uses this to add the menubar to the north border.

• object - any Lobject object

Adds object to the south (bottom) border of the frame.

• object - any Lobject object

Adds object to the west (left) border of the frame.

• object - any Lobject object

Adds object to the east (right) border of the frame.

• object - any Lobject object

Checks for Lmenubar and Lmenu_popup objects because they require special action. If object is a Lmenubar, it is removed from the north border, if the north border is empty it is removed. If object is a Lmenu_pop, eliminate the pointer to the popup menu.

• object - any Lobject object

Deletes object from the north border of the frame.

• object - any Lobject object

Deletes object from the south border of the frame.

• object - any Lobject object

Deletes object from the east border of the frame.

• object - any Lobject object

Deletes object from the west border of the frame.

• object - any Lobject object

Yields each child. When include_internal == true, also yields the north, south, east, and west border objects if they exist.

Returns the x pixel position of the client area of the object relative to the object’s upper left corner.

Returns the y pixel position of the client area of the object relative to the object’s upper left corner.

Returns the pixel height of the client area of the object.

Returns the pixel width of the client area of the object.

Returns the min_width of this object. Only used for Lwindow objects or when the :allow_size attribute is turned on to keep the object from getting too small. If there can be a scrollbar, the default adds 40 to the min_width.

Returns the min_height of this object. Only used for Lwindow objects or when the :allow_size attribute is turned on to keep the object from getting too small. If there can be a scrollbar, the default adds 40 to the min_height.

Returns 0.

Returns :auto when there is no :vscroll attribute.

Returns :auto when there is no :hscroll attribute.

Returns true if this object has a vertical scroll bar.

Returns true if this object has a horizontal scroll bar.

Returns true if this object needs a vertical scroll bar.

Returns true if this object needs a horizontal scroll bar.

If this object has a vertical scrollbar it is returned, otherwise returns nil.

If this object has a horizontal scrollbar it is returned, otherwise returns nil.

The scrollbars use this value for determining the alignment when dragging the scroller button. The default is 1.

• is_horizontal - true when you want the scroll_distance_alignment for the horizontal scroller; false or nil when you want the scroll_distance_alignment for the vertical scroller;

The scrollbars use this value for determining the scrolling distance when pushing one of the buttons in the scrollbar. The default is 20.

• is_horizontal - true when you want the scroll_distance for the horizontal scroller; false or nil when you want the scroll_distance for the vertical scroller;

The scrollbars use this value for determining the size of the scroller button. Return the pixel_height for horizontal scrollbars and pixel_width for vertical scrollbars.

• is_horizontal - true when you want the total size for the horizontal scroller; false or nil when you want the total size for the vertical scroller;

The scrollbars use this value for determining how the scroller works. Returns the pixel width or pixel height of the object depending on is_horizontal. Returns clientW() when is_horizontal is true (horizontal scrollbar) and clientH() when is_horizontal is false or nil (vertical scrollbars). The return value is rounded down to the size of scroll_distance so the scroller is always aligned properly.

• is_horizontal - true when you want the total size for the horizontal scroller; false or nil when you want the total size for the vertical scroller;

Triggered every time the scroller button is moved. It means the content inside the frame is moving. This moves every child to reflect the new scroller button position.

Sets the horizontal scroller position for this object. This does not move the scroller button in the horizontal scrollbar but it does move all children to reflect the new scroller position. The on_scroll method calls this. It scrolls the children of object left or right to match new_value.

Sets the vertical scroller position for this object. This does not move the scroller button in the vertical scrollbar but it does move all children to reflect the new scroller position. The on_scroll method calls this. It scrolls the children of object up or down to match new_value.

Resizes the scroller button in the horizontal and vertical scrollbars when needed and scrollbars exist. This is called when the objects size or content is changed. It calls update_horizontal_scrollbar() and update_vertical_scrollbar().

Resizes the scroller button in the horizontal scrollbar. Tells the horizontal scrollbar to check and update the scrollber button if needed and the horizontal scollbar exists.

Resizes the scroller button in the vertical scrollbar. Tells the vertical scrollbar to check and update the scrollber button if needed and the vertical scollbar exists.

Adds scrollbars if needed, removes scrollbars if no longer needed, and updates the scroller buttons in the scrollbars if they exist.

If menubar exists, it needs to be checked for the accelerator before checking any children for the accelerator.

A shortcut for add(Lmenubar.new(name, …)).

Creates and/or updates the north, south, east, and west border objects including any scrollbars as needed.