| Pacchetto | flash.display |
| Classe | public class NativeMenuItem |
| Ereditarietà | NativeMenuItem  EventDispatcher Object |
| Sottoclassi | ContextMenuItem |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
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
falseper il parametroisSeparator. - Per creare un sottomenu, create una voce di comando per il menu principale e assegnate l'oggetto NativeMenu del sottomenu alla proprietà
submenudella voce. Potete anche chiamare il metodoaddSubmenu()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
trueper il parametroisSeparator.
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
Elementi API correlati
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 | ||
| Metodo | Definito da | ||
|---|---|---|---|
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 | |
Crea una copia dell'oggetto NativeMenuItem. | NativeMenuItem | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
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 NativeMenuItem. | NativeMenuItem | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
| Evento | Riepilogo | Definito da | ||
|---|---|---|---|---|
| [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 | ||
| [evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | ||
| Inviato dall'oggetto NativeMenuItem immediatamente prima della visualizzazione del menu che contiene la voce. | NativeMenuItem | |||
| Inviato dall'oggetto NativeMenuItem quando viene premuto il tasto equivalente e immediatamente prima della visualizzazione del menu che lo contiene. | NativeMenuItem | |||
| Inviato quando una voce di menu viene selezionata dall'utente. | NativeMenuItem | |||
checked | proprietà |
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à |
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.ALTERNATEKeyboard.COMMANDKeyboard.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):voidElementi API correlati
label | proprietà |
menu | proprietà |
menu:NativeMenu [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Il menu che contiene questa voce.
Implementazione
public function get menu():NativeMenu 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):voidElementi API correlati
NativeMenuItem | () | 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.
label:String (default = " | |
isSeparator:Boolean (default = false)true per creare un separatore; altrimenti, su false.
|
Elementi API correlati
clone | () | metodo |
public function clone():NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Crea una copia dell'oggetto NativeMenuItem.
RestituisceNativeMenuItem |
toString | () | metodo |
displaying | Evento |
flash.events.Eventproprietà 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.
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 |
flash.events.Eventproprietà 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.
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 |
flash.events.Eventproprietà 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.
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. |
Tue Jun 12 2018, 02:44 PM Z