NativeMenuItem  - AS3

控制是否讓此選單項目顯示核取記號。

與此選單項目關聯的任意資料物件。

您可以將任何物件指派給此屬性。雖然選單系統不會使用指定的物件，但是此物件可供事件處理程式碼使用 (透過事件物件的 target 屬性)。根據預設，這個屬性的值為 null。

控制是否啟用此選單項目。

報告此項目是否為選單分隔符號字行。

您可以在 NativeMenuItem 建構函式中將 isSeparator 參數設定為 true 以建立分隔符號字行。

相當於此選單項目的按鍵。

請使用小寫字母來設定 keyEquivalent，以便指定不含 Shift 輔助按鍵的快速鍵。請使用大寫字母來設定，以便指定包含 Shift 輔助按鍵的快速鍵。

根據預設，按鍵修飾詞 (在 Windows 或 Linux 中為 Ctrl，在 Mac OS X 中為 Command) 已納入為對應鍵的一部分。如果您希望對等按鍵只是單純的按鍵 (不包含修飾詞)，請將 keyEquivalentModifiers 屬性設定為空的陣列。

相當於按鍵修飾詞的按鍵碼值陣列。

您可以使用 Keyboard 類別中定義的常數，指定修飾詞按鍵碼。有效的修飾詞按鍵包含：

• Keyboard.ALTERNATE
• Keyboard.COMMAND
• Keyboard.CONTROL

如果您沒有指定任何修飾詞，依預設 Windows 或 Linux 就會指定 Keyboard.CONTROL 鍵，而 Mac OS X 則指定 Keyboard.COMMAND 鍵。若您不希望對應鍵包含這些修飾詞，請將此屬性設定為空陣列。

如果您將大寫字母指定給 keyEquivalent 屬性，Shift 鍵就會自動當做修飾詞使用。將 keyEquivalentModifier 設定為空的陣列並不會移除當做修飾詞使用的 Shift 鍵。

相關 API 元素

此選單項目的顯示字串。

包含此項目的選單。

選單項目標籤中的記憶鍵字元位置。

位於指定位置的字元就是選單項目的記憶鍵字元。索引是從零開始，因此第一個字元的索引為 0。

在不使用選單記憶鍵的作業系統中，此屬性會遭忽略。

此選單項目的名稱。

此名稱值不會顯示，而且可以當做與地區設定無關的識別名稱使用。不會自動指定名稱。

與此選單項目關聯的子選單。

如果將 NativeMenu 物件指定給此屬性，便會變更此選單項目的外觀和行為指令。子選單項目會顯示子選單圖示，並且不會再傳送 select 事件。

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

相關 API 元素

建立新的 NativeMenuItem 物件。

若要建立選單命令，請將 label 參數設定為包含顯示標籤的字串，以及將 isSeparator 設定為 false。

若要建立子選單命令，請建立命令項目，再將子選單的 NativeMenu 物件指定給該項目的 submenu 屬性。然後，再將該項目加入至父選單。

若要建立分隔符號，請將 label 參數設定為空字串，以及將 isSeparator 設定為 true。

請使用 NativeMenu 的 addItem() 和 removeItem() 方法，在選單中新增或移除項目。

相關 API 元素

建立 NativeMenuItem 物件的副本。

傳回包含 NativeMenuItem 物件所有屬性的字串。

在顯示包含項目的選單之前，由此 NativeMenuItem 物件立即傳送。

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

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

這個事件具有下列屬性：

在按下對等按鍵，但尚未顯示所屬的選單之前，會由此 NativeMenuItem 物件傳送。

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

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

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

這個事件具有下列屬性：

每當使用者選取了選單項目時傳送。

select 事件將從此項目「反昇」至其包含的選單，並從父選單鏈向上到達根選單物件。此事件物件的 target 屬性會參考此 NativeMenuItem 物件，而 currentTarget 屬性則會參考傳送的物件 (此 NativeMenuItem 或祖系 NativeMenu 物件)。

注意：如果包含此選單的視窗處於全螢幕模式 (stage.displayState == StageDisplayState.FULL_SCREEN)，當使用者輸入某個選單項目的鍵盤相對按鍵時，NativeMenuItem 物件便「不會」傳送 select 事件。

這個事件具有下列屬性：