13 groupbox

{ export | reexport } { model } groupbox { <Identifier> }
{
  <standard attributes>
  <plain attributes>
  <geometry attributes>
  <grid attributes>
  <hierarchy attributes>
  <layout attributes>
  <scrollbar attributes>
  <object-specific attributes>
}

Events

extevent

help

hscroll

key

paste

scroll

select

vscroll

Children

canvas

checkbox

document

edittext

groupbox

image

layoutbox

listbox

notebook

poptext

pushbutton

radiobutton

record

rectangle

scrollbar

spinbox

splitbox

statictext

tablefield

transformer

treeview

Parent

groupbox

layoutbox

module

notepage

splitbox

toolbar

window

Menu

Pop-up menu

13.1 Attributes

13.2 Specific Attributes

Standard Attributes

The attribute .font defines the font to be used by objects contained in the groupbox.

Geometry Attributes

The attributes .vwidth and .vheight define the internal object size.

The attributes .xorigin and .yorigin define the origin shift. If these values are set to 0, the origin will be located in the top left corner of the groupbox. If the values are not 0, they specify the positions of the scrollbar sliders.

The grid attributes .xraster, .yraster and .reffont define the unit which is used for the size and position of the objects in the groupbox.

Layout Attributes

.bordercolor defines the color of the groupbox border.

Scrollbar Attributes

The scrollbar attributes .hsb_... and .vsb_... define whether the groupbox is to be provided with scrollbars.

The groupbox can have the following scrollbar attributes:

• .hsb_linemotion
• .hsb_optional
• .hsb_pagemotion
• .hsb_visible
• .vsb_linemotion
• .vsb_optional
• .vsb_pagemotion
• .vsb_visible

Operation mode of scrollbars in windows and groupboxes:

The visibility of scrollbars is influenced by the attributes

• .hsb/vsb_optional
• .hsb/vsb_visible

and

• .width/height
• .vwidth/vheight

The following rules are valid:

• A groupbox and a window can have horizontal scrollbars only if the virtual size .vwidth is set.
• A groupbox and a window can have vertical scrollbars only if the virtual size .vheight is set.

If no scrollbars are set, the virtual size will be ignored.

• The attributes .hsb/vsb_visible and .hsb/vsb_optional control whether the scrollbars are to be visible permanently or only if necessary.
• As mentioned above, scrollbars require the setting of the virtual size, i.e., if no virtual size is set, there will not be any scrollbars available:

If the scrollbars are visible,

• and .hsb/vsb_optional = true

  => the scrollbar is visible only if necessary.

• and .hsb/vsb_optional = false

  => the scrollbar is constantly visible.

Note

.hsb/vsb_optional is ignored by the Motif version, i.e. .hsb/vsb_optional implicitly will be always set to true.

To query or to change the scrollbar slider position, the attributes .xorigin and .yorigin have to be used. These attributes specify the shift of the object origin.

The attributes .pagemotion and .linemotion define the shift (in pixels) of object contents during the scrollbar action. Value 0 means that the system default value is to be used; for .pagemotion the scrolling is made page by page.

13.3 Example

The following example describes two groups of radiobuttons in one window.

window Radio_Window

{

  .title "radio window";

  ...

  child groupbox group_1

  {

    child radiobutton First

    { ...

    }

    child radiobutton Second

    { ...

    }

    child radiobutton Third

    { ...

    }

  }

  child groupbox group_2

  {

    child radiobutton Four

    { ...

    }

    child radiobutton Five

    { ...

    }

    child radiobutton Six

    { ...

    }

  }

}