SCROLLGROUP

Definition

SCROLLGROUP [id]
{
  [Flags]

  GROUP
  {
    [Sub-elements]
    ...
  }
}

Description

Scroll groups let create scrollable panes in the layout.
The elements of the pane are normally placed inside a group within the scroll group, but a single element (e.g. a user area) can be placed directly within the scroll group.
Use GeDialog::SetVisibleArea() and GeDialog::GetVisibleArea() to control the currently visible area.

Note
To change the status bar of the scroll group send a BFM_SETSTATUSBAR message using the followings IDs:
Container IDTypeDescription
BFM_STATUSBAR_PROGRESSONBoolStatusbar active.
BFM_STATUSBAR_TXTStringFirst text.
BFM_STATUSBAR_PROGRESSFloatBetween 0.0 and 1.0.
BFM_STATUSBAR_PROGRESSSPINBoolSpinning bar.
BFM_STATUSBAR_HELPStringSecond text. (Help.)
Example:
BaseContainer msg(BFM_SETSTATUSBAR);
msg.SetInt32(BFM_STATUSBAR_PROGRESSON, true);
msg.SetString(BFM_STATUSBAR_TXT, "Progress text");
msg.SetString(BFM_STATUSBAR_HELP, "Help text");
msg.SetFloat(BFM_STATUSBAR_PROGRESS, 0.5);
msg.SetInt32(BFM_STATUSBAR_PROGRESSSPIN,true);
SendParentMessage(msg); // From a user area
SendMessage(SCROLLGROUPID, msg); // From a dialog
BaseContainer
Definition: c4d_basecontainer.h:48
BFM_STATUSBAR_HELP
@ BFM_STATUSBAR_HELP
String Second text. (Help.)
Definition: gui.h:842
BFM_STATUSBAR_PROGRESSON
@ BFM_STATUSBAR_PROGRESSON
Bool Statusbar active.
Definition: gui.h:838
BFM_STATUSBAR_TXT
@ BFM_STATUSBAR_TXT
String First text.
Definition: gui.h:839
BFM_SETSTATUSBAR
@ BFM_SETSTATUSBAR
To set a statusbar (e.g. inside a SCROLLGROUP (dialog element)):
Definition: gui.h:836
BFM_STATUSBAR_PROGRESS
@ BFM_STATUSBAR_PROGRESS
Float Between 0.0 and 1.0.
Definition: gui.h:840
BFM_STATUSBAR_PROGRESSSPIN
@ BFM_STATUSBAR_PROGRESSSPIN
Bool Spinning bar.
Definition: gui.h:841
msg
const char const char * msg
Definition: object.h:438

Flags

See Dialog Resource for a description of the common flags.

[LAYOUTFLAGS]Layout flags.
[SIZE]Manual size.
SCROLL_VAllow the group to scroll vertically.
SCROLL_HAllow the group to scroll horizontally.
SCROLL_BORDERDisplay a small border around the scroll group.
SCROLL_STATUSBARCreate a status bar for the scroll group.

Example

SCROLLGROUP IDC_SCROLL
{
  GROUP
  {
    STATICTEXT { NAME LONG_TEXT; }
    BUTTON BIG_BUTTON { SIZE -320,-240; }
  }
}

Further Reading