IContainer  - AS3 Flex

Specifica la modalità pulsante di questo sprite. Se è true, questo sprite si comporta come un pulsante, ovvero attiva la visualizzazione del cursore a forma di mano quando il puntatore passa sopra lo sprite. Può ricevere un evento click se viene premuto il tasto Invio o la barra spaziatrice quando lo sprite è l'elemento attivo. Potete annullare la visualizzazione del puntatore a forma di mano impostando la proprietà useHandCursor su false, in modo da visualizzare il puntatore standard.

Benché sia meglio utilizzare la classe SimpleButton per creare dei pulsanti, la proprietà buttonMode consente di conferire a uno sprite alcune caratteristiche simili a quelle di un pulsante. Per includere uno sprite nell'ordine di tabulazione, impostate la proprietà tabEnabled (ereditata dalla classe InteractiveObject e impostata sul valore predefinito false) su true. Inoltre, dovete scegliere se gli elementi secondari dello sprite devono essere abilitati per l'input dell'utente. La maggior parte dei pulsanti non abilita l'interattività con l'input dell'utente per gli elementi secondari, perché ciò ha l'effetto di confondere il flusso degli eventi. Per disabilitare l'interattività con l'input dell'utente per tutti gli oggetti secondari, dovete impostare la proprietà mouseChildren (ereditata dalla classe DisplayObjectContainer) su false.

Se utilizzate la proprietà buttonMode con la classe MovieClip (che è una sottoclasse di Sprite), il pulsante potrebbe presentare una funzionalità più estesa. Se includonote dei fotogrammi con le etichette _up, _over e _down, Flash Player fornisce le modifiche di stato automatiche (caratteristica simile a quella disponibile nelle versioni precedenti di ActionScript per i clip filmato utilizzati come pulsanti). Queste modifiche di stato automatiche non sono disponibili per gli sprite, che sono sprovvisti di linea temporale e quindi non hanno fotogrammi cui assegnare un'etichetta.

Containers use an internal content pane to control scrolling. The creatingContentPane is true while the container is creating the content pane so that some events can be ignored or blocked.

The Button control designated as the default button for the container. When controls in the container have focus, pressing the Enter key is the same as clicking this Button control.

Specifica se l'oggetto riceve gli eventi doubleClick. Il valore predefinito è false e indica che, per impostazione predefinita, un'istanza InteractiveObject non riceve gli eventi doubleClick. Se la proprietà doubleClickEnabled è impostata su true, l'istanza riceve gli eventi doubleClick nei propri limiti. Anche la proprietà mouseEnabled dell'istanza InteractiveObject deve essere impostata su true affinché l'oggetto possa ricevere gli eventi doubleClick.

Nessun evento viene inviato impostando questa proprietà. È necessario utilizzare il metodo addEventListener() per aggiungere un listener di eventi per l'evento doubleClick.

Specifica l'oggetto di visualizzazione sopra il quale viene trascinato lo sprite o sul quale viene rilasciato.

Gets the FocusManager that controls focus for this component and its peers. Each popup has its own focus loop and therefore its own instance of a FocusManager. To make sure you're talking to the right one, use this method.

Specifica se l'oggetto visualizza un rettangolo di attivazione. Può assumere uno di questi tre valori: true, false o null. I valori true e false funzionano come previsto, specificando se il rettangolo di attivazione viene visualizzato o meno. Il valore null indica che questo oggetto obbedisce alla proprietà stageFocusRect dello stage.

Specifica l'oggetto Graphics che appartiene a questo oggetto Sprite, in cui possono essere eseguiti i comandi di disegno vettoriale.

Definisce un altro sprite come area attiva di uno sprite. Se la proprietà hitArea non esiste oppure è null o undefined, lo sprite stesso viene utilizzato come area attiva. Il valore della proprietà hitArea può fungere da riferimento per un oggetto Sprite.

Potete modificare la proprietà hitArea in qualsiasi momento; lo sprite modificato utilizza immediatamente il nuovo comportamento dell'area attiva. Non è necessario che lo sprite designato come area attiva sia visibile; la sua forma grafica, anche non visibile, viene rilevata come area attiva.

Nota: dovete impostare su false la proprietà mouseEnabled dello sprite designato come area attiva. In caso contrario, il pulsante sprite potrebbe non funzionare perché non riceverebbe gli eventi dell'input dell'utente, che sarebbero invece ricevuti dallo sprite designato come area attiva.

