ClipSiblings

ClipSiblings

Controls how overlapping controls are treated

This is a style property that is only available in the forms designer. It is possible to modify this programmatically through the Style property in the Create event.

Applies to: Generic

ClipSiblings

If two controls on a form overlap then how the intersection is painted is determined by this style. If set to FALSE each control will paint the whole of its surface redrawing the intersectional area. If set TRUE then the intersection is clipped and the Z-order (effectively the tab order) of the controls will determine which control paints the intersection.

This is a design time only style. There is no effect if set or inspected at run time.

For Windows NT, Windows 2000 and Windows 9x this style is off by default. Enabling this style will result is a slower screen draw so it should be left off unless you really do need the feature. On the Windows CE kclient this style is always set (CE provides no mechanism to turn it off).

This style only matters if controls overlap. It concerns only sibling controls on the same form. Dependency on overlapping controls is discouraged as this style may not be programmable in future versions of KClient.

Here is an example program illustrating overlapping buttons. Buttons are redrawn whenever they are clicked.

- DEFFORM Form1()={.form,.form$,.Style=0x50c000c4,.Width=216,.Height=111,.text$="ClipSiblings example",.Id=1024}, \
{.ok,.button$,.Style=0x50010001,.Left=160,.Top=6,.Width=50,.Height=14,.text$="OK",.__Anchor=5,.Id=1}, \
{.cmdButton1,.button$,.Style=0x50010000,.Left=12,.Top=4,.Width=48,.Height=14,.text$="FALSE",.Id=1000}, \
{.cmdButton2,.button$,.Style=0x50010000,.Left=50,.Top=9,.Width=48,.Height=14,.text$="FALSE",.Id=1001}, \
{.cmdButton3,.button$,.Style=0x50010000,.Left=12,.Top=28,.Width=48,.Height=14,.text$="FALSE",.Id=1002}, \
{.cmdButton4,.button$,.Style=0x54010000,.Left=50,.Top=33,.Width=48,.Height=14,.text$="TRUE",.Id=1003}, \
{.cmdButton5,.button$,.Style=0x54010000,.Left=11,.Top=51,.Width=48,.Height=14,.text$="TRUE",.Id=1004}, \
{.cmdButton6,.button$,.Style=0x50010000,.Left=50,.Top=57,.Width=48,.Height=14,.text$="FALSE",.Id=1005}, \
{.cmdButton7,.button$,.Style=0x54010000,.Left=11,.Top=75,.Width=48,.Height=14,.text$="TRUE",.Id=1006}, \
{.cmdButton8,.button$,.Style=0x54010000,.Left=49,.Top=81,.Width=48,.Height=14,.text$="TRUE",.Id=1007}
FORM END Form1
Form1.Open()

See also

Generic methods, properties and events.