//////////////////////////////////////////////////////////////////////////////// // // Licensed to the Apache Software Foundation (ASF) under one or more // contributor license agreements. See the NOTICE file distributed with // this work for additional information regarding copyright ownership. // The ASF licenses this file to You under the Apache License, Version 2.0 // (the "License"); you may not use this file except in compliance with // the License. You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // //////////////////////////////////////////////////////////////////////////////// package mx.core { /** * Dispatched after the content for this component has been created. With deferred * instantiation, the content for a component can be created long after the * component is created. * * @eventType mx.events.FlexEvent.CONTENT_CREATION_COMPLETE * * @langversion 3.0 * @playerversion Flash 10 * @playerversion AIR 1.5 * @productversion Flex 4 */ [Event(name="contentCreationComplete", type="mx.events.FlexEvent")] /** * The IDeferredContentOwner interface defines the properties and methods * for deferred instantiation. * * @see spark.components.SkinnableContainer * @see mx.core.Container * @see mx.core.INavigatorContent * * @langversion 3.0 * @playerversion Flash 10 * @playerversion AIR 1.5 * @productversion Flex 4 */ public interface IDeferredContentOwner extends IUIComponent { [Inspectable(enumeration="auto, all, none", defaultValue="auto")] /** * Content creation policy for this component. * *
Possible values are: *
auto
- Automatically create the content immediately before it is needed.all
- Create the content as soon as the parent component is created. This
* option should only be used as a last resort because it increases startup time and memory usage.none
- Content must be created manually by calling
* the createDeferredContent()
method.If no creationPolicy
is specified for a container, that container inherits the value of
* its parent's creationPolicy
property.
creationPolicy
property
* is auto
or all
, this the Flex framework calls this method. If the value of the
* creationPolicy
property is none
, you must explicitly call this method
* to create the content for the component.
*
* @langversion 3.0
* @playerversion Flash 10
* @playerversion AIR 1.5
* @productversion Flex 4
*/
function createDeferredContent():void;
/**
* A flag that indicates whether the deferred content has been created.
*
* @langversion 3.0
* @playerversion Flash 10
* @playerversion AIR 1.5
* @productversion Flex 4
*/
function get deferredContentCreated():Boolean;
}
}