The current position of the horizontal scroll bar. This is equal to the distance in pixels between the left edge of the scrollable surface and the leftmost piece of the surface that is currently visible.

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.

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.

Restituisce il numero di elementi secondari di questo oggetto.

Controlla il suono nello sprite.

Nota: questa proprietà non ha effetto sul contenuto HTML in un oggetto HTMLControl (in Adobe AIR).

Determines whether the children of the object are tab enabled.

Note: Do not use this property with Flex. Instead, use the UIComponent.hasFocusableChildren property.

Elementi API correlati

Specifica se questo oggetto è incluso nell'ordine di tabulazione. Se questo oggetto è nell'ordine di tabulazione, il valore è true, in caso contrario è false. Per impostazione predefinita, il valore è false, a eccezione dei casi seguenti:

• Per un oggetto SimpleButton, il valore è true.
• Per un oggetto TextField con type = "input", il valore è true.
• Per un oggetto Sprite o un oggetto MovieClip con buttonMode = true, il valore è true.

Specifica l'ordine di tabulazione degli oggetti in un file SWF. Il valore predefinito di questa proprietà tabIndex è -1 e indica che per l'oggetto non è impostato un indice di tabulazione.

Se un qualunque oggetto visualizzato nel file SWF contiene una proprietà tabIndex, l'ordine di tabulazione automatico viene disabilitato e viene calcolato in base alle proprietà tabIndex degli oggetti presenti nel file SWF. L'ordine di tabulazione personalizzato include solo gli oggetti dotati delle proprietà tabIndex.

La proprietà tabIndex può essere un numero intero non negativo. Gli oggetti vengono ordinati in base alle relative proprietà tabIndex, in ordine ascendente. Un oggetto con un valore tabIndex di 1 precede un oggetto con il valore tabIndex di 2. È sconsigliabile utilizzare lo stesso valore di tabIndex per più oggetti.

L'ordine di tabulazione personalizzato definito dalla proprietà tabIndex è di tipo flat. In altre parole, non viene prestata alcuna attenzione alle relazioni gerarchiche degli oggetti nel file SWF. Tutti gli oggetti del file SWF dotati delle proprietà tabIndex vengono inseriti nell'ordine di tabulazione, il quale viene determinato dall'ordine dei valori tabIndex.

Nota: per impostare l'ordine di tabulazione per le istanze TLFTextField, inserite l'oggetto di visualizzazione secondario del TLFTextField come InteractiveObject, quindi impostate la proprietà tabIndex. Ad esempio:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Restituisce un oggetto TextSnapshot per questa istanza DisplayObjectContainer.

Un valore booleano che indica se viene visualizzato un cursore a forma di mano quando il puntatore passa sopra uno sprite in cui la proprietà buttonMode è impostata su true. Il valore predefinito della proprietà useHandCursor è true. Se useHandCursor è impostata su true, viene visualizzato il puntatore a forma di mano quando il puntatore passa sopra uno sprite pulsante. Se useHandCursor è false, viene utilizzato il puntatore a forma di freccia.

Potete modificare la proprietà useHandCursor in qualsiasi momento; allo sprite modificato viene immediatamente associato il nuovo aspetto del cursore.

Nota: in Flex o Flash Builder, se lo sprite contiene degli sprite secondari, può essere opportuno impostare la proprietà mouseChildren su false. Ad esempio, se desiderate che un cursore a forma di mano venga visualizzato su un controllo Flex <mx:Label>, impostate le proprietà useHandCursor e buttonMode su true e la proprietà mouseChildren su false.

The current position of the vertical scroll bar. This is equal to the distance in pixels between the top edge of the scrollable surface and the topmost piece of the surface that is currently visible.

Returns an object that has four properties: left, top, right, and bottom. The value of each property equals the thickness of the chrome (visual elements) around the edge of the container.

The chrome includes the border thickness. If the horizontalScrollPolicy or verticalScrollPolicy property value is ScrollPolicy.ON, the chrome also includes the thickness of the corresponding scroll bar. If a scroll policy is ScrollPolicy.AUTO, the chrome measurement does not include the scroll bar thickness, even if a scroll bar is displayed.

Subclasses of Container should override this method, so that they include other chrome to be taken into account when positioning the Container's children. For example, the viewMetrics property for the Panel class should return an object whose top property includes the thickness of the Panel container's title bar.

Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer. L'istanza secondaria viene aggiunta al livello principale (primo) di tutti gli altri elementi secondari di questa istanza DisplayObjectContainer. Per aggiungere un elemento secondario in una posizione specifica, utilizzate il metodo, addChildAt().

