ActionBar 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。
[Android.Runtime.Register("android/app/ActionBar", DoNotGenerateAcw=true)]
public abstract class ActionBar : Java.Lang.Object[<Android.Runtime.Register("android/app/ActionBar", DoNotGenerateAcw=true)>]
type ActionBar = class
inherit Object- 繼承
- 屬性
備註
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 從 Android 3.0（API 等級 11）開始，當活動使用系統的全息主題（或其後繼主題之一）時，動作列會出現在視窗頂端，這是預設的。 你也可以透過呼叫 requestFeature（FEATURE_ACTION_BAR） 或在自訂主題中使用 windowActionBar 屬性宣告該動作列來新增。
從 Android L（API 等級 21）開始，動作列可由應用程式版面中的任何工具列小工具表示。 應用程式可能會向活動區指示哪個工具列應被視為該活動的動作列。 使用此功能的活動應使用提供的其中一種。NoActionBar 主題，將 windowActionBar 屬性設為 false，否則不要請求視窗功能。
透過調整主題要求的視窗功能及活動內容檢視的版面配置，應用程式可在舊平台使用標準系統動作列，在新平台版本使用較新的內嵌工具列。 從活動中取得的 ActionBar 物件可用於透明地控制任一配置。
使用全息主題時，動作列左側會顯示應用程式圖示，接著是活動標題。 如果你的活動有選項選單，你可以直接從行動列中選取部分項目，稱為「行動項目」。 你也可以修改動作條的各種特性，或完全移除它。
使用 Material 主題（API 21 或更新版本預設）時，導覽按鈕（前稱「Home」）會取代先前應用程式圖示所佔用的空間。 想要更強品牌形象的應用程式，應在動作列及其他應用程式的 Chrome 中大量使用品牌色彩，或以標誌取代標準標題文字。
你可以從你的活動中呼叫 getActionBar（） 來取得 ActionBar 的實例。
在某些情況下，動作列可能會被另一個可啟用情境動作的行動列覆蓋，使用動作模式。 例如，當使用者在你的活動中選擇一個或多個項目時，你可以啟用一個針對所選項目的特定動作模式，並有介面暫時取代動作欄。 雖然使用者介面可能佔用相同空間，但 ActionMode 的 API 與 ActionBar 的 API 是獨立且不同的。
關於如何使用動作列，包括如何新增動作項目、導航模式等，請閱讀動作列開發者指南。
Android 參考資料。android.app.ActionBar
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| ActionBar() | |
| ActionBar(IntPtr, JniHandleOwnership) |
初始化現有 Java 原生介面物件的受管理表示。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| CustomView | |
| DisplayOptions | |
| Elevation |
取得動作條的 Z 軸仰角（像素數）。 -或- 將動作條的 Z 軸仰角設為像素。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| Height |
讀取動作條目前的高度。 |
| HideOffset |
回傳動作條目前的垂直偏移量。 -或- 設定動作條目前的隱藏偏移。 |
| HideOnContentScrollEnabled |
回傳動作列是否設定為滾動消失，並附上 |
| IsShowing | |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 (繼承來源 JavaObject) |
| JniPeerMembers |
提供 Android.App.ActionBar 的 JNI 綁定基礎架構。 |
| NavigationItemCount |
此方法在 API 等級 21 中被棄用。 |
| NavigationMode |
此方法在 API 等級 21 中被棄用。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| SelectedNavigationIndex |
此方法在 API 等級 21 中被棄用。 |
| SelectedTab |
此方法在 API 等級 21 中被棄用。 |
| Subtitle | |
| SubtitleFormatted |
標準模式下會回傳目前的 ActionBar 字幕。 |
| TabCount |
此方法在 API 等級 21 中被棄用。 |
| ThemedContext |
回傳 |
| ThresholdClass |
提供 Android.App.ActionBar 的 JNI 綁定基礎架構。 |
| ThresholdType |
提供 Android.App.ActionBar 的 JNI 綁定基礎架構。 |
| Title | |
| TitleFormatted |
標準模式下會回傳目前的 ActionBar 標題。 |
方法
事件
| 名稱 | Description |
|---|---|
| MenuVisibility | |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
活動內的主要工具列，可能顯示活動標題、應用程式層級的導航功能及其他互動項目。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |