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）開始，當活動使用系統 android.R.style#Theme_Holo Holo 的主題（或其其中一個子系主題）時，動作列會出現在活動視窗頂端，這是預設值。 否則，您可以呼叫 android.view.Window#requestFeature requestFeature(FEATURE_ACTION_BAR) 或使用 屬性在自定義主題 android.R.styleable#Theme_windowActionBar windowActionBar 中宣告動作列，以新增動作列。
從 Android L （API 層級 21 開始），動作列可以由應用程式配置內的任何工具列小工具表示。 應用程式可能會向活動發出訊號，其中工具列應視為活動的動作列。 使用此功能的活動應該使用其中一個提供 .NoActionBar 的主題、將屬性設定 android.R.styleable#Theme_windowActionBar windowActionBar 為 false ，否則不會要求視窗功能。
藉由調整主題所要求的視窗功能，以及用於活動內容檢視的配置，應用程式可以在較舊的平臺版本上使用標準系統動作列，並在較新的平臺版本中使用較新的內嵌工具列。 ActionBar從 Activity 取得的物件可用來以透明方式控制任一組態。
使用 Holo 主題時，動作列會顯示左側的應用程式圖示，後面接著活動標題。 如果您的活動有選項功能表，您可以直接從動作列存取選取專案做為「動作專案」。 您也可以修改動作列的各種特性，或完全移除它。
使用 [材料] 主題時（API 21 或更新版本預設）流覽按鈕（先前稱為「首頁」）會接管應用程式圖示先前佔用的空間。 想要表達更強品牌的應用程式應該在動作列和其他應用程式 Chrome 中大量使用其品牌色彩，或使用 #setLogo(int) logo 取代其標準標題文字。
從您的活動，您可以藉由呼叫 android.app.Activity#getActionBar getActionBar()來擷取的ActionBar實例。
在某些情況下，動作列可能會由另一個啟用內容動作的列重疊，使用 android.view.ActionMode。 例如，當使用者在活動中選取一或多個專案時，您可以啟用動作模式，以提供所選項目專屬的動作，以及暫時取代動作列的UI。 雖然UI可能會佔用相同的空間， android.view.ActionMode 但API與的 ActionBarAPI不同且獨立。
<div class=“special reference”><h3>Developer Guides</h3>
如需如何使用動作列的詳細資訊，包括如何新增動作專案、流覽模式等等，請參閱 動作列 開發人員指南。
</div>
的 android.app.ActionBarJava 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
建構函式
| ActionBar() | |
| ActionBar(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
屬性
| Class |
傳回這個 |
| CustomView | |
| DisplayOptions | |
| Elevation |
以像素為單位取得動作列的 Z 軸高度。 -或- 以像素為單位設定動作列的 Z 軸高度。 |
| Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
| Height |
擷取 ActionBar 的目前高度。 |
| HideOffset |
傳回動作列的目前垂直位移。 -或- 設定動作列的目前隱藏位移。 |
| HideOnContentScrollEnabled |
傳回動作列是否已設定為捲動出視線以及 |
| IsShowing | |
| JniIdentityHashCode |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| JniPeerMembers |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 |
| NavigationItemCount |
取得目前流覽模式中存在的瀏覽項目數目。 |
| NavigationMode |
傳回目前的流覽模式。 |
| PeerReference |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| SelectedNavigationIndex |
取得所選取瀏覽項目在清單或索引標籤瀏覽模式中的位置。 |
| SelectedTab |
如果處於索引標籤導覽模式，且至少有一個索引標籤存在，則傳回目前選取的索引標籤。 |
| Subtitle |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 |
| SubtitleFormatted |
傳回標準模式中的目前 ActionBar 子標題。 |
| TabCount |
傳回目前向動作列註冊的索引標籤。 |
| ThemedContext |
傳 |
| ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。 |
| Title |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 |
| TitleFormatted |
傳回標準模式中的目前 ActionBar 標題。 |
方法
| AddOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
新增會回應功能表可見度變更事件的接聽程式。 |
| AddTab(ActionBar+Tab, Boolean) |
已淘汰.
新增索引標籤以用於索引標籤模式。 |
| AddTab(ActionBar+Tab, Int32, Boolean) |
已淘汰.
新增索引標籤以用於索引標籤模式。 |
| AddTab(ActionBar+Tab, Int32) |
已淘汰.
新增索引標籤以用於索引標籤模式。 |
| AddTab(ActionBar+Tab) |
已淘汰.
新增索引標籤以用於索引標籤模式。 |
| Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
| Dispose() |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| Dispose(Boolean) |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
| GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
| GetTabAt(Int32) |
已淘汰.
傳回指定索引處的索引標籤。 |
| Hide() |
如果目前顯示 ActionBar，請隱藏它。 |
| JavaFinalize() |
當垃圾收集決定不再參考物件時，垃圾收集行程在 物件上呼叫。 (繼承來源 Object) |
| NewTab() |
已淘汰.
建立並傳回新的 ActionBar.Tab。 |
| Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
| NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
| RemoveAllTabs() |
已淘汰.
從動作列移除所有索引標籤，然後取消選取目前的索引標籤。 |
| RemoveOnMenuVisibilityListener(ActionBar+IOnMenuVisibilityListener) |
拿掉選單可見性接聽程式。 |
| RemoveTab(ActionBar+Tab) |
已淘汰.
從動作列移除索引標籤。 |
| RemoveTabAt(Int32) |
已淘汰.
從動作列移除索引標籤。 |
| SelectTab(ActionBar+Tab) |
已淘汰.
選取指定的索引標籤。 |
| SetBackgroundDrawable(Drawable) |
設定 ActionBar 的背景。 |
| SetCustomView(Int32) |
將動作列設定為自定義導覽模式，並提供自定義導覽的檢視。 |
| SetCustomView(View, ActionBar+LayoutParams) |
將動作列設定為自定義導覽模式，並提供自定義導覽的檢視。 |
| SetDisplayHomeAsUpEnabled(Boolean) |
設定是否應該將家庭顯示為「向上」能供性。 |
| SetDisplayOptions(ActionBarDisplayOptions, ActionBarDisplayOptions) |
設定選取的顯示選項。 |
| SetDisplayShowCustomEnabled(Boolean) |
如果設定，請設定是否應該顯示自定義檢視。 |
| SetDisplayShowHomeEnabled(Boolean) |
設定是否要在動作列中包含應用程式家用能供性。 |
| SetDisplayShowTitleEnabled(Boolean) |
設定是否應該顯示活動標題/副標題。 |
| SetDisplayUseLogoEnabled(Boolean) |
設定是否要顯示活動標誌，而不是活動圖示。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetHomeActionContentDescription(ICharSequence) |
啟用時，設定 Home/Up 動作的替代描述。 |
| SetHomeActionContentDescription(Int32) |
啟用時，設定 Home/Up 動作的替代描述。 |
| SetHomeActionContentDescription(String) |
啟用時，設定 Home/Up 動作的替代描述。 |
| SetHomeAsUpIndicator(Drawable) |
在啟用時 |
| SetHomeAsUpIndicator(Int32) |
在啟用時 |
| SetHomeButtonEnabled(Boolean) |
啟用或停用動作列角落的 [首頁] 按鈕。 |
| SetIcon(Drawable) |
設定圖示以顯示在動作列的 [首頁] 區段中。 |
| SetIcon(Int32) |
設定圖示以顯示在動作列的 [首頁] 區段中。 |
| SetListNavigationCallbacks(ISpinnerAdapter, ActionBar+IOnNavigationListener) |
已淘汰.
設定清單流覽模式的配接器和導覽回呼。 |
| SetLogo(Drawable) |
設定要在動作列的 [首頁] 區段中顯示的標誌。 |
| SetLogo(Int32) |
設定要在動作列的 [首頁] 區段中顯示的標誌。 |
| SetSelectedNavigationItem(Int32) |
已淘汰.
在清單或索引標籤式流覽模式中設定選取的瀏覽專案。 |
| SetSplitBackgroundDrawable(Drawable) |
設定 ActionBar 的分割背景。 |
| SetStackedBackgroundDrawable(Drawable) |
設定 ActionBar 的堆疊背景。 |
| SetSubtitle(Int32) |
設定動作列的副標題。 |
| SetTitle(Int32) |
設定動作列的標題。 |
| Show() |
如果目前未顯示，則顯示 ActionBar。 |
| ToArray<T>() |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| Wait() |
讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object) |
| Wait(Int64, Int32) |
讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object) |
| Wait(Int64) |
讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object) |
事件
| MenuVisibility |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 |
明確介面實作
| IJavaPeerable.Disposed() |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| IJavaPeerable.Finalized() |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| IJavaPeerable.JniManagedPeerState |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 (繼承來源 Object) |
擴充方法
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
| JavaCast<TResult>(IJavaObject) |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 |
| GetJniTypeName(IJavaPeerable) |
活動內的主要工具列，可能會顯示活動標題、應用層級導覽能供性和其他互動式專案。 |