Se aggiungete un oggetto secondario che ha già un contenitore di oggetto di visualizzazione diverso come elemento principale, l'oggetto viene rimosso dall'elenco degli elementi secondari dell'altro contenitore.

Nota: il comando stage.addChild() può causare problemi con un file SWF pubblicato, tra cui problemi di sicurezza e conflitti con altri file SWF caricati. In un'istanza del runtime Flash è presente un solo stage, indipendentemente dal numero di file SWF caricati nel runtime. In generale, quindi, gli oggetti non devono assolutamente essere aggiunti direttamente allo stage. Il solo oggetto che lo stage deve contenere è l'oggetto radice. Create un DisplayObjectContainer che conterrà tutti gli elementi dell'elenco di visualizzazione. Quindi, se necessario, aggiungete allo stage tale istanza DisplayObjectContainer.

Parametri

Aggiunge un'istanza secondaria DisplayObject a questa istanza DisplayObjectContainer. L'istanza viene aggiunta nella posizione di indice specificata. L'indice 0 corrisponde all'ultimo livello di profondità dell'elenco di visualizzazione di questo oggetto DisplayObjectContainer.

L'esempio seguente mostra tre oggetti di visualizzazione (a, b e c) rispettivamente nelle posizioni di indice 0, 2 e 1:

Se aggiungete un oggetto secondario che ha già un contenitore di oggetto di visualizzazione diverso come elemento principale, l'oggetto viene rimosso dall'elenco degli elementi secondari dell'altro contenitore.

Parametri

Indica se le restrizioni di sicurezza possono determinare l'omissione di eventuali oggetti di visualizzazione dall'elenco restituito dalla chiamata al metodo DisplayObjectContainer.getObjectsUnderPoint() con il punto point specificato. Per impostazione predefinita, il contenuto di un dominio non può accedere agli oggetti di un altro dominio a meno che l'operazione non venga consentita mediante una chiamata al metodo Security.allowDomain(). Per ulteriori informazioni sulla sicurezza, consultate l'argomento sulla sicurezza nel Centro per sviluppatori di Flash Player .

