Package com.smartgwt.client.docs

# Interface BatchCreation

public interface BatchCreation

### Batch Widget Creation

When many widgets are created at once before any of them draw (such as during `RPCManager.createScreen()` or `RPCManager.loadScreen()`), certain initialization work can be deferred to draw time for a significant speedup. This includes visual decorations (edges, shadows, back masks), layout margin computation, icon setup, validator scanning, rule evaluation, and topElement propagation.

`Canvas.startBatchCreation()` enables this mode, and `Canvas.endBatchCreation()` disables it. A thread-exit action (TEA) is automatically registered as a safety net to ensure the mode is always disabled at the end of the current JavaScript thread, even if `endBatchCreation()` is not called explicitly.

This mode is used automatically by `createScreen()` and `loadScreen()`. It can also be used by application code that creates many widgets programmatically before drawing any of them.

See also Class.assumeGoodCode, which separately skips input-validation checks.

See Also:
  - `Canvas.startBatchCreation()`
  - `Canvas.endBatchCreation()`