NativeMenuItem

Pacchetto	flash.display
Classe	public class NativeMenuItem
Ereditarietà	NativeMenuItem EventDispatcher Object
Sottoclassi	ContextMenuItem

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

La classe NativeMenuItem rappresenta una voce singola di un menu.

Una voce di menu può essere rappresentata da un comando, da un sottomenu o da un separatore:

Per creare una voce di comando, chiamate la funzione di costruzione NativeMenuItem, passando una stringa per l'etichetta e false per il parametro isSeparator.
Per creare un sottomenu, create una voce di comando per il menu principale e assegnate l'oggetto NativeMenu del sottomenu alla proprietà submenu della voce. Potete anche chiamare il metodo addSubmenu() dell'oggetto principale NativeMenu per creare la voce e contemporaneamente impostare la proprietà submenu.
Per creare un separatore, chiamate la funzione di costruzione NativeMenuItem, passando una stringa per l'etichetta e true per il parametro isSeparator.

Attendete eventi select su una voce o un menu principale per rilevare quando è selezionato un comando di un menu. Né i sottomenu né i separatori inviano eventi select. Intercettate gli eventi preparing per determinare quando una voce di menu sta per essere visualizzata o attivata tramite un tasto equivalente.

Altri esempi

Uso dei menu

Elementi API correlati

flash.display.NativeMenu
flash.display.NativeMenu.addSubmenu()

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		checked : Boolean Controlla se la voce di menu presenta un segno di spunta.	NativeMenuItem
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		data : Object Un oggetto dati arbitrario associato alla voce di menu.	NativeMenuItem
		enabled : Boolean Controlla se la voce di menu è abilitata.	NativeMenuItem
		isSeparator : Boolean [sola lettura] Segnala se la voce è un separatore di menu.	NativeMenuItem
		keyEquivalent : String Il tasto equivalente della voce di menu.	NativeMenuItem
		keyEquivalentModifiers : Array L'array di codici tasti per i modificatori dei tasti equivalenti.	NativeMenuItem
		label : String La stringa di visualizzazione della voce di menu.	NativeMenuItem
		menu : NativeMenu [sola lettura] Il menu che contiene questa voce.	NativeMenuItem
		mnemonicIndex : int La posizione del carattere mnemonico nell'etichetta della voce di menu.	NativeMenuItem
		name : String Il nome di questa voce di menu.	NativeMenuItem
		submenu : NativeMenu Il sottomenu associato alla voce di menu.	NativeMenuItem

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		NativeMenuItem(label:String = "", isSeparator:Boolean = false) Crea un nuovo oggetto NativeMenuItem.	NativeMenuItem
		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.	EventDispatcher
		clone():NativeMenuItem Crea una copia dell'oggetto NativeMenuItem.	NativeMenuItem
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String [override] Restituisce una stringa che contiene tutte le proprietà dell'oggetto NativeMenuItem.	NativeMenuItem
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
displaying	Inviato dall'oggetto NativeMenuItem immediatamente prima della visualizzazione del menu che contiene la voce.	NativeMenuItem
preparing	Inviato dall'oggetto NativeMenuItem quando viene premuto il tasto equivalente e immediatamente prima della visualizzazione del menu che lo contiene.	NativeMenuItem
select	Inviato quando una voce di menu viene selezionata dall'utente.	NativeMenuItem

Descrizione delle proprietà

checked

proprietà

checked:Boolean

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Controlla se la voce di menu presenta un segno di spunta.

Implementazione
public function get checked():Boolean
public function set checked(value:Boolean):void

data

proprietà

data:Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Un oggetto dati arbitrario associato alla voce di menu.

Potete assegnare qualunque oggetto a questa proprietà. L'oggetto assegnato non viene utilizzato dal sistema dei menu, ma è disponibile per il codice di gestione degli eventi (tramite la proprietà target dell'oggetto evento). Per impostazione predefinita, il valore di questa proprietà è null.

Implementazione
public function get data():Object
public function set data(value:Object):void

enabled

proprietà

enabled:Boolean

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Controlla se la voce di menu è abilitata.

Implementazione
public function get enabled():Boolean
public function set enabled(value:Boolean):void