Il parametro point è nello spazio di coordinate dello stage, che può essere diverso dallo spazio di coordinate del contenitore di oggetto di visualizzazione (a meno che quest'ultimo non sia lo stage). Per convertire dei punti tra questi due spazi di coordinate, potete utilizzare i metodi globalToLocal() e localToGlobal().

Parametri

Determina se l'oggetto di visualizzazione specificato è un elemento secondario dell'istanza DisplayObjectContainer oppure è l'istanza stessa. La ricerca comprende l'intero elenco di visualizzazione, inclusa questa istanza DisplayObjectContainer. Gli elementi secondari di secondo livello, di terzo livello e così via restituiscono tutti true.

Parametri

Restituisce l'istanza dell'oggetto di visualizzazione secondario che si trova in corrispondenza della posizione di indice specificata.

Parametri

Restituisce l'oggetto di visualizzazione secondario al quale corrisponde il nome specificato. Se più di un oggetto di visualizzazione secondario ha il nome specificato, il metodo restituisce il primo oggetto dell'elenco degli elementi secondari.

Il metodo getChildAt() è più veloce di getChildByName(). Il metodo getChildAt() accede a un elemento secondario di un array memorizzato in cache, mentre getChildByName() deve leggere un elenco collegato per accedere a un elemento secondario.

Parametri

Restituisce la posizione di indice di un'istanza DisplayObject child.

Parametri

Restituisce un array di oggetti che si trovano sotto il punto specificato e sono elementi secondari (di uno o più livelli inferiori) di questa istanza DisplayObjectContainer. Gli oggetti secondari non accessibili per motivi di sicurezza vengono omessi dall'array restituito. Per determinare se questa restrizione di sicurezza influisce sull'array restituito, chiamare il metodo areInaccessibleObjectsUnderPoint().

Il parametro point è nello spazio di coordinate dello stage, che può essere diverso dallo spazio di coordinate del contenitore di oggetto di visualizzazione (a meno che quest'ultimo non sia lo stage). Per convertire dei punti tra questi due spazi di coordinate, potete utilizzare i metodi globalToLocal() e localToGlobal().

Parametri

Rimuove l'istanza DisplayObject child specificata dall'elenco degli elementi secondari dell'istanza DisplayObjectContainer. La proprietà parent dell'istanza secondaria rimossa viene impostata su null e l'oggetto viene rimosso dal garbage collector se non esistono altri riferimenti all'istanza secondaria. Le posizioni di indice di tutti gli oggetti di visualizzazione che si trovano sopra l'istanza secondaria in DisplayObjectContainer vengono diminuite di 1.

Il garbage collector riassegna lo spazio in memoria inutilizzato. Quando una variabile o un oggetto non sono più associati a un riferimento attivo o memorizzati da qualche parte, il garbage collector li rimuove e libera lo spazio di memoria che occupavano, se non risultano altri riferimenti ad essi.

Parametri

Rimuove un'istanza DisplayObject secondaria dalla posizione index specificata nell'elenco degli elementi secondari di DisplayObjectContainer. La proprietà parent dell'istanza secondaria rimossa viene impostata su null e l'oggetto viene rimosso dal garbage collector se non esistono altri riferimenti all'istanza secondaria. Le posizioni di indice di tutti gli oggetti di visualizzazione che si trovano sopra l'istanza secondaria in DisplayObjectContainer vengono diminuite di 1.

Il garbage collector riassegna lo spazio in memoria inutilizzato. Quando una variabile o un oggetto non sono più associati a un riferimento attivo o memorizzati da qualche parte, il garbage collector li rimuove e libera lo spazio di memoria che occupavano, se non risultano altri riferimenti ad essi.

Parametri

Cambia la posizione di un elemento secondario nel contenitore di oggetto di visualizzazione. Questa operazione influisce sulla stratificazione degli oggetti secondari. L'esempio seguente mostra tre oggetti di visualizzazione (a, b e c) rispettivamente nelle posizioni di indice 0, 1 e 2:

Quando utilizzate il metodo setChildIndex() e specificate una posizione di indice già occupata, le uniche posizioni che cambiano sono quelle comprese tra la posizione precedente e la nuova posizione dell'oggetto di visualizzazione. Tutte le altre rimangono uguali. Se un elemento secondario viene spostato in un indice INFERIORE al relativo indice corrente, tutti gli elementi secondari intermedi AUMENTANO di 1 per quanto riguarda il riferimento di indice. Se un elemento secondario viene spostato in un indice SUPERIORE al relativo indice corrente, tutti gli elementi secondari intermedi DIMINUISCONO di 1 per quanto riguarda il riferimento di indice. Ad esempio, se il contenitore di oggetto di visualizzazione dell'esempio precedente si chiama container, potete scambiare la posizione degli oggetti di visualizzazione con etichetta a e b chiamando il codice seguente:

container.setChildIndex(container.getChildAt(1), 0);

Questo codice determina la seguente disposizione degli oggetti:

Parametri

Consente all'utente di trascinare lo sprite specificato. È possibile trascinare lo sprite fino a quando il trascinamento non viene interrotto esplicitamente mediante una chiamata a Sprite.stopDrag() o non viene reso trascinabile un altro sprite. È possibile trascinare un solo sprite alla volta.

Gli oggetti di visualizzazione tridimensionali seguono il puntatore e Sprite.startDrag() sposta l'oggetto all'interno del pannello tridimensionale definito dall'oggetto di visualizzazione. Oppure, se l'oggetto di visualizzazione è un oggetto bidimensionale e un elemento secondario di un oggetto tridimensionale, l'oggetto bidimensionale si sposta all'interno del pannello tridimensionale definito dall'oggetto principale tridimensionale.

Parametri

Termina il metodo startDrag(). Uno sprite che è stato reso trascinabile mediante il metodo startDrag() rimane tale finché non viene aggiunto un metodo stopDrag() o fino a quando un altro sprite non diventa trascinabile. È possibile trascinare un solo sprite alla volta.

Scambia lo z-order (ordine di profondità) degli oggetti secondari specificati. Tutti gli altri oggetti secondari del contenitore di oggetto di visualizzazione rimangono nelle stesse posizioni di indice.

Parametri

Scambia lo z-order (ordine di profondità) degli oggetti secondari nelle due posizioni di indice specificate nell'elenco degli elementi secondari. Tutti gli altri oggetti secondari del contenitore di oggetto di visualizzazione rimangono nelle stesse posizioni di indice.

Parametri