適用於 Adobe® Flash® Platform 的 ActionScript® 3.0 參考
首頁  |  隱藏套件和類別清單 |  套件  |  類別  |  新增內容  |  索引  |  附錄  |  為什麼顯示英文?
篩選: AIR 30.0 和更早版本, Flash Player 30.0 和更早版本, Flash Lite 4
Flex 4.6 和更早版本, Flash Pro CS6 和更早版本
隱藏篩選
flash.display 

NativeMenu  - AS3

套件x

最上層
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

語言元素

全域常數
全域函數
運算子
陳述式、關鍵字和指令
特殊類型

附錄

新增內容
編譯器錯誤
編譯器警告
執行階段錯誤
移轉至 ActionScript 3
支援的字元集
僅限 MXML 標籤
移動 XML 元素
Timed Text 標籤
不建議元素清單
AccessibilityImplementation 常數
如何使用 ActionScript 範例
法律聲明
套件flash.display
類別public class NativeMenu
繼承NativeMenu Inheritance EventDispatcher Inheritance Object
子類別 ContextMenu

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

NativeMenu 類別包含定義原生選單所需的方法與屬性。

AIR 描述檔支援:所有桌上型電腦作業系統都支援此項功能,但行動裝置或 AIR for TV 裝置不支援。您可以使用 NativeMenu.isSupported 屬性測試執行階段的支援狀況。如需有關跨多個描述檔之 API 支援的詳細資訊,請參閱 AIR 描述檔支援

原生選單是一種由作業系統控制而不是由應用程式控制的選單。AIR 支援下列原生選單類型:

  • OS X 支援應用程式選單。請使用 NativeApplication.supportsMenu 屬性,測試主機作業系統是否支援應用程式選單。應用程式選單會顯示在 Mac 桌面最上方的選單列中。OS X 提供預設選單給每一種應用程式,不過其中很多選單命令功能無效。您可以將事件偵聽程式新增至預設項目、取代個別選單和項目,或者還可以完全取代整個預設選單。使用 NativeApplication menu 屬性存取應用程式選單物件。
  • Windows 和 Linux 支援 Window 選單。請使用 NativeWindow.supportsMenu 屬性來測試主機作業系統是否支援視窗選單。視窗選單是顯示在視窗標題列的下方。選單佔用的區域不屬於視窗舞台的一部分。應用程式無法在這個區域進行繪製。使用 NativeWindow menu 屬性,將選單指定至視窗。
  • OS X 支援停駐圖示選單。請使用 NativeApplication.supportsDockIcon 屬性,測試主機作業系統是否支援停駐圖示選單。停駐圖示選單中的項目會顯示在作業系統提供的預設項目上方。應用程式的程式碼無法存取預設的項目。請將選單指定至應用程式 DockIcon 物件的 menu 屬性。
  • Windows 和大部分的 Linux 作業系統支援系統匣圖示選單。請使用 NativeApplication.supportsSystemTrayIcon 屬性來測試主機作業系統是否支援系統匣圖示。為了回應在圖示上按滑鼠右鍵,會顯示一個系統匣圖示選單,和快顯選單的方式相同。請將選單指定至應用程式 SystemTrayIcon 物件的 menu 屬性。
  • 所有作業系統都支援快顯選單。為了回應使用者介面事件,例如在應用程式顯示的 InteractiveObject 上按滑鼠右鍵或按一下某個命令,會顯示快顯選單。顯示選單的 UI 作用機制,隨主機作業系統及硬體而有所不同。將選單指定至 InteractiveObject 的 contextMenu 屬性。在 AIR 中,可以使用 NativeMenu 類別或 ContextMenu 類別來建立快顯選單。在 Flash Player 中,只可以使用 ContextMenu 類別。AIR 中的 ContextMenus 沒有內建的項目;不會顯示預設的快顯選單。
  • 所有作業系統都支援即現式選單。即現式選單的功能與快顯選單相同,不過是使用選單 display() 方法來顯示,而不是回應使用者介面事件。即現式選單不會附加至任何其他物件。只要建立原生選單,然後呼叫 display() 方法即可。

選單物件包含選單項目。選單項目可以代表命令、子選單或分隔符號字行:使用 addItem()addItemAt() 方法,將選單項目加到選單。選單項目的顯示順序符合選單的 items 陣列中項目的順序。

若要建立子選單,可以將選單項目加到父選單物件。將代表子選單的選單物件指定至父選單中相符之選單項目的 submenu 屬性。

注意:視窗和應用程式選單的根選單只能包含子選單項目。不應該顯示不代表子選單的項目,且會與使用者對這些選單類型的期望相反。

在選單中選取命令項目,或選單之子選單的其中一個項目時,選單就會傳送 select 事件 (子選單和分隔符號項目都是無法選取的)。此事件物件的 target 屬性會參考所選取的項目。

