flash.ui.ContextMenuItem (ActionScript 3.0)

Pacchetto	flash.ui
Classe	public final class ContextMenuItem
Ereditarietà	ContextMenuItem EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

La classe ContextMenuItem consente di creare voci di menu personalizzate da visualizzare nel menu di scelta rapida di Flash Player. Ciascun oggetto ContextMenuItem ha una didascalia (testo) che viene visualizzata nel menu di scelta rapida. Per aggiungere una nuova voce a un menu di scelta rapida, aggiungerla all'array customItems di un oggetto ContextMenu.

Le proprietà della classe ContextMenuItem consentono di abilitare o disabilitare voci di menu specifiche oppure di renderle visibili o invisibili.

Per aggiungere funzionalità a una voce di menu quando viene selezionata dall'utente, è possibile scrivere un gestore di eventi per l'evento menuItemSelect.

Le voci di menu personalizzate vengono visualizzate in cima al menu di scelta rapida, sopra le voci incorporate da cui sono distinte per mezzo di una barra separatrice.

Restrizioni:

È possibile aggiungere un massimo di 15 voci personalizzate a un menu di scelta rapida.
Ciascuna didascalia deve contenere almeno un carattere visibile.
I caratteri di controllo, i caratteri newline e altri caratteri di spazio vuoto vengono ignorati.
Nessuna didascalia può superare i 100 caratteri.
Le didascalie identiche a una voce di menu incorporata o a un'altra voce personalizzata vengono ignorate, anche se la voce corrispondente non è visibile. Le didascalie di menu vengono confrontate con le didascalie incorporate o personalizzate esistenti senza tener conto di maiuscole/minuscole, punteggiatura o spazi vuoti.

Le didascalie seguenti non sono consentite, ma possono essere utilizzate in combinazione con altre parole per formare una didascalia personalizzata (ad esempio, sebbene "Paste" non sia consentita, "Paste tastes great" invece lo è):

 Save
 Zoom In
 Zoom Out
 100%
 Show All
 Quality
 Play
 Loop
 Rewind
 Forward
 Back
 Movie not loaded
 About
 Print
 Show Redraw Regions
 Debugger
 Undo
 Cut
 Copy
 Paste
 Delete
 Select All
 Open
 Open in new window
 Copy link

Nessuna delle parole seguenti può costituire una didascalia personalizzata di per sé o in combinazione con altre parole:
```
 Adobe
 Macromedia
 Flash Player
 Settings
 
```

Nota: quando il lettore è in esecuzione su un sistema non in lingua inglese, le stringhe delle didascalie vengono confrontate sia con l'elenco inglese che con gli equivalenti localizzati.

Vedere gli esempi

Vedere anche

