Futurebasic/Language/Reference/autoclip

From Wikibooks, open books for an open world
< Futurebasic | Language | Reference
Jump to: navigation, search

Contents

[edit] Autoclip

[edit] Statement

✔ Appearance ✔ Standard χ Console

[edit] Syntax

autoclip [=] booleanExpr

[edit] Description

If booleanExpr evaluates as "false" (zero), this statement turns off the "autoclip" flag for the current output window. If booleanExpr evaluates as "true" (nonzero), this statement turns on the "autoclip" flag for the current output window, unless the window was created with the _noAutoClip attribute.

If a window's autoclip flag is "on," things like buttons, edit fields and picture fields are excluded from the window's "clipping region." This exclusion means that such object are "protected"--drawing commands won't draw over such areas, and the cls command won't erase them. While leaving autoclip "on" is normally a good idea, it can slow down the execution of drawing commands, especially on older Macs.

Any FB window will have its autoclip flag "on" at the time it's created, unless the _noAutoClip attribute is set in the window statement that creates it.

[edit] Notes

No special notes.

[edit] See Also

_noAutoClip attribute in the window statement

Language Reference

Personal tools
Namespaces
Variants
Actions
Navigation
Community
Toolbox
Sister projects
Print/export