isSeparator

proprietà

isSeparator:Boolean [sola lettura]

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Segnala se la voce è un separatore di menu.

Create un separatore impostando il parametro isSeparator della funzione di costruzione NativeMenuItem su true.

Implementazione
public function get isSeparator():Boolean

keyEquivalent

proprietà

keyEquivalent:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Il tasto equivalente della voce di menu.

Impostate keyEquivalent con una lettera minuscola per assegnare una scelta rapida senza il modificatore del tasto Maiusc. Impostate una lettera maiuscola per assegnare una scelta rapida con il modificatore del tasto Maiusc.

Per impostazione predefinita, un modificatore dei tasti equivalenti (Ctrl in Windows o Linux e Comando in Mac OS X) viene incluso come parte dell'equivalente del tasto. Se desiderate che un tasto equivalente sia un tasto senza modificatore, impostate la proprietà keyEquivalentModifiers su un array vuoto.

Implementazione
public function get keyEquivalent():String
public function set keyEquivalent(value:String):void

keyEquivalentModifiers

proprietà

keyEquivalentModifiers:Array

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

L'array di codici tasti per i modificatori dei tasti equivalenti.

Utilizzate le costanti definite nella classe Keyboard per specificare i codici tasti per i modificatori dei tasti equivalenti. I codici di modifica validi sono:

Keyboard.ALTERNATE
Keyboard.COMMAND
Keyboard.CONTROL

Se non assegnate alcun modificatore, viene assegnato per impostazione predefinita il tasto Keyboard.CONTROL in Windows o Linux e il tasto Keyboard.COMMAND in Mac OS X. Se non desiderate includere questi modificatori nell'equivalente del tasto, impostate questa proprietà su un array vuoto.

Se assegnate una lettera maiuscola alla proprietà keyEquivalent, il tasto Maiusc viene automaticamente utilizzato come modificatore. Impostando keyEquivalentModifier su un array vuoto, non viene rimosso il tasto Maiusc come modificatore.

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

Elementi API correlati

flash.ui.Keyboard

label

proprietà

label:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

La stringa di visualizzazione della voce di menu.

Implementazione
public function get label():String
public function set label(value:String):void

mnemonicIndex

proprietà

mnemonicIndex:int

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

La posizione del carattere mnemonico nell'etichetta della voce di menu.

Il carattere nella posizione specificata diventa il carattere mnemonico per la voce di menu. L'indice è a base zero, pertanto il primo carattere ha un indice pari a 0.

Questa proprietà viene ignorata nei sistemi operativi che non utilizzano i caratteri mnemonici dei menu.

Implementazione
public function get mnemonicIndex():int
public function set mnemonicIndex(value:int):void

name

proprietà

name:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Il nome di questa voce di menu.

Il valore del nome non viene visualizzato e può essere utilizzato come identificatore indipendente dalla versione localizzata. Non viene assegnato automaticamente un nome.

Implementazione
public function get name():String
public function set name(value:String):void

submenu

proprietà

submenu:NativeMenu

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Il sottomenu associato alla voce di menu.

Se assegnate un oggetto NativeMenu a questa proprietà, vengono modificati l'aspetto e il comportamento della voce di menu. Una voce di sottomenu visualizza l'icona del sottomenu e non invia più degli eventi select.

Nota: l'aggiunta di un menu a un sottomenu di se stesso (in un riferimento circolare) può causare il blocco di un'applicazione.

Implementazione
public function get submenu():NativeMenu
public function set submenu(value:NativeMenu):void

Elementi API correlati

flash.display.NativeMenu.addSubmenu()

Descrizione della funzione di costruzione

()

Funzione di costruzione

public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Crea un nuovo oggetto NativeMenuItem.

Per creare un comando di menu, impostate il parametro label su una stringa che contiene l'etichetta di visualizzazione e impostate isSeparator su false.

Per creare un comando di sottomenu, create una voce di comando, quindi assegnate l'oggetto NativeMenu per il sottomenu alla proprietà submenu della voce. Aggiungete la voce al menu principale.

Per creare un separatore, impostate il parametro label su una stringa vuota e impostate isSeparator su true.