Classe ContextMenu
Classe ContextMenuBuiltInItems

	Proprietà	Definito da
		caption: String Specifica la didascalia (testo) della voce di menu visualizzata nel menu di scelta rapida.	ContextMenuItem
		constructor: Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		enabled: Boolean Indica se la voce di menu specificata è abilitata o disabilitata.	ContextMenuItem
		prototype: Object [statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.	Object
		separatorBefore: Boolean Indica se sopra la voce di menu specificata deve essere visualizzata una barra separatrice.	ContextMenuItem
		visible: Boolean Indica se la voce di menu specificata è visibile quando viene visualizzato il menu di scelta rapida di Flash Player.	ContextMenuItem

	Metodo	Definito da
		ContextMenuItem(caption:String, separatorBefore:Boolean = false, enabled:Boolean = true, visible:Boolean = true) Crea un nuovo oggetto ContextMenuItem che è possibile aggiungere all'array ContextMenu.customItems.	ContextMenuItem
		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():ContextMenuItem Crea e restituisce una copia dell'oggetto ContextMenuItem specificato.	ContextMenuItem
		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
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		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

Riepilogo	Definito da
activate	Inviato quando Flash Player riceve lo stato di attivazione del sistema operativo e diventa attivo.	EventDispatcher
deactivate	Inviato quando Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare inattivo.	EventDispatcher
menuItemSelect	Inviato quando l'utente seleziona una voce dal menu di scelta rapida.	ContextMenuItem

Descrizione delle proprietà

caption

proprietà

caption:String [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Specifica la didascalia (testo) della voce di menu visualizzata nel menu di scelta rapida. Vedere la panoramica della classe ContextMenuItem per le restrizioni del valore caption.

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

enabled

proprietà

enabled:Boolean [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Indica se la voce di menu specificata è abilitata o disabilitata.

Il valore predefinito è true.

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

separatorBefore

proprietà

separatorBefore:Boolean [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Indica se sopra la voce di menu specificata deve essere visualizzata una barra separatrice.

Nota: una barra separatrice viene sempre visualizzata tra le voci di menu personalizzate e quelle incorporate.

Il valore predefinito è false.

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

visible

proprietà

visible:Boolean [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Indica se la voce di menu specificata è visibile quando viene visualizzato il menu di scelta rapida di Flash Player.

Il valore predefinito è true.

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

Descrizione della funzione di costruzione

ContextMenuItem

()

Funzione di costruzione

public function ContextMenuItem(caption:String, separatorBefore:Boolean = false, enabled:Boolean = true, visible:Boolean = true)

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Crea un nuovo oggetto ContextMenuItem che è possibile aggiungere all'array ContextMenu.customItems.

Parametri

	`caption:String` — Specifica il testo associato alla voce di menu. Vedere la panoramica della classe ContextMenuItem per le restrizioni del valore `caption`.

	`separatorBefore:Boolean` (default = `false`) — Specifica se sopra la voce di menu specificata nel menu di scelta rapida deve essere visualizzata una barra di separazione. Il valore predefinito è `false`.

	`enabled:Boolean` (default = `true`) — Specifica se la voce di menu è abilitata o disabilitata nel menu di scelta rapida. Il valore predefinito è `true` (abilitata). Questo parametro è opzionale.

	`visible:Boolean` (default = `true`) — Specifica se la voce di menu è visibile o invisibile. Il valore predefinito è `true` (visibile).

Descrizione dei metodi

clone

()

metodo

public function clone():ContextMenuItem

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Crea e restituisce una copia dell'oggetto ContextMenuItem specificato. La copia comprende tutte le proprietà dell'oggetto originale.

Restituisce

ContextMenuItem — Un oggetto ContextMenuItem che contiene tutte le proprietà dell'oggetto originale.

Descrizione degli eventi

menuItemSelect

Evento

Tipo di oggetto evento: flash.events.ContextMenuEvent
ContextMenuEvent.type property = flash.events.ContextMenuEvent.MENU_ITEM_SELECT

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

Inviato quando l'utente seleziona una voce dal menu di scelta rapida. L'utente genera il menu di scelta rapida facendo clic sul pulsante secondario del dispositivo di puntamento.

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

Questo evento ha le seguenti proprietà:

Proprietà	Valore
`bubbles`	`false`
`cancelable`	`false`; non è presente alcun comportamento predefinito da annullare.
`contextMenuOwner`	L'oggetto elenco di visualizzazione al quale il menu è associato.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`mouseTarget`	L'oggetto elenco di visualizzazione su cui l'utente ha fatto clic con il pulsante destro per visualizzare il menu di scelta rapida.
`target`	L'oggetto ContextMenuItem selezionato. Il target non è sempre l'oggetto contenuto nell'elenco di visualizzazione, che ha registrato il listener di eventi. Utilizzare la proprietà `currentTarget` per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Esempi Come utilizzare gli esempi

ContextMenuItemExample.as

L'esempio seguente utilizza la classe ContextMenuBuiltInItemsExample per rimuovere dallo stage le voci del menu di scelta rapida predefinito e aggiungere una nuova voce di menu. Questa operazione viene eseguita mediante la procedura seguente:

Una proprietà di nome myContextMenu viene dichiarata e quindi assegnata a un nuovo oggetto ContextMenu.
Viene chiamato il metodo removeDefaultItems(), che rimuove tutte le voci incorporate del menu di scelta rapida ad eccezione di Print.
Viene chiamato il metodo addCustomMenuItems(), che inserisce la voce di menu Hello World nell'array customItems utilizzando il metodo push() di Array.
La voce di menu di scelta rapida Hello World viene quindi aggiunta alle voci del menu di scelta rapida dello stage.
Allo stage viene aggiunto un oggetto TextField con il testo "Right Click Here".

package {
    import flash.ui.ContextMenu;
    import flash.ui.ContextMenuItem;
    import flash.ui.ContextMenuBuiltInItems;
    import flash.display.Sprite;
    import flash.text.TextField;

    public class ContextMenuItemExample extends Sprite {
        private var myContextMenu:ContextMenu;

        public function ContextMenuItemExample() {
            myContextMenu = new ContextMenu();
            removeDefaultItems();
            addCustomMenuItems();
            this.contextMenu = myContextMenu;
            addChild(createLabel());
        }

        private function removeDefaultItems():void {
            myContextMenu.hideBuiltInItems();

            var defaultItems:ContextMenuBuiltInItems = myContextMenu.builtInItems;
            defaultItems.print = true;
        }

        private function addCustomMenuItems():void {
            var item:ContextMenuItem = new ContextMenuItem("Hello World");
            myContextMenu.customItems.push(item);
        }
        
        private function createLabel():TextField {
            var txtField:TextField = new TextField();
            txtField.text = "Right Click Here";
            return txtField;
        }
    }
}

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/ui/ContextMenuItem.html

Guida di riferimento del linguaggio e dei componenti ActionScript 3.0		Tutti i pacchetti \| Tutte le classi \| Elementi del linguaggio \| Indice \| Appendici \| Convenzioni \| Con frame Senza frame
ContextMenuItem	Proprietà \| Metodi \| Eventi \| Esempi