| Pacchetto | flash.display |
| Classe | public class NativeMenu |
| Ereditarietà | NativeMenu  EventDispatcher Object |
| Sottoclassi | ContextMenu |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Supporto profili AIR: questa funzionalità è supportata in tutti i sistemi operativi desktop ma non nei dispositivi mobili o in AIR per i dispositivi TV. È possibile verificare se la funzionalità è supportata in fase runtime utilizzando la proprietà NativeMenu.isSupported. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.
Un menu nativo viene controllato e disegnato dal sistema operativo anziché dalla vostra applicazione. AIR supporta i tipi seguenti di menu nativi:
- I menu dell'applicazione sono supportati su OS X. Utilizzate la proprietà
NativeApplication.supportsMenuper verificare se i menu dell'applicazione sono supportati sul sistema operativo host. Un menu dell'applicazione viene visualizzato sulla barra dei menu nella parte superiore della scrivania Mac. In OS X è disponibile un menu predefinito per ogni applicazione, ma molti dei comandi di menu non sono funzionali. Potete aggiungere listener di eventi alle voci predefinite, sostituire singoli menu e voci o addirittura sostituire completamente il menu predefinito. Potete accedere all'oggetto menu dell'applicazione utilizzando la proprietàmenudi NativeApplication. - I menu delle finestre sono supportati in Windows e Linux. Utilizzate la proprietà
NativeWindow.supportsMenuper verificare se i menu delle finestre sono supportati sul sistema operativo host. Un menu della finestra viene visualizzato sotto la barra del titolo della finestra. L'area occupata dal menu non fa parte dello stage della finestra. Il disegno in questa area da parte delle applicazioni non è consentito. Assegnate un menu a una finestra utilizzando la proprietàmenudi NativeWindow. - I menu dell'icona del dock sono supportati su OS X. Utilizzate la proprietà
NativeApplication.supportsDockIconper verificare se le icone del dock sono supportate nel sistema operativo host. Le voci in un menu dell'icona del dock sono visualizzate sopra le voci predefinite fornite dal sistema operativo. Alle voci predefinite non è possibile accedere dal codice dell'applicazione. Assegnate un menu alla proprietàmenudell'oggetto DockIcon dell'applicazione. - I menu delle icone della barra delle applicazioni sono supportati in Windows e nella maggior parte dei sistemi operativi Linux. Utilizzate la proprietà
NativeApplication.supportsSystemTrayIconper verificare se le icone della barra delle applicazioni sono supportate nel sistema operativo host. Un menu dell'icona della barra delle applicazioni viene visualizzato in risposta a un clic con il pulsante destro del mouse sull'icona, in modo molto simile a un menu di scelta rapida. Assegnate un menu alla proprietàmenudell'oggetto SystemTrayIcon dell'applicazione. - I menu di scelta rapida sono supportati in tutti i sistemi operativi. I menu di scelta rapida vengono visualizzati in risposta a un evento dell'interfaccia utente, ad esempio un clic con il pulsante destro del mouse oppure un clic tenendo premuto il tasto Comando su un'istanza InteractiveObject visualizzata nell'applicazione. Il meccanismo dell'interfaccia utente per la visualizzazione dei menu varia in base al sistema operativo host e all'hardware. Assegnate un menu alla proprietà
contextMenudi un oggetto InteractiveObject. In AIR, potete creare un menu di scelta rapida sia con la classe NativeMenu che con la classe ContextMenu. In Flash Player, potete utilizzare solo la classe ContextMenu. Le classi ContextMenu in AIR non dispongono di voci incorporate; non viene visualizzato un menu di scelta rapida predefinito. - I menu a comparsa sono supportati in tutti i sistemi operativi. I menu a comparsa funzionano in modo analogo ai menu di scelta rapida, ma vengono visualizzati utilizzando il metodo
display()del menu, anziché in risposta a un evento dell'interfaccia utente. Un menu a comparsa non viene associato ad alcun altro oggetto. Dovete semplicemente creare il menu nativo e chiamare il metododisplay().
Un oggetto menu contiene voci di menu. Una voce di menu può rappresentare un comando, un sottomenu o un separatore. Aggiungete voci di menu a un menu utilizzando il metodo addItem() o addItemAt(). L'ordine di visualizzazione delle voci di menu corrisponde all'ordine delle voci presenti nell'array items del menu.
Per creare un sottomenu, aggiungete una voce di menu all'oggetto menu principale. Assegnate l'oggetto menu che rappresenta il sottomenu alla proprietà submenu della voce di menu corrispondente nel menu principale.
Nota: il menu principale dei menu delle finestre e delle applicazioni deve contenere solo voci di sottomenu; le voci che non rappresentano sottomenu potrebbero non venire visualizzate e sono contrarie a ciò che l'utente si aspetta per questi tipi di menu.
I menu inviano eventi select quando viene selezionata una voce di comando nel menu o in uno dei relativi sottomenu. (Le voci dei sottomenu e dei separatori non sono selezionabili). La proprietà target dell'oggetto evento fa riferimento alla voce selezionata.
I menu inviano gli eventi preparing subito prima della visualizzazione del menu e quando viene premuto un tasto equivalente associato a una delle voci del menu. Potete utilizzare questo evento per aggiornare il contenuto del menu in base allo stato corrente dell'applicazione.
Nota: se utilizzate Flex Framework, considerate l'utilizzo della classe FlexNativeMenu. È solitamente più facile definire menu tramite dichiarazioni in MXML piuttosto che scrivere codice ActionScript per creare la struttura del menu voce per voce.
Altri esempi
Elementi API correlati
flash.display.NativeMenuItem
flash.display.NativeWindow.menu
flash.desktop.DockIcon
flash.desktop.SystemTrayIcon
flash.desktop.NativeApplication.menu
flash.desktop.NativeApplication.icon
mx.controls.FlexNativeMenu
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| isSupported : Boolean [statico] [sola lettura]
Indica se qualunque forma di menu nativo è supportata nel sistema client. | NativeMenu | ||
| items : Array
L'array di oggetti NativeMenuItem nel menu. | NativeMenu | ||
| numItems : int [sola lettura]
Il numero di oggetti NativeMenuItem nel menu. | NativeMenu | ||
| parent : NativeMenu [sola lettura]
Il menu principale. | NativeMenu | ||
| Metodo | Definito da | ||
|---|---|---|---|
Crea un nuovo oggetto NativeMenu. | NativeMenu | ||
| 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 | |
Aggiunge una voce di menu in fondo al menu. | NativeMenu | ||
Aggiunge una voce di menu alla posizione specificata. | NativeMenu | ||
Aggiunge un sottomenu al menu inserendo una nuova voce di menu. | NativeMenu | ||
Aggiunge un sottomenu al menu inserendo una nuova voce di menu nella posizione specificata. | NativeMenu | ||
Crea una copia del menu e di tutte le voci. | NativeMenu | ||
Segnala se il menu contiene la voce di menu specificata. | NativeMenu | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
Visualizza il menu nella posizione specificata. | NativeMenu | ||
Ottiene la voce di menu nella posizione di indice specificata. | NativeMenu | ||
Ottiene la voce di menu con il nome specificato. | NativeMenu | ||
Ottiene la posizione della voce specificata. | NativeMenu | ||
|
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 tutte le voci dal menu. | NativeMenu | ||
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
Rimuove la voce di menu specificata. | NativeMenu | ||
Rimuove e restituisce la voce di menu nella posizione di indice specificata. | NativeMenu | ||
Sposta una voce di menu alla posizione specificata. | NativeMenu | ||
|
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 | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
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 NativeMenu immediatamente prima della visualizzazione del menu. | NativeMenu | |||
| Inviato dall'oggetto NativeMenu quando viene premuto il tasto equivalente e immediatamente prima della visualizzazione del menu. | NativeMenu | |||
| Inviato dall'oggetto NativeMenu quando una delle voci di menu o una voce in uno dei sottomenu discendenti è selezionata. | NativeMenu | |||
isSupported | proprietà |
items | proprietà |
items:Array| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
L'array di oggetti NativeMenuItem nel menu.
L'array viene ordinato in base all'ordine di visualizzazione.
Nota: questa proprietà è di sola lettura in AIR 1.0. È diventata di lettura/scrittura a partire da AIR 1.1.
Implementazione
public function get items():Array public function set items(value:Array):void numItems | proprietà |
parent | proprietà |
parent:NativeMenu [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Il menu principale.
Il valore di parent per l'oggetto menu principale (livello superiore) è null.
Implementazione
public function get parent():NativeMenu NativeMenu | () | Funzione di costruzione |
public function NativeMenu()| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Crea un nuovo oggetto NativeMenu.
addItem | () | metodo |
public function addItem(item:NativeMenuItem):NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Aggiunge una voce di menu in fondo al menu.
Quando create un menu di scelta rapida, potete aggiungere sia oggetti NativeMenuItem che oggetti ContextMenuItem. Tuttavia, è consigliabile utilizzare solo un tipo di oggetto in un menu di scelta rapida in modo che tutte le voci del menu abbiano le stesse proprietà.
Nota: l'aggiunta di una voce a un menu può provocare il blocco di un'applicazione se il sottomenu della voce è impostato sul menu stesso (causando un riferimento circolare).
Parametri
item:NativeMenuItem — L'oggetto NativeMenuItem da aggiungere in fondo al menu.
|
NativeMenuItem |
Genera
ArgumentError — Se item è null.
| |
ArgumentError — Se item è un membro di un altro menu.
|
addItemAt | () | metodo |
public function addItemAt(item:NativeMenuItem, index:int):NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Aggiunge una voce di menu alla posizione specificata. La posizione viene indicizzata a partire dall'alto. Impostate il parametro index su zero per inserire la voce all'inizio del menu. Tutti i tipi di menu, finestra, applicazione, icona della barra delle applicazioni, icona del dock, menu contestuali e a comparsa, indicizzano la posizione del menu a partire dall'alto.
Parametri
item:NativeMenuItem — L'oggetto NativeMenuItem da inserire.
| |
index:int — La posizione (con base zero) nel menu in corrispondenza della quale aggiungere la voce di menu.
Nota: l'aggiunta di una voce a un menu può provocare il blocco di un'applicazione se il sottomenu della voce è impostato sul menu stesso (causando un riferimento circolare). |
NativeMenuItem |
Genera
ArgumentError — Se item è null.
| |
ArgumentError — Se item è un membro di un altro menu.
| |
RangeError — Se l'indice è al di fuori dei limiti dell'array items del menu.
|
addSubmenu | () | metodo |
public function addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Aggiunge un sottomenu al menu inserendo una nuova voce di menu.
La chiamata al metodo addSubMenuAt() equivale a creare una nuova voce di menu, aggiungerla al menu e assegnare un oggetto NativeMenu alla proprietà submenu della voce.
Nota: l'aggiunta di un menu a un sottomenu di se stesso (in un riferimento circolare) può causare il blocco di un'applicazione.
Parametri
submenu:NativeMenu — L'oggetto NativeMenu che definisce il sottomenu da aggiungere.
| |
label:String — L'etichetta di visualizzazione per la voce di menu da aggiungere.
|
NativeMenuItem — L'oggetto NativeMenuItem creato per il sottomenu.
|
addSubmenuAt | () | metodo |
public function addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Aggiunge un sottomenu al menu inserendo una nuova voce di menu nella posizione specificata.
La chiamata al metodo addSubMenuAt() equivale a creare una nuova voce di menu, inserirla nella posizione desiderata all'interno del menu e assegnare un oggetto NativeMenu alla proprietà submenu della voce.
Nota: l'aggiunta di un menu a un sottomenu di se stesso (in un riferimento circolare) può causare il blocco di un'applicazione.
Parametri
submenu:NativeMenu — L'oggetto NativeMenu che definisce il sottomenu da aggiungere.
| |
index:int — La posizione nell'array items del menu in cui inserire la voce di menu da aggiungere.
| |
label:String — L'etichetta di visualizzazione per la voce di menu da aggiungere.
|
NativeMenuItem — L'oggetto NativeMenuItem creato per il sottomenu.
|
clone | () | metodo |
public function clone():NativeMenu| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Crea una copia del menu e di tutte le voci.
RestituisceNativeMenu |
containsItem | () | metodo |
public function containsItem(item:NativeMenuItem):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Segnala se il menu contiene la voce di menu specificata.
Parametri
item:NativeMenuItem — L'oggetto NativeMenuItem da cercare.
|
Boolean — true se item è presente nel menu.
|
display | () | metodo |
public function display(stage:Stage, stageX:Number, stageY:Number):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Visualizza il menu nella posizione specificata.
Parametri
stage:Stage — L'oggetto Stage su cui visualizzare il menu.
| |
stageX:Number — Il numero di pixel orizzontali, rispetto all'origine di stage, in corrispondenza del quale deve essere visualizzato questo menu.
| |
stageY:Number — Il numero di pixel verticali, relativo all'origine di stage, in corrispondenza del quale visualizzare il menu.
|
getItemAt | () | metodo |
public function getItemAt(index:int):NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Ottiene la voce di menu nella posizione di indice specificata.
Parametri
index:int — La posizione (con base zero) della voce da restituire.
|
NativeMenuItem — L'oggetto NativeMenuItem nella posizione specificata nel menu.
|
Genera
RangeError — Se index è al di fuori dei limiti dell'array items del menu.
|
getItemByName | () | metodo |
public function getItemByName(name:String):NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Ottiene la voce di menu con il nome specificato.
Nota: la proprietà name delle voci di menu non viene assegnata per impostazione predefinita.
Parametri
name:String — La stringa da cercare.
|
NativeMenuItem — L'oggetto NativeMenuItem con il nome specificato oppure null, se nel menu non è presente tale voce.
|
getItemIndex | () | metodo |
public function getItemIndex(item:NativeMenuItem):int| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Ottiene la posizione della voce specificata.
Parametri
item:NativeMenuItem — L'oggetto NativeMenuItem da cercare.
|
int — La posizione (con base zero) della voce specificata nel menu oppure -1, se la voce non è presente nel menu.
|
removeAllItems | () | metodo |
public function removeAllItems():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Rimuove tutte le voci dal menu.
removeItem | () | metodo |
public function removeItem(item:NativeMenuItem):NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Rimuove la voce di menu specificata.
Parametri
item:NativeMenuItem — L'oggetto NativeMenuItem da rimuovere dal menu.
|
NativeMenuItem |
Genera
RangeError — Se item non è presente nel menu.
|
removeItemAt | () | metodo |
public function removeItemAt(index:int):NativeMenuItem| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Rimuove e restituisce la voce di menu nella posizione di indice specificata.
Parametri
index:int — La posizione (con base zero) della voce da rimuovere.
|
NativeMenuItem — L'oggetto NativeMenuItem rimosso.
|
Genera
RangeError — Se index è al di fuori dei limiti dell'array items del menu.
|
setItemIndex | () | metodo |
public function setItemIndex(item:NativeMenuItem, index:int):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Sposta una voce di menu alla posizione specificata. Se la voce non è già presente nel menu, la chiamata di questo metodo ne determina l'aggiunta al menu.
Parametri
item:NativeMenuItem — L'oggetto NativeMenuItem da spostare.
| |
index:int — La posizione (con base zero) nel menu in cui spostare item.
|
Genera
RangeError — Se index è al di fuori dei limiti dell'array items del menu.
|
displaying | Evento |
flash.events.Eventproprietà Event.type =
flash.events.Event.DISPLAYING| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Inviato dall'oggetto NativeMenu immediatamente prima della visualizzazione del menu.
Attendete questo evento per aggiornare il menu prima che venga visualizzato. Un evento displaying viene inviato anche dalle 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.
Nota: in Mac OS X, prima di AIR 2.6, i menu e le voci di menu inviavano un evento displaying quando l'utente premeva un tasto equivalente. (Questo evento non veniva inviato per l'interazione dei tasti equivalenti in altri sistemi operativi). A partire da AIR 2.6, gli eventi displaying non vengono più inviati quando l'utente preme un tasto equivalente. Utilizzate invece l'evento preparing.
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 NativeMenu quando viene premuto il tasto equivalente e immediatamente prima della visualizzazione del menu.
Attendete questo evento per aggiornare il menu prima che sia visualizzato o quando l'utente preme un tasto equivalente. L'evento preparing viene inviato prima che il tasto equivalente sia completamente valutato. Potete attivare, disattivare, aggiungere o rimuovere le voci dal menu nel gestore di eventi preparing. Le modifiche verranno applicate al momento dell'elaborazione del tasto equivalente. Se ad esempio rimuovete o disattivate la voce di menu assegnata al tasto equivalente di attivazione, la sequenza di eventi viene effettivamente annullata e non viene inviato alcun evento select. Un evento preparing viene inviato anche dalle 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 dall'oggetto NativeMenu quando una delle voci di menu o una voce in uno dei sottomenu discendenti è selezionata.
Un evento select si propaga da una 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 all'oggetto NativeMenuItem; la proprietà currentTarget fa riferimento a questo oggetto NativeMenuItem.
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