Aggiungete e rimuovete le voci di un menu mediante i metodi addItem() e removeItem() di NativeMenu.

Parametri

	`label:String` (default = "") — L'etichetta di visualizzazione per la voce oppure una stringa vuota per i separatori.

	`isSeparator:Boolean` (default = `false`) — Impostate su `true` per creare un separatore; altrimenti, su `false`.

Elementi API correlati

flash.display.NativeMenu.addSubmenu()

Descrizione dei metodi

clone

()

metodo

public function clone():NativeMenuItem

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Crea una copia dell'oggetto NativeMenuItem.

Restituisce

NativeMenuItem

toString

()

metodo

override public function toString():String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Restituisce una stringa che contiene tutte le proprietà dell'oggetto NativeMenuItem.

Restituisce

String — Una stringa che contiene tutte le proprietà dell'oggetto Event.

Descrizione degli eventi

displaying

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.DISPLAYING

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Inviato dall'oggetto NativeMenuItem immediatamente prima della visualizzazione del menu che contiene la voce.

L'evento preparing sostituisce l'evento displaying, fornendo ulteriori funzionalità. Intercettate l'evento preparing o l'evento displaying, ma non entrambi.

La costante Event.DISPLAYING definisce il valore della proprietà type di un oggetto evento displaying.

Nota: questo evento non è soggetto a una "fase di cattura" e viene inviato direttamente al target, sia che il target si trovi nell'elenco di visualizzazione o meno.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto che sta per essere visualizzato.

preparing

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.PREPARING

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 2.6

Inviato dall'oggetto NativeMenuItem quando viene premuto il tasto equivalente e immediatamente prima della visualizzazione del menu che lo contiene.

Attendete questo evento per aggiornare la voce prima della visualizzazione del menu che la contiene o quando l'utente preme il relativo tasto equivalente. L'evento preparing viene inviato prima che il tasto equivalente sia completamente valutato. Potete attivare, disattivare o rimuovere la voce dal menu nel gestore di eventi preparing. Le modifiche verranno applicate al momento dell'elaborazione del tasto equivalente. Se ad esempio rimuovete o disattivate questa voce di menu, la sequenza di eventi viene effettivamente annullata e non viene inviato alcun evento select. Un evento preparing viene inviato anche dalle altre voci di un menu.

L'evento preparing sostituisce l'evento displaying, fornendo ulteriori funzionalità. Intercettate l'evento preparing o l'evento displaying, ma non entrambi.

La costante Event.PREPARING definisce il valore della proprietà type di un oggetto evento preparing.

Nota: questo evento non è soggetto a una "fase di cattura" e viene inviato direttamente al target, sia che il target si trovi nell'elenco di visualizzazione o meno.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	L'oggetto che ha inviato l'evento.
`target`	L'oggetto che ha inviato l'evento.

select

Evento

Tipo di oggetto evento: flash.events.Event
proprietà Event.type = flash.events.Event.SELECT

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

Inviato quando una voce di menu viene selezionata dall'utente.

Un evento select si propaga (bubbles) da questa voce al relativo menu che la contiene risalendo la catena del menu principale fino all'oggetto menu principale. La proprietà target dell'oggetto evento fa riferimento a questo oggetto NativeMenuItem; la proprietà currentTarget fa riferimento all'oggetto che effettua l'invio (il NativeMenuItem in questione o un oggetto NativeMenu di livello superiore).

Nota: se la finestra che contiene il menu non è in modalità a schermo intero (stage.displayState == StageDisplayState.FULL_SCREEN), l'oggetto NativeMenuItem non invia un evento select immette un equivalente da tastiera di una voce di menu.

La costante Event.SELECT definisce il valore della proprietà type di un oggetto evento select.

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`target`	L'oggetto su cui è stata selezionata una voce.

Note legali | Informativa sulla privacy online

NativeMenuItem - AS3

Pacchettix

Elementi del linguaggio

Appendici

Pacchetto flash.display

checked

data

enabled

isSeparator

keyEquivalent

keyEquivalentModifiers

label

menu

mnemonicIndex

name

submenu

NativeMenuItem

clone

toString

displaying

preparing

select