패키지 | spark.layouts.supportClasses |
클래스 | public class LayoutBase |
상속 | LayoutBase OnDemandEventDispatcher Object |
하위 클래스 | BasicLayout, ButtonBarHorizontalLayout, ConstraintLayout, HorizontalLayout, MosaicLayoutBase, TabbedViewNavigatorTabBarHorizontalLayout, TileLayout, VerticalLayout, ViewMenuLayout |
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
LayoutBase
or one of its subclasses.
At minimum, subclasses must implement the updateDisplayList()
method, which positions and sizes the target
GroupBase's elements, and
the measure()
method, which calculates the default
size of the target
.
Subclasses may override methods like getElementBoundsAboveScrollRect()
and getElementBoundsBelowScrollRect()
to customize the way
the target behaves when it's connected to scrollbars.
Subclasses that support virtualization must respect the
useVirtualLayout
property and should only retrieve
layout elements within the scrollRect (the value of
getScrollRect()
) using getVirtualElementAt()
from within updateDisplayList()
.
The <s:LayoutBase>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:LayoutBase Properties clipAndEnableScrolling="false" dropIndicator="defined by the skin class" horizontalScrollPosition="0" target="null" typicalLayoutElement="null" useVirtualLayout="false" verticalScrollPosition="0" />
속성 | 정의 주체 | ||
---|---|---|---|
clipAndEnableScrolling : Boolean
If true, specifies to clip the children to the boundaries of the viewport. | LayoutBase | ||
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
dropIndicator : DisplayObject
The DisplayObject that this layout uses for
the drop indicator during a drag-and-drop operation. | LayoutBase | ||
horizontalScrollPosition : Number
The x coordinate of the origin of the viewport in the component's coordinate system,
where the default value is (0,0) corresponding to the upper-left corner of the component. | LayoutBase | ||
target : GroupBase
The GroupBase container whose elements are measured, sized and positioned
by this layout. | LayoutBase | ||
typicalLayoutElement : ILayoutElement
Used by layouts when fixed row/column sizes are requested but
a specific size isn't specified. | LayoutBase | ||
useVirtualLayout : Boolean
A container can hold any number of children. | LayoutBase | ||
verticalScrollPosition : Number
The y coordinate of the origin of the viewport in the component's coordinate system,
where the default value is (0,0) corresponding to the upper-left corner of the component. | LayoutBase |
메서드 | 정의 주체 | ||
---|---|---|---|
Constructor. | LayoutBase | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event. | OnDemandEventDispatcher | ||
Calculates the drop location in the data provider of the drop target for
the specified dragEvent. | LayoutBase | ||
When useVirtualLayout is true,
this method can be used by the layout target
to clear cached layout information when the target changes. | LayoutBase | ||
Dispatches an event into the event flow. | OnDemandEventDispatcher | ||
Called by the target after a layout element
has been added and before the target's size and display list are
validated. | LayoutBase | ||
This method must is called by the target after a layout element
has been removed and before the target's size and display list are
validated. | LayoutBase | ||
Returns the specified element's layout bounds as a Rectangle or null
if the index is invalid, the corresponding element is null,
includeInLayout=false,
or if this layout's target property is null. | LayoutBase | ||
Returns the change to the horizontal scroll position to handle
different scrolling options. | LayoutBase | ||
getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
Delegation method that determines which item
to navigate to based on the current item in focus
and user input in terms of NavigationUnit. | LayoutBase | ||
Computes the verticalScrollPosition and
horizontalScrollPosition deltas needed to
scroll the element at the specified index into view. | LayoutBase | ||
Returns the change to the vertical scroll position to handle
different scrolling options. | LayoutBase | ||
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event. | OnDemandEventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Hides the previously shown drop indicator,
created by the showDropIndicator() method,
removes it from the display list and also stops the drag scrolling. | LayoutBase | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
Measures the target's default size based on its content, and optionally
measures the target's default minimum size. | LayoutBase | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
Removes a listener from the EventDispatcher object. | OnDemandEventDispatcher | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
Sizes, positions and parents the drop indicator based on the specified
drop location. | LayoutBase | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
Sizes and positions the target's elements. | LayoutBase | ||
Called by the target at the end of its updateDisplayList
to have the layout update its scrollRect. | LayoutBase | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type. | OnDemandEventDispatcher |
메서드 | 정의 주체 | ||
---|---|---|---|
Calculates how much to scroll for the specified dropLocation
during a drag and drop gesture. | LayoutBase | ||
Returns the index where a new item should be inserted if
the user releases the mouse at the specified coordinates
while completing a drag and drop gesture. | LayoutBase | ||
Calculates the bounds for the drop indicator that provides visual feedback
to the user of where the items will be inserted at the end of a drag and drop
gesture. | LayoutBase | ||
Returns the bounds of the first layout element that either spans or
is above the scrollRect's top edge. | LayoutBase | ||
Returns the bounds of the first layout element that either spans or
is below the scrollRect's bottom edge. | LayoutBase | ||
Returns the bounds of the first layout element that either spans or
is to the left of the scrollRect's left edge. | LayoutBase | ||
Returns the bounds of the first layout element that either spans or
is to the right of the scrollRect's right edge. | LayoutBase | ||
Returns the bounds of the target's scroll rectangle in layout coordinates. | LayoutBase | ||
Called when the verticalScrollPosition or
horizontalScrollPosition properties change. | LayoutBase |
clipAndEnableScrolling | 속성 |
clipAndEnableScrolling:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
If true
, specifies to clip the children to the boundaries of the viewport.
If false
, the container children extend past the container boundaries,
regardless of the size specification of the component.
기본값: false.
구현
public function get clipAndEnableScrolling():Boolean
public function set clipAndEnableScrolling(value:Boolean):void
dropIndicator | 속성 |
dropIndicator:DisplayObject
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
The DisplayObject
that this layout uses for
the drop indicator during a drag-and-drop operation.
Typically you do not set this property directly,
but instead define a dropIndicator
skin part in the
skin class of the drop target.
The List control sets this property in response to a
DragEvent.DRAG_ENTER
event.
The List initializes this property with an
instance of its dropIndicator
skin part.
The List clears this property in response to a
DragEvent.DRAG_EXIT
event.
구현
public function get dropIndicator():DisplayObject
public function set dropIndicator(value:DisplayObject):void
horizontalScrollPosition | 속성 |
horizontalScrollPosition:Number
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
The x coordinate of the origin of the viewport in the component's coordinate system,
where the default value is (0,0) corresponding to the upper-left corner of the component.
If clipAndEnableScrolling
is true
, setting this property
typically causes the viewport to be set to:
new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)Implementations of this property must be Bindable and must generate events of type
propertyChange
.
기본값: 0.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 propertyChange
이벤트를 전달합니다.
구현
public function get horizontalScrollPosition():Number
public function set horizontalScrollPosition(value:Number):void
target | 속성 |
target:GroupBase
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
The GroupBase container whose elements are measured, sized and positioned by this layout.
Subclasses may override the setter to perform target specific
actions. For example a 3D layout may set the target's
maintainProjectionCenter
property here.
기본값: null.
구현
public function get target():GroupBase
public function set target(value:GroupBase):void
관련 API 요소
typicalLayoutElement | 속성 |
typicalLayoutElement:ILayoutElement
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Used by layouts when fixed row/column sizes are requested but a specific size isn't specified. Used by virtual layouts to estimate the size of layout elements that have not been scrolled into view.
This property references a component that Flex uses to define the height of all container children, as the following example shows:
<s:Group> <s:layout> <s:VerticalLayout variableRowHeight="false" typicalLayoutElement="{b3}"/> </s:layout> <s:Button id="b1" label="Button 1"/> <s:Button id="b2" label="Button 2"/> <s:Button id="b3" label="Button 3" fontSize="36"/> <s:Button id="b4" label="Button 4" fontSize="24"/> </s:Group>
If this property has not been set and the target is non-null then the target's first layout element is cached and returned.
The default value is the target's first layout element.
기본값: null.
구현
public function get typicalLayoutElement():ILayoutElement
public function set typicalLayoutElement(value:ILayoutElement):void
관련 API 요소
useVirtualLayout | 속성 |
useVirtualLayout:Boolean
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
A container can hold any number of children. However, each child requires an instance of an item renderer. If the container has many children, you might notice performance degradation as you add more children to the container.
Instead of creating an item renderer for each child, you can configure the container to use a virtual layout. With virtual layout, the container reuses item renderers so that it only creates item renderers for the currently visible children of the container. As a child is moved off the screen, possible by scrolling the container, a new child being scrolled onto the screen can reuse its item renderer.
To configure a container to use virtual layout, set the useVirtualLayout
property
to true
for the layout associated with the container.
Only DataGroup or SkinnableDataContainer with layout set to VerticalLayout,
HorizontalLayout, or TileLayout supports virtual layout.
Layout subclasses that do not support virtualization must prevent changing
this property.
Note: The BasicLayout class throws a run-time error if you set
useVirtualLayout
to true
.
When true
, layouts that support virtualization must use
the target.getVirtualElementAt()
method,
rather than getElementAt()
, and must only get the
elements they anticipate will be visible given the value of getScrollRect()
.
When true
, the layout class must be able to compute
the indices of the layout elements that overlap the scrollRect
in its
updateDisplayList()
method based exclusively on cached information, not
by getting layout elements and examining their bounds.
Typically virtual layouts update their cached information
in the updateDisplayList()
method,
based on the sizes and locations computed for the elements in view.
Similarly, in the measure()
method, virtual layouts should update the target's
measured size properties based on the typicalLayoutElement
and other
cached layout information, not by measuring elements.
Containers cooperate with layouts that have useVirtualLayout
= true
by
recycling item renderers that were previously constructed, but are no longer in use.
An item is considered to be no longer in use if its index is not
within the range of getVirtualElementAt()
indices requested during
the container's most recent updateDisplayList()
invocation.
기본값: false.
구현
public function get useVirtualLayout():Boolean
public function set useVirtualLayout(value:Boolean):void
관련 API 요소
verticalScrollPosition | 속성 |
verticalScrollPosition:Number
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
The y coordinate of the origin of the viewport in the component's coordinate system,
where the default value is (0,0) corresponding to the upper-left corner of the component.
If clipAndEnableScrolling
is true
, setting this property
typically causes the viewport to be set to:
new Rectangle(horizontalScrollPosition, verticalScrollPosition, width, height)Implementations of this property must be Bindable and must generate events of type
propertyChange
.
기본값: 0.
이 속성은 데이터 바인딩에 대한 소스로 사용할 수 있습니다. 이 속성을 수정하면 propertyChange
이벤트를 전달합니다.
구현
public function get verticalScrollPosition():Number
public function set verticalScrollPosition(value:Number):void
LayoutBase | () | 생성자 |
public function LayoutBase()
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Constructor.
calculateDragScrollDelta | () | 메서드 |
protected function calculateDragScrollDelta(dropLocation:DropLocation, elapsedTime:Number):Point
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Calculates how much to scroll for the specified dropLocation
during a drag and drop gesture.
Called by the showDropIndicator()
method to calculate the scroll
during drag-scrolling.
매개 변수
dropLocation:DropLocation — A valid DropLocation object previously obtained
by calling the calculateDropLocation() method.
| |
elapsedTime:Number — The duration, in milliseconds, since the drag scrolling start.
|
Point — How much to drag scroll, or null if drag-scrolling is not needed.
|
관련 API 요소
calculateDropIndex | () | 메서드 |
protected function calculateDropIndex(x:Number, y:Number):int
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the index where a new item should be inserted if
the user releases the mouse at the specified coordinates
while completing a drag and drop gesture.
Called by the calculatedDropLocation()
method.
매개 변수
x:Number — The x coordinate of the drag and drop gesture, in
local coordinates.
| |
y:Number — The y coordinate of the drag and drop gesture, in
the drop target's local coordinates.
|
int — The drop index or -1 if the drop operation is not available
at the specified coordinates.
|
관련 API 요소
calculateDropIndicatorBounds | () | 메서드 |
protected function calculateDropIndicatorBounds(dropLocation:DropLocation):Rectangle
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Calculates the bounds for the drop indicator that provides visual feedback
to the user of where the items will be inserted at the end of a drag and drop
gesture.
Called by the showDropIndicator()
method.
매개 변수
dropLocation:DropLocation — A valid DropLocation object previously returned
by the calculateDropLocation() method.
|
Rectangle — The bounds for the drop indicator or null.
|
관련 API 요소
calculateDropLocation | () | 메서드 |
public function calculateDropLocation(dragEvent:DragEvent):DropLocation
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Calculates the drop location in the data provider of the drop target for
the specified dragEvent
.
매개 변수
dragEvent:DragEvent — The drag event dispatched by the DragManager.
|
DropLocation — Returns the drop location for this event, or null if the drop
operation is not available.
|
관련 API 요소
clearVirtualLayoutCache | () | 메서드 |
public function clearVirtualLayoutCache():void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
When useVirtualLayout
is true
,
this method can be used by the layout target
to clear cached layout information when the target changes.
For example, when a DataGroup's dataProvider
or
itemRenderer
property changes, cached
elements sizes become invalid.
When the useVirtualLayout
property changes to false
,
this method is called automatically.
Subclasses that support useVirtualLayout
= true
must override this method.
elementAdded | () | 메서드 |
public function elementAdded(index:int):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Called by the target after a layout element has been added and before the target's size and display list are validated. Layouts that cache per element state, like virtual layouts, can override this method to update their cache.
If the target calls this method, it's only guaranteeing that a
a layout element will exist at the specified index at
updateDisplayList()
time, for example a DataGroup
with a virtual layout will call this method when an item is added
to the targets dataProvider
.
By default, this method does nothing.
매개 변수
index:int — The index of the element that was added.
|
관련 API 요소
elementRemoved | () | 메서드 |
public function elementRemoved(index:int):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
This method must is called by the target after a layout element has been removed and before the target's size and display list are validated. Layouts that cache per element state, like virtual layouts, can override this method to update their cache.
If the target calls this method, it's only guaranteeing that a
a layout element will no longer exist at the specified index at
updateDisplayList()
time.
For example, a DataGroup
with a virtual layout calls this method when an item is added to
the dataProvider
property.
By default, this method does nothing.
매개 변수
index:int — The index of the element that was added.
|
관련 API 요소
getElementBounds | () | 메서드 |
public function getElementBounds(index:int):Rectangle
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the specified element's layout bounds as a Rectangle or null
if the index is invalid, the corresponding element is null,
includeInLayout=false
,
or if this layout's target
property is null.
Layout subclasses that support useVirtualLayout=true
must
override this method to compute a potentially approximate value for
elements that are not in view.
매개 변수
index:int — Index of the layout element.
|
Rectangle — The specified element's layout bounds.
|
관련 API 요소
getElementBoundsAboveScrollRect | () | 메서드 |
protected function getElementBoundsAboveScrollRect(scrollRect:Rectangle):Rectangle
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the bounds of the first layout element that either spans or is above the scrollRect's top edge.
This is a convenience method that is used by the default
implementation of the getVerticalScrollPositionDelta()
method.
Subclasses that rely on the default implementation of
getVerticalScrollPositionDelta()
should override this method to
provide an accurate bounding rectangle that has valid top
and
bottom
properties.
By default this method returns a Rectangle with width=0, height=1,
whose top edge is one less than the top edge of the scrollRect
,
and left=0.
Subclasses should override this method to provide an accurate
bounding rectangle that has valid top
and
bottom
properties.
매개 변수
scrollRect:Rectangle — The target's scrollRect.
|
Rectangle — The bounds of the first element that spans or is
above the scrollRect's top edge.
|
관련 API 요소
getElementBoundsBelowScrollRect | () | 메서드 |
protected function getElementBoundsBelowScrollRect(scrollRect:Rectangle):Rectangle
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the bounds of the first layout element that either spans or is below the scrollRect's bottom edge.
This is a convenience method that is used by the default
implementation of the getVerticalScrollPositionDelta()
method.
Subclasses that rely on the default implementation of
getVerticalScrollPositionDelta()
should override this method to
provide an accurate bounding rectangle that has valid top
and
bottom
properties.
By default this method returns a Rectangle with width=0, height=1,
whose bottom edge is one more than the bottom edge of the scrollRect
,
and left=0.
매개 변수
scrollRect:Rectangle — The target's scrollRect.
|
Rectangle — The bounds of the first element that spans or is
below the scrollRect's bottom edge.
|
관련 API 요소
getElementBoundsLeftOfScrollRect | () | 메서드 |
protected function getElementBoundsLeftOfScrollRect(scrollRect:Rectangle):Rectangle
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the bounds of the first layout element that either spans or is to the left of the scrollRect's left edge.
This is a convenience method that is used by the default
implementation of the getHorizontalScrollPositionDelta()
method.
Subclasses that rely on the default implementation of
getHorizontalScrollPositionDelta()
should override this method to
provide an accurate bounding rectangle that has valid left
and
right
properties.
By default this method returns a Rectangle with width=1, height=0,
whose left edge is one less than the left edge of the scrollRect
,
and top=0.
매개 변수
scrollRect:Rectangle — The target's scrollRect.
|
Rectangle — The bounds of the first element that spans or is to
the left of the scrollRect's left edge.
|
관련 API 요소
getElementBoundsRightOfScrollRect | () | 메서드 |
protected function getElementBoundsRightOfScrollRect(scrollRect:Rectangle):Rectangle
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the bounds of the first layout element that either spans or is to the right of the scrollRect's right edge.
This is a convenience method that is used by the default
implementation of the getHorizontalScrollPositionDelta()
method.
Subclasses that rely on the default implementation of
getHorizontalScrollPositionDelta()
should override this method to
provide an accurate bounding rectangle that has valid left
and
right
properties.
By default this method returns a Rectangle with width=1, height=0,
whose right edge is one more than the right edge of the scrollRect
,
and top=0.
매개 변수
scrollRect:Rectangle — The target's scrollRect.
|
Rectangle — The bounds of the first element that spans or is to
the right of the scrollRect's right edge.
|
관련 API 요소
getHorizontalScrollPositionDelta | () | 메서드 |
public function getHorizontalScrollPositionDelta(navigationUnit:uint):Number
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the change to the horizontal scroll position to handle
different scrolling options.
These options are defined by the NavigationUnit class: END
, HOME
,
LEFT
, PAGE_LEFT
, PAGE_RIGHT
, and RIGHT
.
매개 변수
navigationUnit:uint — Takes the following values:
The implementation calls |
Number — The change to the horizontal scroll position.
|
관련 API 요소
getNavigationDestinationIndex | () | 메서드 |
public function getNavigationDestinationIndex(currentIndex:int, navigationUnit:uint, arrowKeysWrapFocus:Boolean):int
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Delegation method that determines which item to navigate to based on the current item in focus and user input in terms of NavigationUnit. This method is used by subclasses of ListBase to handle keyboard navigation. ListBase maps user input to NavigationUnit constants.
Subclasses can override this method to compute other values that are based on the current index and key stroke encountered.
매개 변수
currentIndex:int — The current index of the item with focus.
| |
navigationUnit:uint — The NavigationUnit constant that determines
which item to navigate to next.
| |
arrowKeysWrapFocus:Boolean — If true , using arrow keys to
navigate within the component wraps when it hits either end.
|
int — The index of the next item to jump to. Returns -1
when if the layout doesn't recognize the navigationUnit.
|
getScrollPositionDeltaToElement | () | 메서드 |
public function getScrollPositionDeltaToElement(index:int):Point
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Computes the verticalScrollPosition
and
horizontalScrollPosition
deltas needed to
scroll the element at the specified index into view.
This method attempts to minimize the change to verticalScrollPosition
and horizontalScrollPosition
.
If clipAndEnableScrolling
is true
and the element at the specified index is not
entirely visible relative to the target's scroll rectangle, then
return the delta to be added to horizontalScrollPosition
and
verticalScrollPosition
that scrolls the element completely
within the scroll rectangle's bounds.
매개 변수
index:int — The index of the element to be scrolled into view.
|
Point — A Point that contains offsets to horizontalScrollPosition
and verticalScrollPosition that will scroll the specified
element into view, or null if no change is needed.
If the specified element is partially visible and larger than the
scroll rectangle, meaning it is already the only element visible, then
return null.
If the specified index is invalid, or target is null, then
return null.
If the element at the specified index is null or includeInLayout
false, then return null.
|
관련 API 요소
getScrollRect | () | 메서드 |
protected function getScrollRect():Rectangle
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the bounds of the target's scroll rectangle in layout coordinates. Layout methods should not get the target's scroll rectangle directly.
반환값Rectangle — The bounds of the target's scrollRect in layout coordinates, null
if target or clipAndEnableScrolling is false.
|
getVerticalScrollPositionDelta | () | 메서드 |
public function getVerticalScrollPositionDelta(navigationUnit:uint):Number
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Returns the change to the vertical scroll position to handle
different scrolling options.
These options are defined by the NavigationUnit class:
DOWN
, END
, HOME
,
PAGE_DOWN
, PAGE_UP
, and UP
.
매개 변수
navigationUnit:uint — Takes the following values:
PAGE_UP The implementation calls |
Number — The change to the vertical scroll position.
|
관련 API 요소
hideDropIndicator | () | 메서드 |
public function hideDropIndicator():void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Hides the previously shown drop indicator,
created by the showDropIndicator()
method,
removes it from the display list and also stops the drag scrolling.
관련 API 요소
measure | () | 메서드 |
public function measure():void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Measures the target's default size based on its content, and optionally measures the target's default minimum size.
This is one of the methods that you must override when creating a
subclass of LayoutBase. The other method is updateDisplayList()
.
You do not call these methods directly. Flex calls this method as part
of a layout pass. A layout pass consists of three phases.
First, if the target's properties are invalid, the LayoutManager calls
the target's commitProperties
method.
Second, if the target's size is invalid, LayoutManager calls the target's
validateSize()
method. The target's validateSize()
will in turn call the layout's measure()
to calculate the
target's default size unless it was explicitly specified by both target's
explicitWidth
and explicitHeight
properties.
If the default size changes, Flex will invalidate the target's display list.
Last, if the target's display list is invalid, LayoutManager calls the target's
validateDisplayList
. The target's validateDisplayList
will in turn call the layout's updateDisplayList
method to
size and position the target's elements.
When implementing this method, you must set the target's
measuredWidth
and measuredHeight
properties
to define the target's default size. You may optionally set the
measuredMinWidth
and measuredMinHeight
properties to define the default minimum size.
A typical implementation iterates through the target's elements
and uses the methods defined by the ILayoutElement
to
accumulate the preferred and/or minimum sizes of the elements and then sets
the target's measuredWidth
, measuredHeight
,
measuredMinWidth
and measuredMinHeight
.
관련 API 요소
scrollPositionChanged | () | 메서드 |
protected function scrollPositionChanged():void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Called when the verticalScrollPosition
or
horizontalScrollPosition
properties change.
The default implementation updates the target's scrollRect
property by
calling updateScrollRect()
.
Subclasses can override this method to compute other values that are
based on the current scrollPosition
or scrollRect
.
관련 API 요소
showDropIndicator | () | 메서드 |
public function showDropIndicator(dropLocation:DropLocation):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Sizes, positions and parents the drop indicator based on the specified
drop location. Use the calculateDropLocation()
method
to obtain the DropLocation object.
Starts/stops drag-scrolling when necessary conditions are met.
매개 변수
dropLocation:DropLocation — Specifies the location where to show the drop indicator.
Drop location is obtained through the computeDropLocation() method.
|
관련 API 요소
updateDisplayList | () | 메서드 |
public function updateDisplayList(width:Number, height:Number):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Sizes and positions the target's elements.
This is one of the methods that you must override when creating a
subclass of LayoutBase. The other method is measure()
.
You do not call these methods directly. Flex calls this method as part
of a layout pass. A layout pass consists of three phases.
First, if the target's properties are invalid, the LayoutManager calls
the target's commitProperties
method.
Second, if the target's size is invalid, LayoutManager calls the target's
validateSize()
method. The target's validateSize()
will in turn call the layout's measure()
to calculate the
target's default size unless it was explicitly specified by both target's
explicitWidth
and explicitHeight
properties.
If the default size changes, Flex will invalidate the target's display list.
Last, if the target's display list is invalid, LayoutManager calls the target's
validateDisplayList
. The target's validateDisplayList
will in turn call the layout's updateDisplayList
method to
size and position the target's elements.
A typical implementation iterates through the target's elements
and uses the methods defined by the ILayoutElement
to
position and resize the elements. Then the layout must also calculate and set
the target's contentWidth
and contentHeight
properties to define the target's scrolling region.
매개 변수
width:Number — Specifies the width of the target, in pixels,
in the targets's coordinates.
| |
height:Number — Specifies the height of the component, in pixels,
in the target's coordinates.
|
관련 API 요소
updateScrollRect | () | 메서드 |
public function updateScrollRect(w:Number, h:Number):void
언어 버전: | ActionScript 3.0 |
제품 버전: | Flex 4 |
런타임 버전: | Flash Player 10, AIR 1.5 |
Called by the target at the end of its updateDisplayList
to have the layout update its scrollRect.
If clipAndEnableScrolling
is true
,
the default implementation sets the origin of the target's scrollRect
to verticalScrollPosition
, horizontalScrollPosition
.
It sets its size to the width
, height
parameters (the target's unscaled width and height).
If clipAndEnableScrolling
is false
,
the default implementation sets the scrollRect
to null.
매개 변수
w:Number — The target's width.
| |
h:Number — The target's height.
|
관련 API 요소
Tue Jun 12 2018, 03:17 PM Z