
package com.smartgwt.client.docs;

/**
 * <h3>Batch Widget Creation</h3>
 * When many widgets are created at once before any of them draw (such as during {@link
 * com.smartgwt.client.rpc.RPCManager#createScreen RPCManager.createScreen()} or {@link
 * com.smartgwt.client.rpc.RPCManager#loadScreen 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. <P> {@link
 * com.smartgwt.client.widgets.Canvas#startBatchCreation Canvas.startBatchCreation()} enables this
 * mode, and {@link com.smartgwt.client.widgets.Canvas#endBatchCreation 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
 * <code>endBatchCreation()</code> is not called explicitly. <P> This mode is used automatically
 * by <code>createScreen()</code> and <code>loadScreen()</code>. It can also be used by
 * application code that creates many widgets programmatically before drawing any of them. <P> See
 * also  Class.assumeGoodCode, which separately skips input-validation checks.
 * @see com.smartgwt.client.widgets.Canvas#startBatchCreation
 * @see com.smartgwt.client.widgets.Canvas#endBatchCreation
 */
public interface BatchCreation {
}
