Guida di riferimento di ActionScript® 3.0 per la piattaforma Adobe® Flash®
Home  |  Nascondi elenco pacchetti e classi |  Pacchetti  |  Classi  |  Novità  |  Indice  |  Appendici  |  Perché in inglese?
Filtri: AIR 30.0 e versioni precedenti, Flash Player 30.0 e versioni precedenti, Flash Lite 4
Flex 4.6 e versioni precedenti, Flash Pro CS6 e versioni precedenti
Nascondi filtri
flash.events 

SyncEvent  - AS3

Pacchettoflash.events
Classepublic class SyncEvent
EreditarietàSyncEvent Inheritance Event Inheritance Object

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Un oggetto SharedObject che rappresenta un oggetto condiviso remoto invia un oggetto SyncEvent quando l'oggetto condiviso remoto viene aggiornato dal server. Esiste un solo tipo di evento sync: SyncEvent.SYNC.

Elementi API correlati



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedbubbles : Boolean
[sola lettura] Indica se un evento è un evento di bubbling.
Event
 Inheritedcancelable : Boolean
[sola lettura] Indica se il comportamento associato all'evento può essere impedito.
Event
  changeList : Array
Un array di oggetti; ogni oggetto contiene proprietà che descrivono i membri modificati di un oggetto condiviso remoto.
SyncEvent
 Inheritedconstructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 InheritedcurrentTarget : Object
[sola lettura] L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
Event
 InheritedeventPhase : uint
[sola lettura] La fase attuale del flusso di eventi.
Event
 Inheritedtarget : Object
[sola lettura] Il target dell'evento.
Event
 Inheritedtype : String
[sola lettura] Il tipo di evento.
Event
Metodi pubblici
 MetodoDefinito da
  
SyncEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, changeList:Array = null)
Crea un oggetto Event contenente informazioni relative agli eventi sync.
SyncEvent
  
[override] Crea una copia dell'oggetto SyncEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
SyncEvent
 Inherited
formatToString(className:String, ... arguments):String
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate.
Event
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Verifica se sull'evento è stato chiamato il metodo preventDefault().
Event
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.
Event
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.
Event
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.
Event
 Inherited
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.
Object
  
[override] Restituisce una stringa che contiene tutte le proprietà dell'oggetto SyncEvent.
SyncEvent
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Costanti pubbliche
 CostanteDefinito da
  SYNC : String = "sync"
[statico] Definisce il valore della proprietà type di un oggetto evento sync.
SyncEvent
Descrizione delle proprietà

changeList

proprietà
changeList:Array

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Un array di oggetti; ogni oggetto contiene proprietà che descrivono i membri modificati di un oggetto condiviso remoto. Le proprietà di ciascun oggetto sono code, name e oldValue.

Quando vi connettete inizialmente a un oggetto condiviso remoto persistente a livello locale e/o sul server, tutte le proprietà di tale oggetto vengono impostate su stringhe vuote.

Altrimenti, Flash imposta code su "clear", "success", "reject", "change" o "delete".

  • Un valore "clear" indica che vi siete connessi a un oggetto condiviso remoto non persistente sul server o sul client o che tutte le proprietà di tale oggetto sono state eliminate; ad esempio, nel caso in cui le copie client e server dell'oggetto non possano essere sincronizzate, tanto che Flash Player risincronizza l'oggetto client con l'oggetto server. In quest'ultimo caso, SyncEvent.SYNC viene inviato e il valore "code" viene impostato su "change".
  • Il valore "success" indica che il client ha modificato l'oggetto condiviso.
  • Il valore "reject" indica che il client ha tentato invano di modificare l'oggetto; invece un altro client ha modificato l'oggetto.
  • Il valore "change" indica che un altro client ha modificato l'oggetto o che il server ha risincronizzato l'oggetto.
  • Il valore "delete" indica che l'attributo è stato cancellato.

La proprietà name contiene il nome della proprietà modificata.

La proprietà oldValue contiene il valore precedente dalla proprietà modificata. Questo parametro è null, a meno che il codice non presenti un valore "reject" o "change".



Implementazione
    public function get changeList():Array
    public function set changeList(value:Array):void

Elementi API correlati

Descrizione della funzione di costruzione

SyncEvent

()Funzione di costruzione
public function SyncEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, changeList:Array = null)

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Crea un oggetto Event contenente informazioni relative agli eventi sync. Gli oggetti evento vengono passati ai listener di eventi come parametri.

Parametri
type:String — Il tipo di evento. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata type. Esiste un solo tipo di evento sync: SyncEvent.SYNC.
 
bubbles:Boolean (default = false) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata bubbles.
 
cancelable:Boolean (default = false) — Determina se l'oggetto Event può essere annullato. I listener di eventi possono accedere a queste informazioni tramite la proprietà ereditata cancelable.
 
changeList:Array (default = null) — Un array di oggetti che descrive la sincronizzazione con l'istanza SharedObject remota. I listener di eventi possono accedere a questo oggetto tramite la proprietà changeList.

Elementi API correlati

Descrizione dei metodi

clone

()metodo
override public function clone():Event

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Crea una copia dell'oggetto SyncEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.

Restituisce
Event — Un nuovo oggetto SyncEvent con proprietà dai valori identici a quelli dell'originale.

toString

()metodo 
override public function toString():String

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Restituisce una stringa che contiene tutte le proprietà dell'oggetto SyncEvent. La stringa ha il seguente formato:

[SyncEvent type=valore bubbles=valore cancelable=valore list=valore]

Restituisce
String — Una stringa che contiene tutte le proprietà dell'oggetto SyncEvent.
Descrizione delle costanti

SYNC

Costante
public static const SYNC:String = "sync"

Versione linguaggio: ActionScript 3.0
Versioni runtime: AIR 1.0, Flash Player 9, Flash Lite 4

Definisce il valore della proprietà type di un oggetto evento sync.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
changeListUn array con le proprietà che descrivono lo stato dell'array.
targetL'istanza SharedObject che è stata aggiornata dal server.

Elementi API correlati





[ X ]Perché in inglese?
Il contenuto della Guida di riferimento di ActionScript 3.0 appare in inglese

Non tutte le parti della Guida di riferimento di ActionScript 3.0 sono tradotte in tutte le lingue. Quando un elemento del linguaggio non è tradotto, viene riportato in inglese. Ad esempio, la classe ga.controls.HelpBox non è tradotta in nessuna lingua. Pertanto, nella versione italiana della guida di riferimento, la descrizione della classe ga.controls.HelpBox è riportata in inglese.