Returns whether controls are clipped when graphics methods are used.
[ bClipControls = ] Object.ClipControls
The ClipControls property syntax has the following parts:
|
Name |
Type |
Description |
|
Object |
AForm |
AForm object |
|
bClipControls |
Bool |
A boolean expression that specifies how objects are repainted. |
bClipControls can be one of the following:
|
Value |
Description |
|
True * |
Graphics methods in Paint events repaint the entire object. A clipping region is created around nongraphical controls on the form before a Paint event. |
|
False |
Graphics methods in Paint events repaint only newly exposed areas. A clipping region is not created around nongraphical controls before a Paint event. |
Clipping is the process of determining which parts of a form are painted when the form is displayed or when areas of the forms requires painting. An outline of the form and controls is created in memory. The Windows operating environment uses this outline to paint some parts, such as the background, without affecting other parts, such as the contents of a TextBox control. Because the clipping region is created in memory, setting this property to False can reduce the time needed to paint or repaint a form. However some third party controls may not work properly when ClipControls is set to False.
This property is read-only at run time. The property has no effect on MDI Form type.