Pacchetto | mx.core |
Interfaccia | public interface ITextInput extends IDataRenderer , IDropInListItemRenderer , IFocusManagerComponent , IFontContextComponent , IIMESupport , IListItemRenderer , IUIComponent , IInvalidating , IStyleClient , IEventDispatcher , IFlexDisplayObject , ILayoutManagerClient , ISimpleStyleClient , IFlexDisplayObject , ISimpleStyleClient , IBitmapDrawable |
Implementatori | MXFTETextInput, TextInput |
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Proprietà | Definito da | ||
---|---|---|---|
accessibilityProperties : AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione. | IFlexDisplayObject | ||
alpha : Number
Indica il valore della trasparenza alfa dell'oggetto specificato. | IFlexDisplayObject | ||
baselinePosition : Number [sola lettura]
The y-coordinate of the baseline
of the first line of text of the component. | IUIComponent | ||
blendMode : String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare. | IFlexDisplayObject | ||
cacheAsBitmap : Boolean
Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione. | IFlexDisplayObject | ||
className : String [sola lettura]
The name of the component class. | IStyleClient | ||
data : Object
The data to render or edit. | IDataRenderer | ||
document : Object
A reference to the document object associated with this component. | IUIComponent | ||
editable : Boolean
Indicates whether the user is allowed to edit the text in this control. | ITextInput | ||
enabled : Boolean
Whether the component can accept user interaction. | IUIComponent | ||
enableIME : Boolean [sola lettura]
Specifies whether the IME should be enabled when
this component has focus. | IIMESupport | ||
explicitHeight : Number
The explicitly specified height for the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxHeight : Number [sola lettura]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMaxWidth : Number [sola lettura]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinHeight : Number [sola lettura]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitMinWidth : Number [sola lettura]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
explicitWidth : Number
The explicitly specified width for the component,
in pixels, as the component's coordinates. | IUIComponent | ||
filters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. | IFlexDisplayObject | ||
focusEnabled : Boolean
A flag that indicates whether the component can receive focus when selected. | IFocusManagerComponent | ||
focusPane : Sprite
A single Sprite object that is shared among components
and used as an overlay for drawing the focus indicator. | IUIComponent | ||
fontContext : IFlexModuleFactory
The module factory that provides the font context for this component. | IFontContextComponent | ||
hasFocusableChildren : Boolean
A flag that indicates whether child objects can receive focus. | IFocusManagerComponent | ||
height : Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel. | IFlexDisplayObject | ||
horizontalScrollPosition : Number
Pixel position in the content area of the leftmost pixel
that is currently displayed. | ITextInput | ||
imeMode : String
The IME mode of the component. | IIMESupport | ||
includeInLayout : Boolean
Specifies whether this component is included in the layout of the
parent container. | IUIComponent | ||
inheritingStyles : Object
An object containing the inheritable styles for this component. | IStyleClient | ||
initialized : Boolean
A flag that determines if an object has been through all three phases
of layout validation (provided that any were required)
This flag should only be modified by the LayoutManager. | ILayoutManagerClient | ||
isPopUp : Boolean
Set to true by the PopUpManager to indicate
that component has been popped up. | IUIComponent | ||
listData : BaseListData
Implements the listData property
using setter and getter methods. | IDropInListItemRenderer | ||
loaderInfo : LoaderInfo [sola lettura]
Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene. | IFlexDisplayObject | ||
mask : DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato. | IFlexDisplayObject | ||
maxChars : int
Maximum number of characters that users can enter in the text field. | ITextInput | ||
maxHeight : Number [sola lettura]
Number that specifies the maximum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
maxWidth : Number [sola lettura]
Number that specifies the maximum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
measuredHeight : Number [sola lettura]
The measured height of this object. | IFlexDisplayObject | ||
measuredMinHeight : Number
The default minimum height of the component, in pixels. | IUIComponent | ||
measuredMinWidth : Number
The default minimum width of the component, in pixels. | IUIComponent | ||
measuredWidth : Number [sola lettura]
The measured width of this object. | IFlexDisplayObject | ||
minHeight : Number [sola lettura]
Number that specifies the minimum height of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
minWidth : Number [sola lettura]
Number that specifies the minimum width of the component,
in pixels, as the component's coordinates. | IUIComponent | ||
mouseChildren : Boolean
Determina se gli elementi secondari dell'oggetto sono abilitati o meno per il mouse o per il dispositivo di input dell'utente. | ITextInput | ||
mouseEnabled : Boolean
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. | ITextInput | ||
mouseFocusEnabled : Boolean [sola lettura]
A flag that indicates whether the component can receive focus
when selected with the mouse. | IFocusManagerComponent | ||
mouseX : Number [sola lettura]
Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | IFlexDisplayObject | ||
mouseY : Number [sola lettura]
Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | IFlexDisplayObject | ||
name : String
Indica il nome dell'istanza dell'oggetto DisplayObject. | IFlexDisplayObject | ||
nestLevel : int
The top-level SystemManager has a nestLevel of 1. | ILayoutManagerClient | ||
nonInheritingStyles : Object
An object containing the noninheritable styles for this component. | IStyleClient | ||
opaqueBackground : Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo. | IFlexDisplayObject | ||
owner : DisplayObjectContainer
The owner of this IVisualElement object. | IUIComponent | ||
parent : DisplayObjectContainer [sola lettura]
Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione. | IFlexDisplayObject | ||
parentDrawsFocus : Boolean
If true, calls to this control's drawFocus() method are forwarded
to its parent's drawFocus() method. | ITextInput | ||
percentHeight : Number
Number that specifies the height of a component as a
percentage of its parent's size. | IUIComponent | ||
percentWidth : Number
Number that specifies the width of a component as a
percentage of its parent's size. | IUIComponent | ||
processedDescriptors : Boolean
Set to true after immediate or deferred child creation,
depending on which one happens. | ILayoutManagerClient | ||
restrict : String
Indicates the set of characters that a user can enter into the control. | ITextInput | ||
root : DisplayObject [sola lettura]
Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà principale è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF. | IFlexDisplayObject | ||
rotation : Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale. | IFlexDisplayObject | ||
scale9Grid : Rectangle
La griglia di modifica in scala attualmente attiva. | IFlexDisplayObject | ||
scaleX : Number
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione. | IFlexDisplayObject | ||
scaleY : Number
Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | IFlexDisplayObject | ||
scrollRect : Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione. | IFlexDisplayObject | ||
selectable : Boolean
A flag indicating whether the text in the TextInput can be selected. | ITextInput | ||
selectionActivePosition : int [sola lettura]
The zero-based index of the position after the last character
in the current selection (equivalent to the one-based index of the last
character). | ITextInput | ||
selectionAnchorPosition : int [sola lettura]
The zero-based character index value of the first character
in the current selection. | ITextInput | ||
stage : Stage [sola lettura]
Lo stage dell'oggetto di visualizzazione. | IFlexDisplayObject | ||
styleDeclaration : CSSStyleDeclaration
The style declaration that holds the inline styles declared by this
object. | IStyleClient | ||
styleName : Object
The source of this object's style values. | ISimpleStyleClient | ||
systemManager : ISystemManager
A reference to the SystemManager object for this component. | IUIComponent | ||
tabFocusEnabled : Boolean [sola lettura]
A flag that indicates whether pressing the Tab key eventually
moves focus to this component. | IFocusManagerComponent | ||
tabIndex : int
If tabFocusEnabled, the order in which the component receives focus. | IFocusManagerComponent | ||
text : String
Plain text that appears in the control. | ITextInput | ||
transform : flash.geom:Transform
Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione. | IFlexDisplayObject | ||
tweeningProperties : Array
Used by EffectManager. | IUIComponent | ||
updateCompletePendingFlag : Boolean
A flag that determines if an object is waiting to have its
updateComplete event dispatched. | ILayoutManagerClient | ||
visible : Boolean
Determina se l'oggetto di visualizzazione è visibile o meno. | IFlexDisplayObject | ||
width : Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel. | IFlexDisplayObject | ||
x : Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | IFlexDisplayObject | ||
y : Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | IFlexDisplayObject |
Metodo | Definito da | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | IEventDispatcher | ||
Deletes a style property from this component instance. | IStyleClient | ||
Invia un evento nel flusso di eventi. | IEventDispatcher | ||
Called by the FocusManager when the component receives focus. | IFocusManagerComponent | ||
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. | IFlexDisplayObject | ||
Returns an Array of CSSStyleDeclaration objects for the type selector
that applies to this component, or null if none exist. | IStyleClient | ||
A convenience method for determining whether to use the
explicit or measured height
| IUIComponent | ||
A convenience method for determining whether to use the
explicit or measured width
| IUIComponent | ||
Restituisce un rettangolo che definisce i bordi dell'oggetto di visualizzazione in base al sistema di coordinate definito dal parametro targetCoordinateSpace, esclusi gli eventuali tratti presenti sulle forme. | IFlexDisplayObject | ||
Gets a style property that has been set anywhere in this
component's style lookup chain. | IStyleClient | ||
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point. | IFlexDisplayObject | ||
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | IEventDispatcher | ||
Valuta il riquadro di delimitazione dell'oggetto di visualizzazione per verificare se si sovrappone o si interseca con il riquadro di delimitazione dell'oggetto di visualizzazione obj. | IFlexDisplayObject | ||
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y. | IFlexDisplayObject | ||
Initialize the object. | IUIComponent | ||
Calling this method results in a call to the component's
validateDisplayList() method
before the display list is rendered. | IInvalidating | ||
Calling this method results in a call to the component's
validateProperties() method
before the display list is rendered. | IInvalidating | ||
Calling this method results in a call to the component's
validateSize() method
before the display list is rendered. | IInvalidating | ||
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point. | IFlexDisplayObject | ||
Moves this object to the specified x and y coordinates. | IFlexDisplayObject | ||
Propagates style changes to the children of this component. | IStyleClient | ||
Returns true if the chain of owner properties
points from child to this UIComponent. | IUIComponent | ||
Called by Flex when a UIComponent object is added to or removed from a parent. | IUIComponent | ||
Sets up the internal style cache values so that the getStyle()
method functions. | IStyleClient | ||
Registers the EffectManager as one of the event listeners for each effect event. | IStyleClient | ||
Rimuove un listener dall'oggetto EventDispatcher. | IEventDispatcher | ||
Selects the text in the range specified by the parameters. | ITextInput | ||
Sets the actual size of this object. | IFlexDisplayObject | ||
Called by the FocusManager when the component receives focus. | IFocusManagerComponent | ||
Sets a style property on this component instance. | IStyleClient | ||
Called when the visible property changes. | IUIComponent | ||
Determines whether the border and background of the TextInput are
visible. | ITextInput | ||
Called when the value of a style property is changed. | ISimpleStyleClient | ||
Validates the position and size of children and draws other
visuals. | ILayoutManagerClient | ||
Validates and updates the properties and layout of this object
by immediately calling validateProperties(),
validateSize(), and validateDisplayList(),
if necessary. | IInvalidating | ||
Validates the properties of a component. | ILayoutManagerClient | ||
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. | ILayoutManagerClient | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | IEventDispatcher |
editable | proprietà |
editable:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Indicates whether the user is allowed to edit the text in this control.
If true
, the user can edit the text.
Il valore predefinito è true.
Implementazione
public function get editable():Boolean
public function set editable(value:Boolean):void
horizontalScrollPosition | proprietà |
horizontalScrollPosition:Number
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Pixel position in the content area of the leftmost pixel
that is currently displayed.
(The content area includes all contents of a control, not just
the portion that is currently displayed.)
This property is always set to 0, and ignores changes,
if wordWrap
is set to true
.
Il valore predefinito è 0.
Implementazione
public function get horizontalScrollPosition():Number
public function set horizontalScrollPosition(value:Number):void
maxChars | proprietà |
maxChars:int
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Maximum number of characters that users can enter in the text field.
This property does not limit the length of text specified by the
setting the control's text
or htmlText
property.
The default value is 0, which is a special case meaning an unlimited number.
Implementazione
public function get maxChars():int
public function set maxChars(value:int):void
mouseChildren | proprietà |
mouseChildren:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Determina se gli elementi secondari dell'oggetto sono abilitati o meno per il mouse o per il dispositivo di input dell'utente. Se un oggetto è abilitato, l'utente può interagire con esso mediante il mouse o il dispositivo di input dell'utente. Il valore predefinito è true
.
Questa proprietà è utile quando create un pulsante con un'istanza della classe Sprite (anziché utilizzare la classe SimpleButton). Quando usate un'istanza Sprite per creare un pulsante, potete scegliere di decorare il pulsante utilizzando il metodo addChild()
per aggiungere ulteriori istanze Sprite. Questo processo può produrre un comportamento imprevisto degli eventi del mouse perché le istanze Sprite che aggiungete come elementi secondari possono diventare l'oggetto target di un evento mouse invece dell'istanza principale. Per fare sì che solo l'istanza principale possa essere l'oggetto target degli eventi del mouse, potete impostare la proprietà mouseChildren
dell'istanza principale su false
.
Nessun evento viene inviato impostando questa proprietà. Dovete utilizzare il metodo addEventListener()
per creare la funzionalità interattiva.
Implementazione
public function get mouseChildren():Boolean
public function set mouseChildren(value:Boolean):void
mouseEnabled | proprietà |
mouseEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. Il valore predefinito è true
e indica che, per impostazione predefinita, qualunque istanza InteractiveObject inclusa nell'elenco di visualizzazione riceve gli eventi del mouse o di altri dispositivi di input dell'utente. Se mouseEnabled
è impostato su false
, l'istanza non riceve alcun evento del mouse (o altri eventi di input dell'utente quali gli eventi della tastiera). L'impostazione non influisce sugli eventuali elementi secondari dell'istanza presenti nell'elenco di visualizzazione. Per cambiare il comportamento mouseEnabled
di tutti gli elementi secondari di un oggetto dell'elenco di visualizzazione, utilizzate flash.display.DisplayObjectContainer.mouseChildren
.
Nessun evento viene inviato impostando questa proprietà. Dovete utilizzare il metodo addEventListener()
per creare la funzionalità interattiva.
Implementazione
public function get mouseEnabled():Boolean
public function set mouseEnabled(value:Boolean):void
parentDrawsFocus | proprietà |
parentDrawsFocus:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
If true, calls to this control's drawFocus()
method are forwarded
to its parent's drawFocus()
method.
This is used when a TextInput is part of a composite control
like NumericStepper or ComboBox;
Il valore predefinito è false.
Implementazione
public function get parentDrawsFocus():Boolean
public function set parentDrawsFocus(value:Boolean):void
restrict | proprietà |
restrict:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Indicates the set of characters that a user can enter into the control.
If the value of the restrict
property is null
,
you can enter any character. If the value of the restrict
property is an empty string, you cannot enter any character.
This property only restricts user interaction; a script
can put any text into the text field. If the value of
the restrict
property is a string of characters,
you may enter only characters in that string into the
text field.
Flex scans the string from left to right. You can specify a range by using the hyphen (-) character. If the string begins with a caret (^) character, all characters are initially accepted and succeeding characters in the string are excluded from the set of accepted characters. If the string does not begin with a caret (^) character, no characters are initially accepted and succeeding characters in the string are included in the set of accepted characters.
Because some characters have a special meaning when used
in the restrict
property, you must use
backslash characters to specify the literal characters -, ^, and \.
When you use the restrict
property as an attribute
in an MXML tag, use single backslashes, as in the following
example: \^\-\\.
When you set the restrict
In and ActionScript expression,
use double backslashes, as in the following example: \\^\\-\\\.
Il valore predefinito è null.
Implementazione
public function get restrict():String
public function set restrict(value:String):void
Elementi API correlati
selectable | proprietà |
selectionActivePosition | proprietà |
selectionActivePosition:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
The zero-based index of the position after the last character
in the current selection (equivalent to the one-based index of the last
character).
If the last character in the selection, for example, is the fifth
character, this property has the value 5.
When the control gets the focus, the selection is visible if the
selectionAnchorIndex
and selectionActiveIndex
properties are both set.
Il valore predefinito è 0.
Implementazione
public function get selectionActivePosition():int
selectionAnchorPosition | proprietà |
selectionAnchorPosition:int
[sola lettura] Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
The zero-based character index value of the first character
in the current selection.
For example, the first character is 0, the second character is 1,
and so on.
When the control gets the focus, the selection is visible if the
selectionAnchorIndex
and selectionActiveIndex
properties are both set.
Il valore predefinito è 0.
Implementazione
public function get selectionAnchorPosition():int
text | proprietà |
text:String
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Plain text that appears in the control. Its appearance is determined by the CSS styles of this Label control.
Any HTML tags in the text string are ignored,
and appear as entered in the string.
To display text formatted using HTML tags,
use the htmlText
property instead.
If you set the htmlText
property,
the HTML replaces any text you had set using this propety, and the
text
property returns a plain-text version of the
HTML text, with all HTML tags stripped out. For more information
see the htmlText
property.
To include the special characters left angle bracket (<),
right angle bracket (>), or ampersand (&) in the text,
wrap the text string in the CDATA tag.
Alternatively, you can use HTML character entities for the
special characters, for example, <
.
If you try to set this property to null
,
it is set, instead, to the empty string.
The text
property can temporarily have the value null
,
which indicates that the htmlText
has been recently set
and the corresponding text
value
has not yet been determined.
Il valore predefinito è "".
Implementazione
public function get text():String
public function set text(value:String):void
selectRange | () | metodo |
public function selectRange(anchorPosition:int, activePosition:int):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Selects the text in the range specified by the parameters.
Parametri
anchorPosition:int — The zero-based character index value
of the first character in the current selection.
| |
activePosition:int — The zero-based index of the position
after the last character in the current selection
(equivalent to the one-based index of the last character).
|
showBorderAndBackground | () | metodo |
public function showBorderAndBackground(visible:Boolean):void
Versione linguaggio: | ActionScript 3.0 |
Versione prodotto: | Flex 4 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Determines whether the border and background of the TextInput are visible.
Parametri
visible:Boolean — true if visible, and false if not.
|
Tue Jun 12 2018, 02:44 PM Z