在顯示選單之前以及按下附加至選單中的其中一個項目的對等按鍵時,選單會傳送 preparing 事件。您可以使用此事件,根據應用程式的目前狀態更新選單的內容。

注意:如果您使用 Flex Framework,請考慮使用 FlexNativeMenu 類別。通常以宣告方式在 MXML 中定義選單,會比編寫 ActionScript 程式碼來建立選單結構逐一項目要來的簡單多了。

相關 API 元素



公用屬性
 屬性定義自
 Inheritedconstructor : Object
類別物件的參照或是特定物件實體的建構函數。
Object
      isSupported : Boolean
[靜態] [唯讀] 指出用戶端系統是否支援原生選單的任何形式。
NativeMenu
      items : Array
此選單中的 NativeMenuItem 物件陣列。
NativeMenu
      numItems : int
[唯讀] 此選單中的 NativeMenuItem 物件數目。
NativeMenu
      parent : NativeMenu
[唯讀] 父選單。
NativeMenu
公用方法
 方法定義自
  
    NativeMenu()
建立新的 NativeMenu 物件。
NativeMenu
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式,以便讓偵聽程式收到事件的通知。
EventDispatcher
  
將選單項目加入至選單底部。
NativeMenu
  
將選單項目插入指定位置。
NativeMenu
  
    addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem
插入新的選單項目以便將子選單加入至選單。
NativeMenu
  
    addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem
將新的選單項目插入指定位置,以便將子選單加入選單。
NativeMenu
  
    clone():NativeMenu
建立選單與所有項目的副本。
NativeMenu
  
報告此選單是否包含指定的選單項目。
NativeMenu
 Inherited
會將事件傳送到事件流程。
EventDispatcher
  
    display(stage:Stage, stageX:Number, stageY:Number):void
在指定位置彈出此選單。
NativeMenu
  
取得指定索引位置的選單項目。
NativeMenu
  
取得指定名稱的選單項目。
NativeMenu
  
取得指定項目的位置。
NativeMenu
 Inherited
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。
EventDispatcher
 Inherited
指出物件是否有已定義的指定屬性。
Object
 Inherited
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。
Object
 Inherited
指出指定的屬性是否存在,以及是否可列舉。
Object
  
移除選單的所有項目。
NativeMenu
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
會從 EventDispatcher 物件移除偵聽程式。
EventDispatcher
  
移除特定選單項目。
NativeMenu
  
移除並傳回位於指定索引位置的選單項目。
NativeMenu
  
    setItemIndex(item:NativeMenuItem, index:int):void
將選單項目移至指定位置。
NativeMenu
 Inherited
為迴圈作業設定動態屬性的可用性。
Object
 Inherited
傳回代表此物件的字串,根據地區特定慣例進行格式化。
Object
 Inherited
會傳回指定之物件的字串形式。
Object
 Inherited
會傳回指定之物件的基本值。
Object
 Inherited
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式,或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。
EventDispatcher
事件
 事件 摘要 定義自
 Inherited[廣播事件] 當 Flash Player 或 AIR 應用程式取得作業系統焦點並成為作用中時傳送。EventDispatcher
 Inherited[廣播事件] 當 Flash Player 或 AIR 應用程式失去作業系統焦點並成為非作用中時傳送。EventDispatcher
  
    displaying
在顯示選單之前,由此 NativeMenu 物件立即傳送。NativeMenu
  
    preparing
在按下對等按鍵但尚未顯示選單之前,會由 NativeMenu 物件傳送。NativeMenu
  
    select
在選取了所屬的任何一個選單項目或是所屬子選單後代 (任何一個) 中的某個項目時,由此 NativeMenu 物件傳送。NativeMenu
屬性詳細資訊
    

isSupported

屬性
isSupported:Boolean  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: AIR 2.0

指出用戶端系統是否支援原生選單的任何形式。



實作
    public static function get isSupported():Boolean

相關 API 元素

    

items

屬性 
items:Array

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

此選單中的 NativeMenuItem 物件陣列。

此陣列是依照顯示順序來排序。

注意:這個屬性在 AIR 1.0 中為唯讀,但自 AIR 1.1 起已改為可讀寫。



實作
    public function get items():Array
    public function set items(value:Array):void
    

numItems

屬性 
numItems:int  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

此選單中的 NativeMenuItem 物件數目。



實作
    public function get numItems():int
    

parent

屬性 
parent:NativeMenu  [唯讀]

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

父選單。

根 (最頂層) 選單物件的 parent 會是 null



實作
    public function get parent():NativeMenu
建構函式詳細資料
    

NativeMenu

()建構函式
public function NativeMenu()

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

建立新的 NativeMenu 物件。

方法詳細資訊

    addItem

()方法
public function addItem(item:NativeMenuItem):NativeMenuItem

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

