Package | mx.controls |
Class | public class LinkButton |
Inheritance | LinkButton ![]() ![]() ![]() ![]() |
Language Version : | ActionScript 3.0 |
Product Version : | Flex 3 |
Runtime Versions : | Flash Player 9, AIR 1.1 |
click
event handler,
as you do with a Button control.
The LinkButton control has the following default characteristics:
Characteristic | Description |
---|---|
Default size | Width and height large enough for the text |
Minimum size | 0 pixels |
Maximum size | Undefined |
The <mx:LinkButton>
tag inherits all of the tag attributes
of its superclass, and adds the following tag attributes:
<mx:LinkButton Styles cornerRadius="4"" rollOverColor="0xEEFEE6" selectionColor="0xB7F39B" textRollOverColor="0x2B333C" textSelectedColor="0x2B333C" />
See also
Method | Defined By | ||
---|---|---|---|
Constructor. | LinkButton | ||
![]() | addStyleClient(styleClient:IAdvancedStyleClient):void
Adds a non-visual style client to this component instance. | UIComponent | |
![]() | callLater(method:Function, args:Array = null):void
Queues a function to be called later. | UIComponent | |
![]() | clearStyle(styleProp:String):void
Deletes a style property from this component instance. | UIComponent | |
![]() | contentToGlobal(point:Point):Point
Converts a Point object from content coordinates to global coordinates. | UIComponent | |
![]() | contentToLocal(point:Point):Point
Converts a Point object from content to local coordinates. | UIComponent | |
![]() | createAutomationIDPart(child:IAutomationObject):Object
Returns a set of properties that identify the child within
this container. | UIComponent | |
![]() | createAutomationIDPartWithRequiredProperties(child:IAutomationObject, properties:Array):Object
Returns a set of properties as automation IDs that identify the child within
this container. | UIComponent | |
![]() | createReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void
Creates an id reference to this IUIComponent object
on its parent document object. | UIComponent | |
![]() | deleteReferenceOnParentDocument(parentDocument:IFlexDisplayObject):void
Deletes the id reference to this IUIComponent object
on its parent document object. | UIComponent | |
![]() |
Returns a UITextFormat object corresponding to the text styles
for this UIComponent. | UIComponent | |
![]() | dispatchEvent(event:Event):Boolean [override]
Dispatches an event into the event flow. | UIComponent | |
![]() | drawFocus(isFocused:Boolean):void
Shows or hides the focus indicator around this component. | UIComponent | |
![]() | drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
Programmatically draws a rectangle into this skin's Graphics object. | UIComponent | |
![]() | effectFinished(effectInst:IEffectInstance):void
Called by the effect instance when it stops playing on the component. | UIComponent | |
![]() | effectStarted(effectInst:IEffectInstance):void
Called by the effect instance when it starts playing on the component. | UIComponent | |
![]() | endEffectsStarted():void
Ends all currently playing effects on the component. | UIComponent | |
![]() | executeBindings(recurse:Boolean = false):void
Executes all the bindings for which the UIComponent object is the destination. | UIComponent | |
![]() | finishPrint(obj:Object, target:IFlexDisplayObject):void
Called after printing is complete. | UIComponent | |
![]() | getAutomationChildAt(index:int):IAutomationObject
Provides the automation object at the specified index. | UIComponent | |
![]() | getAutomationChildren():Array
Provides the automation object list . | UIComponent | |
![]() | getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number
Returns the x coordinate of the element's bounds at the specified element size. | UIComponent | |
![]() | getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number
Returns the y coordinate of the element's bounds at the specified element size. | UIComponent | |
![]() | getClassStyleDeclarations():Array
Finds the type selectors for this UIComponent instance. | UIComponent | |
![]() | getConstraintValue(constraintName:String):*
Returns a layout constraint value, which is the same as
getting the constraint style for this component. | UIComponent | |
![]() | getExplicitOrMeasuredHeight():Number
A convenience method for determining whether to use the
explicit or measured height
| UIComponent | |
![]() | getExplicitOrMeasuredWidth():Number
A convenience method for determining whether to use the
explicit or measured width
| UIComponent | |
![]() | getFocus():InteractiveObject
Gets the object that currently has focus. | UIComponent | |
![]() | getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number
Returns the element's layout height. | UIComponent | |
![]() | getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number
Returns the element's layout width. | UIComponent | |
![]() | getLayoutBoundsX(postLayoutTransform:Boolean = true):Number
Returns the x coordinate that the element uses to draw on screen. | UIComponent | |
![]() | getLayoutBoundsY(postLayoutTransform:Boolean = true):Number
Returns the y coordinate that the element uses to draw on screen. | UIComponent | |
![]() | getLayoutMatrix():Matrix
Returns the transform matrix that is used to calculate the component's
layout relative to its siblings. | UIComponent | |
![]() | getLayoutMatrix3D():Matrix3D
Returns the layout transform Matrix3D for this element. | UIComponent | |
![]() | getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number
Returns the element's maximum height. | UIComponent | |
![]() | getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number
Returns the element's maximum width. | UIComponent | |
![]() | getMinBoundsHeight(postLayoutTransform:Boolean = true):Number
Returns the element's minimum height. | UIComponent | |
![]() | getMinBoundsWidth(postLayoutTransform:Boolean = true):Number
Returns the element's minimum width. | UIComponent | |
![]() | getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number
Returns the element's preferred height. | UIComponent | |
![]() | getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number
Returns the element's preferred width. | UIComponent | |
![]() | getRepeaterItem(whichRepeater:int = -1):Object
Returns the item in the dataProvider that was used
by the specified Repeater to produce this Repeater, or
null if this Repeater isn't repeated. | UIComponent | |
![]() | getStyle(styleProp:String):*
Gets a style property that has been set anywhere in this
component's style lookup chain. | UIComponent | |
![]() | globalToContent(point:Point):Point
Converts a Point object from global to content coordinates. | UIComponent | |
![]() | hasCSSState():Boolean
Returns true if currentCSSState is not null. | UIComponent | |
![]() | hasState(stateName:String):Boolean
Determines whether the specified state has been defined on this
UIComponent. | UIComponent | |
![]() | horizontalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix
Returns a box Matrix which can be passed to the
drawRoundRect() method
as the rot parameter when drawing a horizontal gradient. | UIComponent | |
![]() | initialize():void
Initializes the internal structure of this component. | UIComponent | |
![]() | initializeRepeaterArrays(parent:IRepeaterClient):void
Initializes various properties which keep track of repeated instances
of this component. | UIComponent | |
![]() | invalidateDisplayList():void
Marks a component so that its updateDisplayList()
method gets called during a later screen update. | UIComponent | |
![]() | invalidateLayering():void
Called by a component's items to indicate that their depth
property has changed. | UIComponent | |
![]() | invalidateLayoutDirection():void
An element must call this method when its layoutDirection changes or
when its parent's layoutDirection changes. | UIComponent | |
![]() | invalidateProperties():void
Marks a component so that its commitProperties()
method gets called during a later screen update. | UIComponent | |
![]() | invalidateSize():void
Marks a component so that its measure()
method gets called during a later screen update. | UIComponent | |
![]() | localToContent(point:Point):Point
Converts a Point object from local to content coordinates. | UIComponent | |
![]() | matchesCSSState(cssState:String):Boolean
Returns true if cssState matches currentCSSState. | UIComponent | |
![]() | matchesCSSType(cssType:String):Boolean
Determines whether this instance is the same as, or is a subclass of,
the given type. | UIComponent | |
![]() | measureHTMLText(htmlText:String):TextLineMetrics
Measures the specified HTML text, which can contain HTML tags such
as <font> and <b>,
assuming that it is displayed
in a single-line UITextField using a UITextFormat
determined by the styles of this UIComponent. | UIComponent | |
![]() | measureText(text:String):TextLineMetrics
Measures the specified text, assuming that it is displayed
in a single-line UITextField (or UIFTETextField) using a UITextFormat
determined by the styles of this UIComponent. | UIComponent | |
![]() | move(x:Number, y:Number):void
Moves the component to a specified position within its parent. | UIComponent | |
![]() | notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void
Propagates style changes to the children. | UIComponent | |
![]() | owns(child:DisplayObject):Boolean
Returns true if the chain of owner properties
points from child to this UIComponent. | UIComponent | |
![]() | parentChanged(p:DisplayObjectContainer):void
Called by Flex when a UIComponent object is added to or removed from a parent. | UIComponent | |
![]() | prepareToPrint(target:IFlexDisplayObject):Object
Prepares an IFlexDisplayObject for printing. | UIComponent | |
![]() | regenerateStyleCache(recursive:Boolean):void
Builds or rebuilds the CSS style cache for this component
and, if the recursive parameter is true,
for all descendants of this component as well. | UIComponent | |
![]() | registerEffects(effects:Array):void
For each effect event, registers the EffectManager
as one of the event listeners. | UIComponent | |
![]() | removeStyleClient(styleClient:IAdvancedStyleClient):void
Removes a non-visual style client from this component instance. | UIComponent | |
![]() | replayAutomatableEvent(event:Event):Boolean
Replays the specified event. | UIComponent | |
![]() | resolveAutomationIDPart(criteria:Object):Array
Resolves a child by using the id provided. | UIComponent | |
![]() | resumeBackgroundProcessing():void [static]
Resumes the background processing of methods
queued by callLater(), after a call to
suspendBackgroundProcessing(). | UIComponent | |
![]() | setActualSize(w:Number, h:Number):void
Sizes the object. | UIComponent | |
![]() | setConstraintValue(constraintName:String, value:*):void
Sets a layout constraint value, which is the same as
setting the constraint style for this component. | UIComponent | |
![]() | setCurrentState(stateName:String, playTransition:Boolean = true):void
Set the current state. | UIComponent | |
![]() | setFocus():void
Sets the focus to this component. | UIComponent | |
![]() | setLayoutBoundsPosition(x:Number, y:Number, postLayoutTransform:Boolean = true):void
Sets the coordinates that the element uses to draw on screen. | UIComponent | |
![]() | setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void
Sets the layout size of the element. | UIComponent | |
![]() | setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void
Sets the transform Matrix that is used to calculate the component's layout
size and position relative to its siblings. | UIComponent | |
![]() | setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void
Sets the transform Matrix3D that is used to calculate the component's layout
size and position relative to its siblings. | UIComponent | |
![]() | setStyle(styleProp:String, newValue:*):void
Sets a style property on this component instance. | UIComponent | |
![]() | setVisible(value:Boolean, noEvent:Boolean = false):void
Called when the visible property changes. | UIComponent | |
![]() | styleChanged(styleProp:String):void
Detects changes to style properties. | UIComponent | |
![]() | stylesInitialized():void
Flex calls the stylesInitialized() method when
the styles for a component are first initialized. | UIComponent | |
![]() | suspendBackgroundProcessing():void [static]
Blocks the background processing of methods
queued by callLater(),
until resumeBackgroundProcessing() is called. | UIComponent | |
![]() | toString():String [override]
Returns a string indicating the location of this object
within the hierarchy of DisplayObjects in the Application. | FlexSprite | |
![]() | transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
A utility method to update the rotation, scale, and translation of the
transform while keeping a particular point, specified in the component's
own coordinate space, fixed in the parent's coordinate space. | UIComponent | |
![]() | transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void
A utility method to transform a point specified in the local
coordinates of this object to its location in the object's parent's
coordinates. | UIComponent | |
![]() | validateDisplayList():void
Validates the position and size of children and draws other
visuals. | UIComponent | |
![]() | validateNow():void
Validate and update the properties and layout of this object
and redraw it, if necessary. | UIComponent | |
![]() | validateProperties():void
Used by layout logic to validate the properties of a component
by calling the commitProperties() method. | UIComponent | |
![]() | validateSize(recursive:Boolean = false):void
Validates the measured size of the component
If the LayoutManager.invalidateSize() method is called with
this ILayoutManagerClient, then the validateSize() method
is called when it's time to do measurements. | UIComponent | |
![]() | validationResultHandler(event:ValidationResultEvent):void
Handles both the valid and invalid events from a
validator assigned to this component. | UIComponent | |
![]() | verticalGradientMatrix(x:Number, y:Number, width:Number, height:Number):Matrix
Returns a box Matrix which can be passed to drawRoundRect()
as the rot parameter when drawing a vertical gradient. | UIComponent |
Style | Description | Defined By | ||
---|---|---|---|---|
![]() | Type: uint Format: Color CSS Inheritance: yes Theme: spark Color applied to the button when the emphasized flag is true. | Button | ||
![]() | Type: String CSS Inheritance: no The vertical distance in pixels from the top edge of the content area to the control's baseline position. | UIComponent | ||
![]() | Type: String CSS Inheritance: no The vertical distance, in pixels, from the bottom edge of the component to the bottom edge of its parent container's content area. | UIComponent | ||
![]() | Type: uint Format: Color CSS Inheritance: yes Color of text in the component, including the component label. | Button | ||
cornerRadius | Type: Number Format: Length CSS Inheritance: no Corner radius of the highlighted rectangle around a LinkButton. The default value for the Halo theme is 4 .
The default value for the Spark theme is 2 .
| LinkButton | ||
![]() | Type: String CSS Inheritance: yes The directionality of the text displayed by the component. | Button | ||
![]() | Type: uint Format: Color CSS Inheritance: yes Color of text in the component if it is disabled. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the icon when the button is disabled and not selected. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the background and border when the button is not selected and is disabled. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the icon when the button is not selected and the mouse button is down. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the background and border when the button is not selected and the mouse button is down. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the button when the button is emphasized (such as when serving as the default button for a container). | Button | ||
![]() | Type: uint Format: Color CSS Inheritance: yes Color of the component highlight when validation fails. | UIComponent | ||
![]() | Type: Number CSS Inheritance: no Specifies the alpha transparency value of the focus skin. | Button | ||
![]() | Type: String CSS Inheritance: no Blend mode used by the focus rectangle. | UIComponent | ||
![]() | Type: uint Format: Color CSS Inheritance: yes Theme: spark Color of focus ring when the component is in focus. | Button | ||
![]() | Type: String CSS Inheritance: no Specifies which corners of the focus rectangle should be rounded. | Button | ||
![]() | Type: Class CSS Inheritance: no Skin used to draw the focus rectangle. | UIComponent | ||
![]() | Type: Number Format: Length CSS Inheritance: no Thickness, in pixels, of the focus rectangle outline. | UIComponent | ||
![]() | Type: String CSS Inheritance: yes Sets the antiAliasType property of internal TextFields.See also flash.text.TextField flash.text.AntiAliasType | Button | ||
![]() | Type: String CSS Inheritance: yes Name of the font to use. | Button | ||
![]() | Type: String CSS Inheritance: yes Sets the gridFitType property of internal TextFields that represent text in Flex controls.See also flash.text.TextField flash.text.GridFitType | Button | ||
![]() | Type: Number CSS Inheritance: yes Sets the sharpness property of internal TextFields that represent text in Flex controls.See also flash.text.TextField | Button | ||
![]() | Type: Number Format: Length CSS Inheritance: yes Height of the text, in pixels. | Button | ||
![]() | Type: String CSS Inheritance: yes Determines whether the text is italic font. | Button | ||
![]() | Type: Number CSS Inheritance: yes Sets the thickness property of internal TextFields that represent text in Flex controls.See also flash.text.TextField | Button | ||
![]() | Type: String CSS Inheritance: yes Determines whether the text is boldface. | Button | ||
![]() | Type: String CSS Inheritance: no The horizontal distance in pixels from the center of the component's content area to the center of the component. | UIComponent | ||
![]() | Type: Number Format: Length CSS Inheritance: no Gap between the label and icon, when the labelPlacement property is set to left or right . | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the default icon. | Button | ||
![]() | Type: String CSS Inheritance: yes The primary interaction mode for this component. See also | UIComponent | ||
![]() | Type: Boolean CSS Inheritance: yes A Boolean value that indicates whether kerning is enabled ( true ) or disabled (false ). | Button | ||
![]() | Type: Number Format: Length CSS Inheritance: no Number of pixels of vertical offset to apply to the label position. | Button | ||
![]() | Type: String CSS Inheritance: yes Specifies the desired layout direction of a component. See also | UIComponent | ||
![]() | Type: Number Format: Length CSS Inheritance: yes Additional vertical space between lines of text. | Button | ||
![]() | Type: String CSS Inheritance: no The horizontal distance, in pixels, from the left edge of the component to the left edge of its parent container's content area. | UIComponent | ||
![]() | Type: Number CSS Inheritance: yes The number of additional pixels to appear between each character. | Button | ||
![]() | Type: String CSS Inheritance: yes The locale of the text displayed by this component. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the icon when the button is not selected and the mouse is over the control. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the background and border when the button is not selected and the mouse is over the control. | Button | ||
![]() | Type: Number Format: Length CSS Inheritance: no Number of pixels between the component's bottom border and the bottom of its content area. | Button | ||
![]() | Type: Number Format: Length CSS Inheritance: no Number of pixels between the component's left border and the left edge of its content area. | Button | ||
![]() | Type: Number Format: Length CSS Inheritance: no Number of pixels between the component's right border and the right edge of its content area. | Button | ||
![]() | Type: Number Format: Length CSS Inheritance: no Number of pixels between the component's top border and the top of its content area. | Button | ||
![]() | Type: Number Format: Time CSS Inheritance: no Number of milliseconds to wait after the first buttonDown event before repeating buttonDown events at each repeatInterval . | Button | ||
![]() | Type: Number Format: Time CSS Inheritance: no Number of milliseconds between buttonDown events if the user presses and holds the mouse on a button. | Button | ||
![]() | Type: String CSS Inheritance: no The horizontal distance, in pixels, from the right edge of the component to the right edge of its parent container's content area. | UIComponent | ||
rollOverColor | Type: uint Format: Color CSS Inheritance: yes Color of a LinkButton as a user moves the mouse pointer over it. The default value for the Halo theme is 0xB2E1FF .
The default value for the Spark theme is 0xCEDBEF .
| LinkButton | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the icon when the button is selected and disabled. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the background and border when a toggle button is selected and disabled. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the icon when the button is selected and the mouse button is down. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the background and border when a toggle button is selected and the mouse button is down. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the icon when the button is selected and the mouse is over the control. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the background and border when a toggle button is selected and the mouse is over the control. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the icon when the button is selected and the mouse button is up. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the background and border when a toggle button is selected and the mouse is not over the control. | Button | ||
selectionColor | Type: uint Format: Color CSS Inheritance: yes Background color of a LinkButton as a user presses it. The default value for the Halo theme is 0x7FCEFF .
The default value for the Spark theme is 0xA8C6EE .
| LinkButton | ||
![]() | Type: Boolean CSS Inheritance: yes Show the error border or skin when this component is invalid. | UIComponent | ||
![]() | Type: Boolean CSS Inheritance: yes Show the error tip when this component is invalid and the user rolls over it. | UIComponent | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the default skin for the background and border. | Button | ||
![]() | Type: String CSS Inheritance: yes Alignment of text within a container. | Button | ||
![]() | Type: String CSS Inheritance: yes Determines whether the text is underlined. | Button | ||
![]() | Type: Class CSS Inheritance: no The class implementing IUITextField that is used by this component to render text. | Button | ||
![]() | Type: Number Format: Length CSS Inheritance: yes Offset of first line of text from the left side of the container, in pixels. | Button | ||
textRollOverColor | Type: uint Format: Color CSS Inheritance: yes Text color of a LinkButton as a user moves the mouse pointer over it. The default value for the Halo theme is 0x2B333C .
The default value for the Spark theme is 0x000000 .
| LinkButton | ||
textSelectedColor | Type: uint Format: Color CSS Inheritance: yes Text color of a LinkButton as a user presses it. The default value for the Halo theme is 0x2B333C .
The default value for the Spark theme is 0x000000 .
| LinkButton | ||
![]() | Type: uint Format: Color CSS Inheritance: yes Theme: halo Theme color of a component. | UIComponent | ||
![]() | Type: String CSS Inheritance: no The vertical distance, in pixels, from the top edge of the component to the top edge of its parent container's content area. | UIComponent | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the icon when a toggle button is not selected and the mouse is not over the button. | Button | ||
![]() | Type: Class CSS Inheritance: no Name of the class to use as the skin for the background and border when the button is not selected and the mouse is not over the control. | Button | ||
![]() | Type: String CSS Inheritance: no The vertical distance in pixels from the center of the component's content area to the center of the component. | UIComponent | ||
![]() | Type: Number Format: Length CSS Inheritance: no Gap between the button's label and icon when the labelPlacement property is set to "top" or "bottom" . | Button |