Activity 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
活動是使用者可以執行的單一焦點事項。
[Android.Runtime.Register("android/app/Activity", DoNotGenerateAcw=true)]
public class Activity : Android.Views.ContextThemeWrapper, Android.Content.IComponentCallbacks2, Android.Views.KeyEvent.ICallback, Android.Views.LayoutInflater.IFactory2, Android.Views.View.IOnCreateContextMenuListener, Android.Views.Window.ICallback, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/app/Activity", DoNotGenerateAcw=true)>]
type Activity = class
inherit ContextThemeWrapper
interface IComponentCallbacks
interface IJavaObject
interface IDisposable
interface IJavaPeerable
interface IComponentCallbacks2
interface KeyEvent.ICallback
interface LayoutInflater.IFactory
interface LayoutInflater.IFactory2
interface View.IOnCreateContextMenuListener
interface Window.ICallback
- 繼承
- 衍生
- 屬性
- 實作
備註
活動是使用者可以執行的單一焦點事項。 幾乎所有活動都會與用戶互動,因此 Activity 類別會為您建立視窗,讓您能夠使用 #setContentView
放置 UI。 雖然活動通常會向用戶呈現為全螢幕視窗,但也可以透過已設定) 、 多視窗模式或內嵌至其他視窗的主題android.R.attr#windowIsFloating
,以其他方式使用:浮動視窗 (。
活動幾乎所有子類別都有兩種方法會實作:
<ul><li>#onCreate
是您初始化活動的位置。 最重要的是,您通常會使用定義UI的配置資源呼叫 #setContentView(int)
,並使用 #findViewById
來擷取該 UI 中需要以程式設計方式互動的小工具。
<li>#onPause
是您處理使用者暫停活動互動的位置。 此時,使用者所做的任何變更都應該認可 (通常會認可至 android.content.ContentProvider
保留數據) 。 在此狀態中,活動仍會顯示在螢幕上。 </ul>
若要搭配 android.content.Context#startActivity Context.startActivity()
使用,所有活動類別都必須在其套件 的 AndroidManifest.xml
中具有對應的android.R.styleable#AndroidManifestActivity <activity>
宣告。
這裡涵蓋的主題:ol li Fragments<li Activity Lifecycle li>Configuration Changes<li>Starting Activities and Getting Results<>li Saving Persistent State><li>Permissions<li>Process Lifecycle<</ol<><>>
<div class=“special reference”><h3>Developer Guides</h3>
Activity 類別是應用程式整體生命週期的重要部分,而且活動啟動和組合的方式是平臺應用程式模型的基本部分。 如需 Android 應用程式結構的詳細觀點,以及活動的運作方式,請參閱 應用程式基本概念 和 工作和返回堆疊 開發人員指南。
您也可以在 活動 開發人員指南中找到有關如何建立活動的詳細討論。
</Div>
“Fragments”><h3>Fragments</h3>
androidx.fragment.app.FragmentActivity
子類別可以使用 androidx.fragment.app.Fragment
類別,將程式代碼更模組化、為較大的螢幕建置更複雜的使用者介面,並協助在小型和大型螢幕之間調整其應用程式。
如需使用片段的詳細資訊,請參閱 片段 開發人員指南。
“ActivityLifecycle”><h3>活動生命週期</h3>
系統中的活動會以 活動堆疊的形式管理。 啟動新活動時,它通常會放在目前堆疊的頂端,並變成執行中的活動-- 先前的活動一律會保留在堆疊中,而且在新的活動結束之前,不會再次進入前景。 畫面上可以顯示一或多個活動堆疊。
活動基本上有四種狀態:
<ul>li 如果活動位於畫面的前景, (位於最上層堆疊) 的最高位置,則會是 <em>active</em> 或 <em>running</em>。>< 這通常是使用者目前正在互動的活動。</li li><>如果活動失去焦點,但仍向用戶呈現,則會<是 em>visible</em。> 如果新的非完整大小或透明活動著重於活動頂端、另一個活動在多視窗模式中具有較高的位置,或活動本身無法在目前的視窗模式中焦點,則有可能。 這類活動完全保持運作, (它會維護所有狀態和成員資訊,並維持附加至視窗管理員) 。 <li>如果活動完全被另一個活動遮蔽,則會 <是 em>stopped</em> 或 <em>hidden</em>。 它仍會保留所有狀態和成員資訊,不過,用戶無法再看到它,因此其視窗會隱藏,而且當其他位置需要記憶體時,系統通常會將其終止。</li li><>系統可以藉由要求活動完成,或直接終止其程式,使<活動成為損>毀</em>,從記憶體中卸除活動。 再次向用戶顯示時,必須完全重新啟動並還原至其先前的狀態。</li></ul>
下圖顯示活動的重要狀態路徑。 方形矩形代表您可以實作的回呼方法,以在活動在狀態之間移動時執行作業。 彩色橢圓形是活動可以位於的主要狀態。
<img src=“../../../images/activity_lifecycle.png“ alt=”Android 活動生命週期的狀態圖。 border=“0” />
您可能有興趣監視活動內的三個主要循環:
<ul><li>活動<>整個存留期</b> 會在第一次呼叫 android.app.Activity#onCreate
到 的單一最終呼叫android.app.Activity#onDestroy
之間發生。 活動會在 onCreate () 中執行所有「全域」狀態的設定,並在 onDestroy () 中釋放所有剩餘的資源。 例如,如果線程在背景中執行以從網路下載數據,它可能會在 onCreate () 中建立該線程,然後在 onDestroy () 中停止線程。
<li>活動的 <b>可見存留期</b> 會在呼叫 android.app.Activity#onStart
之間發生,直到對應的呼叫為止 android.app.Activity#onStop
。 在這段期間,使用者可以看到螢幕上的活動,但可能不在前景並與用戶互動。 在這兩種方法之間,您可以維護向用戶顯示活動所需的資源。 例如,您可以在 onStart () 中註冊 android.content.BroadcastReceiver
,以監視影響 UI 的變更,並在使用者不再看到您顯示的內容時將其取消註冊在 onStop () 中。 onStart () 和 onStop () 方法可以多次呼叫,因為活動變成可見且隱藏給使用者。
<li>活動><的前景存留期</b> 會在 呼叫 android.app.Activity#onResume
之間發生,直到對應的呼叫為止android.app.Activity#onPause
。 在這段期間,活動可見、作用中且與用戶互動。 活動通常會在繼續狀態和暫停狀態之間切換 -- 例如當裝置進入睡眠狀態、傳遞活動結果時、傳遞新的意圖時,-- 因此這些方法中的程式代碼應該相當輕量。 </ul>
活動的整個生命週期是由下列 Activity 方法所定義。 所有這些都是您可以覆寫的勾點,以在活動變更狀態時執行適當的工作。 所有活動都會實 android.app.Activity#onCreate
作以執行其初始設定;許多活動也會實 android.app.Activity#onPause
作 來認可數據的變更,並準備暫停與用戶互動,並 android.app.Activity#onStop
處理畫面上不再顯示。 實作這些方法時,您應該一律呼叫超級類別。
</p>
public class Activity extends ApplicationContext {
protected void onCreate(Bundle savedInstanceState);
protected void onStart();
protected void onRestart();
protected void onResume();
protected void onPause();
protected void onStop();
protected void onDestroy();
}
一般而言,透過活動生命週期的移動看起來如下:
<table border=“2” width=“85%” align=“center” frame=“hsides” rules=“rows”><colgroup align=“left” span=“3” /colgroup align=“left”>< /><colgroup align=“center” /><colgroup align=“center” />
<thead><tr><th colspan=“3”>Method</><th>th Description</><th killable>?</th><th>Next</th></tr></thead>
<tbody tr td colspan=“3” align=“left” border=“0”>android.app.Activity#onCreate onCreate()
</td td><>第一次建立活動時呼叫。><>< 這是您應該執行所有一般靜態設定的位置:建立檢視、將數據系結至清單等等。這個方法也會提供一個套件組合,其中包含活動先前凍結的狀態,如果有的話。
一律後面接著 onStart()
。</td td align=“center”>No</td td<>align=“center”><onStart()
/td></tr><>
<tr><td rowspan=“5” style=“border-left: none; border-right: none;”> </td td colspan=“2” align=“left” border=“0”<>android.app.Activity#onRestart onRestart()
/td td><>在活動停止之後呼叫,再重新啟動。><
一律後面接著 onStart()
/td td<>align=“center”>No</td td><align=“center”>onStart()
</td<>/tr<>
<tr><td colspan=“2” align=“left” border=“0”>android.app.Activity#onStart onStart()
</td td><>當活動變成用戶可見時呼叫。
onResume()
接著,如果活動出現在前景,或onStop()
變成隱藏狀態,則接著。</td td align=“center”>No</td td<>align=“center”>onResume()
or onStop()
</td></tr><>
<tr><td rowspan=“2” style=“border-left: none;”> </td td td align=“left” border=“0”><android.app.Activity#onResume onResume()
/td td><>當活動開始與用戶互動時呼叫。>< 此時,您的活動位於其活動堆疊的頂端,且使用者輸入會移至該堆棧。
一律後面接著 onPause()
。</td td align=“center”>No</td td<>align=“center”><onPause()
/td></tr><>
<當活動失去前景狀態時,tr><td align=“left” border=“0”>android.app.Activity#onPause onPause()
</td td><>呼叫,不再為焦點,或轉換至停止/隱藏或終結狀態之前。 使用者仍然可以看到活動,因此建議您以可視化方式保持作用中,並繼續更新UI。 此方法的實作必須非常快速,因為在此方法傳回之前,將不會繼續下一個活動。
onResume()
接著,如果活動回到前端,或onStop()
使用者看不見,則接著。</td td align=“center”><font color=“#800000”><strong Pre-android.os.Build.VERSION_CODES#HONEYCOMB
</strong>></font></td td><align=“center”onResume()
> or<br>onStop()
</td></tr><>
<tr><td colspan=“2” align=“left” border=“0”>android.app.Activity#onStop onStop()
</td td><>當活動不再顯示給使用者時呼叫。 這可能是因為啟動新的活動,而現有的活動正在進入此活動之前,或正在終結此活動。 這通常用來停止動畫和重新整理UI等等。
onRestart()
接著,如果此活動回到與用戶互動,或onDestroy()
此活動即將消失,則接著。</td td align=“center”><font color=“#800000”><strong Yes</strong>></font></td td><align=“center”>onRestart()
or<br>onDestroy()
</td/td></tr><>
<tr><td colspan=“3” align=“left” border=“0”>android.app.Activity#onDestroy onDestroy()
</td td><>在您活動終結之前收到的最終呼叫。 可能是因為活動正在 (有人在) 上呼叫 Activity#finish
,或因為系統暫時終結此活動的實例來節省空間,所以可能會發生這種情況。 您可以使用 方法區分這兩個案例Activity#isFinishing
。</td td align=“center”><font color=“#800000”><strong Yes</strong>></font></td td<>align=“center”><em nothing</em>></td<>/><tbody></table><>
請注意上表中的 「Killable」 資料行 -- 針對標示為可終止的方法,在該方法傳回裝載活動的進程之後,系統 <em>< 可以隨時終止裝載活動的進程/em>,而不會執行其程式代碼的另一行。 因此,您應該使用 #onPause
方法來寫入任何持續性數據 (,例如使用者編輯) 至記憶體。 此外,在將活動置於這類背景狀態之前,會先呼叫 方法 #onSaveInstanceState(Bundle)
,讓您將活動中的任何動態實例狀態儲存到指定的套件組合中,以便在稍後需要重新建立活動時收到 #onCreate
。 如需處理程式生命週期如何系結至其裝載之活動的詳細資訊,請參閱程式生命週期一節。 請注意,請務必在 中 #onPause
儲存永續性數據,而不是 #onSaveInstanceState
因為後者不是生命週期回呼的一部分,因此不會在其檔中所述的每個情況下呼叫。
<p class=“note”>請注意,這些語意會在從 開始 android.os.Build.VERSION_CODES#HONEYCOMB
與先前平臺為目標的應用程式之間稍微變更。 從 Honeycomb 開始,應用程式在傳回之前 #onStop
不會處於可終止狀態。 這會影響呼叫 (#onSaveInstanceState(Bundle)
在) 之後 #onPause()
可能會安全地呼叫,並允許應用程式安全地等候直到 #onStop()
儲存持續性狀態為止。</P>
<p class=“note”>針對以 開頭 android.os.Build.VERSION_CODES#P
#onSaveInstanceState(Bundle)
之平臺的應用程式一律會在 之後 #onStop
呼叫,因此應用程式可以在 中安全地執行片段交易 #onStop
,且稍後能夠儲存持續性狀態。</P>
對於未標示為可終止的方法,從呼叫 方法並繼續之後,系統將不會終止活動的進程。 因此,活動處於可終止狀態,例如,在 之後 onStop()
到的 onResume()
開頭之間。 請記住,在極端的記憶體壓力下,系統可以隨時終止應用程式進程。
“ConfigurationChanges”><h3>組態變更</h3>
如果類別所 Configuration Resources.Configuration
定義的裝置組態 () 變更,則任何顯示使用者介面的專案都必須更新以符合該設定。 由於 Activity 是與用戶互動的主要機制,因此它包含處理組態變更的特殊支援。
除非您另有指定,否則組態變更 (例如螢幕方向、語言、輸入裝置等變更,) 會導致您目前的活動遭到em損毀</em>,並視需要執行、和 #onDestroy
的#onPause
#onStop
一般活動<生命週期>程式。 如果活動已在前景或使用者看得見,一旦 #onDestroy
在該實例中呼叫,就會建立活動的新實例,並建立任何 savedInstanceState 先前實例所產生的 #onSaveInstanceState
實例。
這是因為任何應用程式資源,包括版面配置檔案,都可以根據任何組態值變更。 因此,處理設定變更的唯一安全方式是重新擷取所有資源,包括配置、可繪製專案和字串。 因為活動必須已經知道如何儲存其狀態,並從該狀態重新建立自己,所以這是讓活動以新組態自行重新啟動的便利方式。
在某些特殊情況下,您可能會想要根據一或多個組態變更類型略過活動重新啟動。 這會在其 android.R.attr#configChanges android:configChanges
指令清單中使用 屬性來完成。 針對您說該處處理的任何組態變更類型,您會收到對目前活動方法的 #onConfigurationChanged
呼叫,而不是重新啟動。 不過,如果設定變更牽涉到您未處理的任何專案,活動仍會重新啟動且 #onConfigurationChanged
不會呼叫。
“StartingActivities”><h3>啟動活動和取得結果</h3>
方法 android.app.Activity#startActivity
可用來啟動新的活動,這會放在活動堆疊的頂端。 它會採用單一自變數 , android.content.Intent Intent
其描述要執行的活動。
有時候您想要在活動結束時從活動取得結果。 例如,您可以啟動活動,讓使用者在聯繫人清單中挑選人員;結束時,它會傳回選取的人員。 若要這樣做,您會使用識別呼叫的第二個整數參數來呼叫 android.app.Activity#startActivityForResult(Intent, int)
版本。 結果會透過您的 android.app.Activity#onActivityResult
方法返回。
活動結束時,可以呼叫 android.app.Activity#setResult(int)
以將數據傳回其父代。 它必須一律提供結果碼,可以是標準結果RESULT_CANCELED、RESULT_OK或任何從RESULT_FIRST_USER開始的自定義值。 此外,也可以選擇性地傳回包含其想要之任何其他數據的意圖。 所有此資訊都會出現在父系 的 Activity.onActivityResult()
上,以及原本提供的整數標識碼。
如果子活動因任何原因而失敗 (例如當機) ,父活動將會收到程式代碼RESULT_CANCELED的結果。
public class MyActivity extends Activity {
...
static final int PICK_CONTACT_REQUEST = 0;
public boolean onKeyDown(int keyCode, KeyEvent event) {
if (keyCode == KeyEvent.KEYCODE_DPAD_CENTER) {
// When the user center presses, let them pick a contact.
startActivityForResult(
new Intent(Intent.ACTION_PICK,
new Uri("content://contacts")),
PICK_CONTACT_REQUEST);
return true;
}
return false;
}
protected void onActivityResult(int requestCode, int resultCode,
Intent data) {
if (requestCode == PICK_CONTACT_REQUEST) {
if (resultCode == RESULT_OK) {
// A contact was picked. Here we will just display it
// to the user.
startActivity(new Intent(Intent.ACTION_VIEW, data));
}
}
}
}
“SavingPersistentState”><h3>儲存持續性狀態</h3>
活動通常會處理兩種持續性狀態:共用的檔型數據 (通常會使用 android.content.ContentProvider 內容提供者儲存在 SQLite 資料庫中,) 和內部狀態,例如使用者喜好設定。
針對內容提供者數據,我們建議活動使用「就地編輯」使用者模型。 也就是說,使用者所做的任何編輯都會立即有效地進行,而不需要額外的確認步驟。 支援此模型通常是下列兩個規則的簡單事項:
<ul><li>
建立新檔時,會立即建立其支援資料庫專案或檔案。 例如,如果使用者選擇撰寫新的電子郵件,則會在開始輸入數據時立即建立該電子郵件的新專案,如此一來,如果使用者移至該時間點之後的任何其他活動,此電子郵件現在會出現在草稿清單中。
<li>
呼叫活動的 onPause()
方法時,它應該認可給備份內容提供者或檔案使用者所做的任何變更。 這可確保即將執行的任何其他活動都會看到這些變更。 您可能想要在活動生命週期期間更積極地認可您的數據:例如,在開始新活動之前,在完成您自己的活動之前,當使用者在輸入字段之間切換等等。
</ul>
此模型的設計目的是在使用者巡覽活動時防止數據遺失,並允許系統安全地終止活動 (,因為系統資源在 (停止或在平臺版本上暫停之後 android.os.Build.VERSION_CODES#HONEYCOMB
,隨時需要其他資源) ,然後再) 。 請注意,這表示使用者從您的活動<按BACK不會<>表示>「cancel」 -- 表示讓活動保持儲存的目前內容。 取消活動中的編輯必須透過一些其他機制提供,例如明確的「還原」或「復原」選項。
如需內容提供者的詳細資訊,請參閱 android.content.ContentProvider 內容套件。 這些是不同活動如何自行叫用和傳播數據的重要層面。
Activity 類別也提供 API 來管理與活動相關聯的內部持續性狀態。 例如,這可以用來記住使用者在行事曆 (日檢視或周檢視中慣用的初始顯示,) 或使用者在網頁瀏覽器中的預設首頁。
活動持續性狀態是使用 方法來 #getPreferences
管理,可讓您擷取和修改與活動相關聯的一組名稱/值組。 若要使用跨多個應用程式元件共用的喜好設定, (活動、接收者、服務、提供者) ,您可以使用基礎 Context#getSharedPreferences Context.getSharedPreferences()
方法來擷取儲存在特定名稱下的喜好設定物件。 (請注意,您無法跨應用程式套件共用設定資料-- 您必須有內容提供者。)
以下是行事曆活動的摘錄,其會將使用者慣用的檢視模式儲存在其持續性設定中:
public class CalendarActivity extends Activity {
...
static final int DAY_VIEW_MODE = 0;
static final int WEEK_VIEW_MODE = 1;
private SharedPreferences mPrefs;
private int mCurViewMode;
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
mPrefs = getSharedPreferences(getLocalClassName(), MODE_PRIVATE);
mCurViewMode = mPrefs.getInt("view_mode", DAY_VIEW_MODE);
}
protected void onPause() {
super.onPause();
SharedPreferences.Editor ed = mPrefs.edit();
ed.putInt("view_mode", mCurViewMode);
ed.commit();
}
}
“Permissions”><h3>Permissions</h3>
在指令清單標記 android.R.styleable#AndroidManifestActivity <activity>
中宣告特定活動時,可以強制執行啟動特定活動的能力。 如此一來,其他應用程式就必須在自己的指令清單中宣告對應的 android.R.styleable#AndroidManifestUsesPermission <uses-permission>
元素,才能啟動該活動。
啟動活動時,您可以在意圖上設定 Intent#FLAG_GRANT_READ_URI_PERMISSION Intent.FLAG_GRANT_READ_URI_PERMISSION
和/或 Intent#FLAG_GRANT_WRITE_URI_PERMISSION Intent.FLAG_GRANT_WRITE_URI_PERMISSION
。 這會授與活動對意圖中特定 URI 的存取權。 存取權會維持在活動完成之前, (它將會保留在正在終止的裝載進程中,以及其他暫時性解構) 。 從 開始 android.os.Build.VERSION_CODES#GINGERBREAD
,如果活動已建立,且將新的意圖傳遞至 #onNewIntent(Intent)
,則任何新授與的 URI 許可權都會新增至它所保存的現有 URI 許可權。
如需一般許可權和安全性的詳細資訊,請參閱 安全性和許可權 檔。
“ProcessLifecycle”><h3>進程生命週期</h3>
Android 系統會嘗試盡可能保留應用程式進程,但最終必須在記憶體不足時移除舊的進程。 如活動生命週期所述,決定要移除的程式與使用者與其互動的狀態緊密系結。 一般而言,有四種狀態,程式可以根據在其中執行的活動,依重要性順序列於此處。 系統會先 (最後一個進程) 終止較不重要的進程,再 (第一個程式) 。
<ol><li>
<b>前景活動</b> (使用者目前與) 互動之畫面頂端的活動,會被視為最重要的。 只有在使用比裝置上可用的記憶體還多時,其程式才會終止為最後一個方式。 一般而言,裝置已達到記憶體分頁狀態,因此這是必要專案,才能讓使用者介面保持回應。 <li>
<b>可見活動</b> (使用者看得見但不在前景的活動,例如一個位於前景對話方塊後方,或位於多視窗模式中其他活動的旁邊,) 視為非常重要,除非需要保留前景活動執行,否則不會終止。 <li>
<b>背景活動</b> (使用者看不到的活動,且已停止) 不再重要,因此系統可能會安全地終止其進程,以回收其他前景或可見進程的記憶體。 如果需要終止其程式,當使用者巡覽回活動 (再次在螢幕上顯示) 時,系統會使用先前提供的 #onSaveInstanceState
savedInstanceState 呼叫其 #onCreate
方法,使其可以與使用者上次離開活動相同的狀態重新啟動。 <li>
<b>空進程</b> 是裝載任何活動或其他應用程式元件 (,例如 Service
或 android.content.BroadcastReceiver
類別) 。 當記憶體變低時,系統會非常快速地終止這些事件。 基於這個理由,您在活動外部執行的任何背景作業都必須在活動 BroadcastReceiver 或服務的內容中執行,以確保系統知道它需要讓進程保持四周。 </老>
有時候,活動可能需要執行長時間執行的作業,而該作業與活動生命週期本身無關。 例如,相機應用程式可讓您將圖片上傳至網站。 上傳可能需要很長的時間,而且應用程式應該允許使用者在執行應用程式時離開應用程式。 若要達成此目的,您的活動應該會開始 Service
進行上傳。 這可讓系統適當地設定程序優先順序, (將它視為比其他非可見應用程式在上傳期間) 更重要,與原始活動暫停、停止或完成無關。
此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改,並根據 中所述的詞彙使用。
建構函式
Activity() |
活動是使用者可以執行的單一焦點事項。 |
Activity(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時所使用的建構函式;由運行時間呼叫。 |
欄位
AccessibilityService |
|
AccountService |
搭配 使用 來 |
ActivityService |
使用 搭配 |
AlarmService |
搭配 使用 來 |
AppOpsService |
搭配 |
AppSearchService |
搭配 |
AppwidgetService |
使用 搭配 |
AudioService |
搭配 |
BatteryService |
搭配 |
BindAllowActivityStarts |
已淘汰.
旗標 |
BindExternalServiceLong |
的運作方式 |
BindNotPerceptible |
已淘汰.
旗標: |
BindSharedIsolatedProcess |
已淘汰.
旗 |
BiometricService |
|
BlobStoreService |
|
BluetoothService |
|
BugreportService |
擷取 Bugreport 的服務。 (繼承來源 Context) |
CameraService |
|
CaptioningService |
|
CarrierConfigService |
|
ClipboardService |
|
CompanionDeviceService |
|
ConnectivityDiagnosticsService |
|
ConnectivityService |
|
ConsumerIrService |
|
CredentialService |
|
CrossProfileAppsService |
|
DeviceIdDefault |
默認裝置識別碼,這是主要 (非虛擬) 裝置的標識碼。 (繼承來源 Context) |
DeviceIdInvalid |
無效的裝置識別碼。 (繼承來源 Context) |
DeviceLockService |
|
DevicePolicyService |
使用搭配 |
DisplayHashService |
使用搭配 |
DisplayService |
|
DomainVerificationService |
使用搭配 |
DownloadService |
|
DropboxService |
|
EuiccService |
|
FileIntegrityService |
|
FingerprintService |
|
FullscreenModeRequestEnter |
已淘汰.
要求類型 |
FullscreenModeRequestExit |
已淘汰.
的要求類型 |
GameService |
|
GrammaticalInflectionService |
|
HardwarePropertiesService |
使用搭配 |
HealthconnectService |
|
InputMethodService |
|
InputService |
|
IpsecService |
|
JobSchedulerService |
|
KeyguardService |
|
LauncherAppsService |
|
LayoutInflaterService |
|
LocaleService |
|
LocationService |
|
MediaCommunicationService |
|
MediaMetricsService |
|
MediaProjectionService |
|
MediaRouterService |
|
MediaSessionService |
|
MidiService |
|
NetworkStatsService |
|
NfcService |
|
NotificationService |
|
NsdService |
|
OverlayService |
|
OverrideTransitionClose |
已淘汰.
要求 或 |
OverrideTransitionOpen |
已淘汰.
要求 或 |
PeopleService |
使用與 |
PerformanceHintService |
|
PowerService |
|
PrintService |
|
ReceiverExported |
已淘汰.
旗 |
ReceiverNotExported |
已淘汰.
|
ReceiverVisibleToInstantApps |
已淘汰.
旗 |
RestrictionsService |
|
RoleService |
|
SearchService |
|
SensorService |
使用 搭配 |
ShortcutService |
搭配 |
StatusBarService |
使用 搭配 |
StorageService |
搭配 |
StorageStatsService |
使用搭配 |
SystemHealthService |
搭配 |
TelecomService |
搭配 |
TelephonyImsService |
搭配 |
TelephonyService |
搭配 |
TelephonySubscriptionService |
搭配 |
TextClassificationService |
搭配 |
TextServicesManagerService |
搭配 |
TvInputService |
|
TvInteractiveAppService |
|
UiModeService |
搭配 |
UsageStatsService |
使用搭配 |
UsbService |
|
UserService |
使用 搭配 |
VibratorManagerService |
使用 搭配 |
VibratorService |
使用 搭配 |
VirtualDeviceService |
搭配 |
VpnManagementService |
|
WallpaperService |
搭配 |
WifiAwareService |
搭配 |
WifiP2pService |
搭配 |
WifiRttRangingService |
搭配 |
WifiService |
搭配 |
WindowService |
使用 搭配 |
屬性
ActionBar |
擷取此活動的 ActionBar 參考。 |
Application |
傳回擁有此活動的應用程式。 |
ApplicationContext |
傳回目前進程之單一全域 Application 對象的內容。 (繼承來源 ContextWrapper) |
ApplicationInfo |
傳回此內容套件的完整應用程式資訊。 (繼承來源 ContextWrapper) |
Assets |
傳回應用程式套件的 AssetManager 實例。 (繼承來源 ContextWrapper) |
AttributionSource |
活動是使用者可以執行的單一焦點事項。 (繼承來源 Context) |
AttributionTag |
屬性可用於複雜的應用程式中,以邏輯方式分隔應用程式的部分。 (繼承來源 Context) |
BaseContext | (繼承來源 ContextWrapper) |
CacheDir |
傳回檔案系統上應用程式特定快取目錄的絕對路徑。 (繼承來源 ContextWrapper) |
CallingActivity |
傳回叫用此活動的活動名稱。 |
CallingPackage |
傳回叫用此活動的封裝名稱。 |
ChangingConfigurations |
如果此活動因為無法處理正在變更的組態參數而無法 (,因此其 |
Class |
傳回這個 |
ClassLoader |
傳回可用來擷取此套件中類別的類別載入器。 (繼承來源 ContextWrapper) |
CodeCacheDir |
傳回檔案系統上針對儲存快取程式碼所設計之應用程式特定快取目錄的絕對路徑。 (繼承來源 ContextWrapper) |
ComponentName |
傳回此活動的完整元件名稱。 |
ContentResolver |
傳回應用程式套件的 ContentResolver 實例。 (繼承來源 ContextWrapper) |
ContentScene |
|
ContentTransitionManager |
|
CurrentFocus |
呼叫 |
DataDir |
活動是使用者可以執行的單一焦點事項。 (繼承來源 ContextWrapper) |
DeviceId |
取得與此內容相關聯的裝置標識碼。 (繼承來源 Context) |
Display |
取得與此內容相關聯的顯示。 (繼承來源 Context) |
ExternalCacheDir |
傳回主要外部文件系統上目錄的絕對路徑, (位於 ExternalStorageDirectory 應用程式可放置它擁有之快取檔案的位置。 (繼承來源 ContextWrapper) |
FilesDir |
傳回檔系統上用來儲存檔案 OpenFileOutput(String, FileCreationMode) 的絕對路徑。 (繼承來源 ContextWrapper) |
FocusedStateSet |
活動是使用者可以執行的單一焦點事項。 |
FragmentManager |
傳回 FragmentManager,以便與與此活動相關聯的片段互動。 |
Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
HasWindowFocus |
如果此活動的 <em>main</em> 視窗目前有視窗焦點,則傳回 true。 |
Immersive |
指出此活動是「沉浸式」的位,如果可能的話,就不應該被通知中斷。 -或- 調整目前的沉浸式模式設定。 |
InstanceCount |
活動是使用者可以執行的單一焦點事項。 |
Intent |
傳回啟動此活動的意圖。 -或- 變更 所傳回的 |
IsActivityTransitionRunning |
傳回目前在此活動上執行的任何活動轉換。 |
IsChangingConfigurations |
檢查此活動是否正在終結,以便以新的組態重新建立。 |
IsChild |
此活動是否內嵌在另一個活動內? |
IsDestroyed |
如果活動上已進行最終 |
IsDeviceProtectedStorage |
活動是使用者可以執行的單一焦點事項。 (繼承來源 ContextWrapper) |
IsFinishing |
檢查此活動是否在完成過程中,因為您 |
IsInMultiWindowMode |
如果活動目前處於多視窗模式,則傳回 true。 |
IsInPictureInPictureMode |
如果活動目前處於圖片中模式,則傳回 true。 |
IsLaunchedFromBubble |
指出此活動是否從泡泡啟動。 |
IsLocalVoiceInteractionSupported |
查詢目前啟用的語音互動服務是否支援傳回語音互動器供活動使用。 |
IsRestricted |
指出此內容是否受到限制。 (繼承來源 Context) |
IsTaskRoot |
傳回此活動是否為工作的根目錄。 |
IsUiContext |
|
IsVoiceInteraction |
檢查此活動是否在與使用者進行語音互動時執行。 |
IsVoiceInteractionRoot |
如同 |
JniIdentityHashCode |
活動是使用者可以執行的單一焦點事項。 (繼承來源 Object) |
JniPeerMembers |
活動是使用者可以執行的單一焦點事項。 |
LastNonConfigurationInstance |
擷取先前由 傳 |
LaunchedFromPackage |
傳回最初啟動此活動之應用程式的套件名稱。 |
LaunchedFromUid |
傳回最初啟動此活動之應用程式的 uid。 |
LayoutInflater |
呼叫 的 |
LoaderManager |
傳回此活動的LoaderManager,視需要建立它。 |
LocalClassName |
傳回已移除封裝前置詞之此活動的類別名稱。 |
MainExecutor |
傳回 , |
MainLooper |
傳回目前進程之主線程的迴圈器。 (繼承來源 ContextWrapper) |
MaxNumPictureInPictureActions |
當使用者與目前處於圖片中模式的活動互動時,傳回在圖片內UI中顯示的動作數目。 |
MediaController |
取得控制器,當此活動位於前景時,應該接收媒體密鑰和磁碟區事件。 -或- 設定 |
MenuInflater |
|
NoBackupFilesDir |
傳回檔案系統上目錄的絕對路徑, FilesDir類似於 。 (繼承來源 ContextWrapper) |
ObbDir |
如果找到任何) ,則傳回此應用程式 OBB 檔案 (的主要外部儲存目錄。 (繼承來源 ContextWrapper) |
OnBackInvokedDispatcher |
|
OpPackageName |
傳回應該用於 |
PackageCodePath |
傳回此內容主要 Android 套件的完整路徑。 (繼承來源 ContextWrapper) |
PackageManager |
傳回 PackageManager 實例,以尋找全域套件資訊。 (繼承來源 ContextWrapper) |
PackageName |
傳回此應用程式套件的名稱。 (繼承來源 ContextWrapper) |
PackageResourcePath |
傳回此內容主要 Android 套件的完整路徑。 (繼承來源 ContextWrapper) |
Params |
如果透過 |
Parent |
如果此檢視是內嵌子系,則傳回父活動。 |
ParentActivityIntent |
取得, |
PeerReference |
活動是使用者可以執行的單一焦點事項。 (繼承來源 Object) |
Referrer |
傳回啟動此活動的人員相關信息。 |
RequestedOrientation |
傳回活動的目前要求方向。 -或- 變更此活動所需的方向。 |
Resources |
傳回應用程式套件的資源實例。 (繼承來源 ContextWrapper) |
SearchEvent |
在 onSearchRequested () 回呼期間,如果存在,此函式會傳回 |
SplashScreen |
取得活動用來與啟動顯示畫面交談的介面。 |
TaskId |
傳回此活動所在的工作識別碼。 |
Theme |
傳回與此內容相關聯的 Theme 物件。 (繼承來源 ContextWrapper) |
ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 |
Title |
活動是使用者可以執行的單一焦點事項。 |
TitleColor |
已淘汰.
變更與此活動相關聯的標題色彩。 |
TitleFormatted |
變更與此活動相關聯的標題。 |
VoiceInteractor |
擷取 |
VolumeControlStream |
取得建議的音訊串流,其音量應該由硬體音量控件變更。 -或- 建議硬體音量控制應變更其音量的音訊串流。 |
Wallpaper | (繼承來源 ContextWrapper) |
WallpaperDesiredMinimumHeight | (繼承來源 ContextWrapper) |
WallpaperDesiredMinimumWidth | (繼承來源 ContextWrapper) |
Window |
擷取活動的目前 |
WindowManager |
擷取視窗管理員以顯示自定義視窗。 |
方法
明確介面實作
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) |
活動是使用者可以執行的單一焦點事項。 |