將選單項目加入至選單底部。

建立快顯選單時,您可以加入 NativeMenuItem 或 ContextMenuItem 物件。不過,建議整個快顯選單只用一種物件類型,以確保選單中的所有項目具有相同的屬性。

注意:如果項目的子選單是設定成選單本身 (形成循環參考),則將項目加到選單後會造成應用程式當機。

參數

item:NativeMenuItem — 要加入至選單底部的 NativeMenuItem 物件。

傳回值
NativeMenuItem

擲回值
ArgumentError — 如果 itemnull
 
ArgumentError — 如果 item 是另一個選單的成員。

    addItemAt

()方法 
public function addItemAt(item:NativeMenuItem, index:int):NativeMenuItem

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

將選單項目插入指定位置。會從頂端編製該位置的索引。將 index 參數設定為零,以便在選單頂端插入項目。所有類型的選單:視窗、應用程式、系統匣圖示、停駐圖示、快顯選單和彈出式選單,都會從頂端編製選單位置的索引。

參數

item:NativeMenuItem — 要插入的 NativeMenuItem 物件。
 
index:int — 選單中要插入選單項目的 (從零開始) 位置。

注意:如果項目的子選單是設定成選單本身 (形成循環參考),則將項目加到選單後會造成應用程式當機。

傳回值
NativeMenuItem

擲回值
ArgumentError — 如果 itemnull
 
ArgumentError — 如果 item 是另一個選單的成員。
 
RangeError — 如果 index 超出此選單之 items 陣列的邊界。

    addSubmenu

()方法 
public function addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

插入新的選單項目以便將子選單加入至選單。

呼叫 addSubMenu() 方法就相當於建立新的選單項目、將它加入至選單,並將 NativeMenu 物件指定給該項目的 submenu 屬性。

注意:將選單新增為本身的子選單 (循環參考) 會造成應用程式當機。

參數

submenu:NativeMenu — 定義要加入之子選單的 NativeMenu 物件。
 
label:String — 要加入之選單項目的顯示標籤。

傳回值
NativeMenuItem — 針對子選單建立的 NativeMenuItem 物件。

    addSubmenuAt

()方法 
public function addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

將新的選單項目插入指定位置,以便將子選單加入選單。

呼叫 addSubMenuAt() 方法就相當於建立新的選單項目、將它插入選單中所需的位置,並將 NativeMenu 物件指定給該項目的 submenu 屬性。

注意:將選單新增為本身的子選單 (循環參考) 會造成應用程式當機。

參數

submenu:NativeMenu — 定義要加入之子選單的 NativeMenu 物件。
 
index:int — 此選單之 items 陣列中的位置,要在此位置插入要增加的項目。
 
label:String — 要加入之選單項目的顯示標籤。

傳回值
NativeMenuItem — 針對子選單建立的 NativeMenuItem 物件。

    clone

()方法 
public function clone():NativeMenu

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

建立選單與所有項目的副本。

傳回值
NativeMenu

    containsItem

()方法 
public function containsItem(item:NativeMenuItem):Boolean

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

報告此選單是否包含指定的選單項目。

參數

item:NativeMenuItem — 要尋找的 NativeMenuItem 物件。

傳回值
Booleantrue 表示 item 位於此選單中。

    display

()方法 
public function display(stage:Stage, stageX:Number, stageY:Number):void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

在指定位置彈出此選單。

參數

stage:Stage — 要在其中顯示此選單的 Stage 物件。
 
stageX:Number — 水平像素數 (相對於舞台的原點,此選單將在這個位置出現)。
 
stageY:Number — 垂直像素數 (相對於舞台的原點,此選單將在這個位置出現)。

    getItemAt

()方法 
public function getItemAt(index:int):NativeMenuItem

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

取得指定索引位置的選單項目。

參數

index:int — 要傳回之項目的 (從零開始) 位置。

傳回值
NativeMenuItem — 位於選單中指定之位置的 NativeMenuItem 物件。

擲回值
RangeError — 如果 index 超出此選單之 items 陣列的邊界。

    getItemByName

()方法 
public function getItemByName(name:String):NativeMenuItem

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

取得指定名稱的選單項目。

注意:預設不會指派選單項目的 name 屬性。

參數

name:String — 要尋找的字串。

傳回值
NativeMenuItem — 具有指定之名稱的 NativeMenuItem 物件,如果選單中沒有這類項目則為 null

    getItemIndex

()方法 
public function getItemIndex(item:NativeMenuItem):int

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

取得指定項目的位置。

參數

item:NativeMenuItem — 要尋找的 NativeMenuItem 物件。

傳回值
int — 此選單中指定之項目的 (從零開始) 位置,如果選單中沒有該項目則為 -1

    removeAllItems

()方法 
public function removeAllItems():void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

