Blitz3D+ Command Reference

CreateSeparator ( x,y,width,height,group[,style] )

Parameters

x,y - position of the separator's top-left corner within the group's client area

width,height - size of the separator; keep the thickness small (around 2 units)

group - window or gadget group that owns the separator

style (optional) - orientation
1: horizontal rule (default)
2: vertical rule

Description

Creates a flat native separator line and returns its handle.

Requires Extended language mode.

A separator is a thin, centred system-colour rule for dividing a panel into visual sections - between the transform fields and the shortcut settings of an inspector, say. It is purely visual: separators never take keyboard focus and never post events.

Style 1 draws a horizontal rule (give it a small height), style 2 a vertical one (small width). Any other style value is a runtime error. For a separator between menu items, use CreateMenu with an empty string instead.

See it working in the native input controls sample.

See also: CreateGroupBox, CreatePanel, CreateLabel, SetGadgetShape.

Index