移除選單的所有項目。

    removeItem

()方法 
public function removeItem(item:NativeMenuItem):NativeMenuItem

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

移除特定選單項目。

參數

item:NativeMenuItem — 要從此選單中移除的 NativeMenuItem 物件。

傳回值
NativeMenuItem

擲回值
RangeError — 如果 item 不在此選單中。

    removeItemAt

()方法 
public function removeItemAt(index:int):NativeMenuItem

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

移除並傳回位於指定索引位置的選單項目。

參數

index:int — 要移除之項目的 (從零開始) 位置。

傳回值
NativeMenuItem — 已移除的 NativeMenuItem 物件。

擲回值
RangeError — 如果 index 超出此選單之 items 陣列的邊界。

    setItemIndex

()方法 
public function setItemIndex(item:NativeMenuItem, index:int):void

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

將選單項目移至指定位置。若項目尚未在選單中,呼叫此方法可以將項目新增至選單。

參數

item:NativeMenuItem — 要移動的 NativeMenuItem 物件。
 
index:int — 選單中要移動 item 的 (從零開始) 位置。


擲回值
RangeError — 如果 index 超出此選單之 items 陣列的邊界。
事件詳細資訊
    

displaying

事件
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.DISPLAYING

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

在顯示選單之前,由此 NativeMenu 物件立即傳送。

您可以偵聽此事件,在選單顯示前更新該選單。選單中的項目也會傳送 displaying 事件。

preparing 事件會取代 displaying 事件,並可提供其他功能。偵聽 preparing 事件或 displaying 事件,但不可同時偵聽這兩個事件。

注意: 在 Mac OS X 上,AIR 2.6 之前的選單和選單項目會在使用者按下對等按鍵時傳送 displaying 事件。(在其他作業系統上,並不會在進行對等按鍵互動時傳送此事件)。而在 AIR 2.6 版本,當使用者按下對等按鍵時,將不再傳送 displaying 事件。改用 preparing 事件。

Event.DISPLAYING 常數會定義 displaying 事件物件的 type 屬性值。

注意:這個事件不會經歷「捕捉階段」,而且不管目標是否在顯示清單上,都會直接傳送至目標。

這個事件具有下列屬性:

屬性
bubblesfalse
cancelablefalse
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target將要顯示的 物件。
    

preparing

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.PREPARING

語言版本: ActionScript 3.0
執行階段版本: AIR 2.6

在按下對等按鍵但尚未顯示選單之前,會由 NativeMenu 物件傳送。

在顯示選單之前或是在使用者按下對等按鍵時,偵聽此事件即可更新選單。在完全評估對等按鍵之前,會傳送 preparing 事件。您可以從 preparing 事件處理常式啟用、停用、新增或移除選單中的項目,這些變更將在處理對等按鍵時生效。例如,如果您移除或停用指定給觸發對等按鍵的選單項目,便會取消事件的序列,而且不會傳送 select 事件。選單中的項目也會傳送 preparing 事件。

preparing 事件會取代 displaying 事件,並可提供其他功能。偵聽 preparing 事件或 displaying 事件,但不可同時偵聽這兩個事件。

Event.PREPARING 常數會定義 preparing 事件物件的 type 屬性值。

注意:這個事件不會經歷「捕捉階段」,而且不管目標是否在顯示清單上,都會直接傳送至目標。

這個事件具有下列屬性:

屬性
bubblesfalse
cancelablefalse
currentTarget傳送此事件的物件。
target傳送此事件的物件。
    

select

事件  
事件物件類型: flash.events.Event
屬性 Event.type = flash.events.Event.SELECT

語言版本: ActionScript 3.0
執行階段版本: AIR 1.0

在選取了所屬的任何一個選單項目或是所屬子選單後代 (任何一個) 中的某個項目時,由此 NativeMenu 物件傳送。

select 事件會將選單項目「反昇」至其所屬的選單,並從父選單鏈向上到達根選單物件。此事件物件的 target 屬性會參考所選取的 NativeMenuItem 物件,而 currentTarget 屬性則會參考此 NativeMenu 物件。

Event.SELECT 常數會定義 select 事件物件的 type 屬性值。

這個事件具有下列屬性:

屬性
bubblesfalse
cancelablefalse;沒有要取消的預設行為指令。
currentTarget正主動使用事件偵聽程式處理 Event 物件的物件。
target已經選取項目的物件。




[ X ]為什麼顯示英文?
「ActionScript 3.0 參考」的內容是以英文顯示

並非所有「ActionScript 3.0 參考」的內容都翻譯為所有語言。當語言元素未翻譯時,就會以英文顯示。例如,ga.controls.HelpBox 類別並沒有翻譯為任何語言。因此在參考的繁體中文版本中,ga.controls.HelpBox 類別就會以英文顯示。