DialogFragment 類別

參考

定義

命名空間:: Android.App

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

顯示對話框視窗的片段，其活動視窗頂端浮動。

[Android.Runtime.Register("android/app/DialogFragment", DoNotGenerateAcw=true)]
public class DialogFragment : Android.App.Fragment, Android.Content.IDialogInterfaceOnCancelListener, Android.Content.IDialogInterfaceOnDismissListener, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/app/DialogFragment", DoNotGenerateAcw=true)>]
type DialogFragment = class
    inherit Fragment
    interface IDialogInterfaceOnCancelListener
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IDialogInterfaceOnDismissListener

繼承: Object

Object

Fragment
DialogFragment

屬性: RegisterAttribute

實作: IDialogInterfaceOnCancelListener IDialogInterfaceOnDismissListener IJavaObject IJavaPeerable IDisposable

備註

顯示對話框視窗的片段，其活動視窗頂端浮動。此片段包含 Dialog 物件，它會根據片段的狀態適當地顯示。控制對話框 (決定何時要顯示、隱藏、關閉，) 應該透過 API 完成，而不是在對話方塊中直接呼叫。

實作應該覆寫這個類別，並實 #onCreateView(LayoutInflater, ViewGroup, Bundle) 作以提供對話框的內容。或者，他們可以覆寫 #onCreateDialog(Bundle) 以建立完全自定義的對話框，例如AlertDialog，其本身的內容。

這裡涵蓋的主題：<ol><li 生命週期<li>基本對話<li>警示對話框<li>>選取對話框或內嵌</ol>

“生命週期”><h3>生命週期</h3>

DialogFragment 會執行各種動作來保留片段的生命週期，而不是對話。請注意，對話框通常是自發實體-- 它們是自己的視窗、接收自己的輸入事件，而且通常會藉由接收返回索引鍵事件或使用者按兩下按鈕) ，自行決定何時消失 (。

DialogFragment 必須確定片段和對話框狀態發生的情況維持一致。若要這樣做，它會監看對話框的關閉事件，並負責在事件發生時移除自己的狀態。這表示您應該使用 #show(FragmentManager, String) 或 #show(FragmentTransaction, String) 將 DialogFragment 的實例新增至 UI，因為這些會追蹤 DialogFragment 在關閉對話框時應該如何自行移除。

“BasicDialog”><h3>基本對話框</h3>

DialogFragment 最簡單的用法是作為片段檢視階層的浮動容器。簡單的實作可能如下所示：

{

已取代這個成員。使用支持連結庫androidx.fragment.app.DialogFragment 在所有裝置上保持一致的行為，並存取生命週期。

的 android.app.DialogFragmentJava 檔。

此頁面的部分是根據原始碼專案所建立和共用的工作進行修改，並根據中所述的詞彙使用。

建構函式

DialogFragment()
DialogFragment(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時所使用的建構函式;由運行時間呼叫。

屬性

Activity	傳回此片段目前相關聯的活動。 (繼承來源 Fragment)
AllowEnterTransitionOverlap	傳回結束轉換和輸入轉換重疊。 -或- 設定結束轉換和輸入轉換是否重疊。 (繼承來源 Fragment)
AllowReturnTransitionOverlap	傳回轉換和重新輸入轉換是否重疊。 -或- 設定傳回轉換和重新輸入轉換是否重疊。 (繼承來源 Fragment)
Arguments	傳回提供給 `#setArguments`的自變數，如果有的話。 -或- 提供這個片段的建構自變數。 (繼承來源 Fragment)
Cancelable	傳回的目前值 `#setCancelable(boolean)`。 -或- 控制顯示的對話框是否可取消。
ChildFragmentManager	傳回私人 FragmentManager，以便在此片段內放置及管理片段。 (繼承來源 Fragment)
Class	傳回這個 `Object`的運行時間類別。 (繼承來源 Object)
Context	`Context`傳回此片段目前與相關聯。 (繼承來源 Fragment)
Dialog
EnterTransition	傳回轉換，用來將檢視移至初始場景。 -或- 設定將用來將檢視移至初始場景的轉換。 (繼承來源 Fragment)
ExitTransition	傳回轉換，當片段移除、隱藏或中斷連結時，將會用來將檢視移出場景。 -或- 設定在移除、隱藏或中斷連結片段時，用來將檢視移出場景的轉換。 (繼承來源 Fragment)
FragmentManager	傳回 FragmentManager，以便與與此片段活動相關聯的片段互動。 (繼承來源 Fragment)
Handle	基礎Android實例的句柄。 (繼承來源 Object)
Host	傳回這個片段的主機物件。 (繼承來源 Fragment)
Id	傳回這個片段已知的標識碼。 (繼承來源 Fragment)
IsAdded	如果片段目前已新增至其活動，則傳回 true。 (繼承來源 Fragment)
IsDetached	如果片段已明確從UI中斷連結，則傳回 true。 (繼承來源 Fragment)
IsHidden	如果片段已隱藏，則傳回 true。 (繼承來源 Fragment)
IsInLayout	如果配置是透過 < 納入活動檢視階層的一部分，則傳回 true;片段>標記。 (繼承來源 Fragment)
IsRemoving	如果目前已從其活動中移除此片段，則傳回 true。 (繼承來源 Fragment)
IsResumed	如果片段處於繼續狀態，則傳回 true。 (繼承來源 Fragment)
IsStateSaved	如果新增此片段，且其狀態已由其主機儲存，則傳回 true。 (繼承來源 Fragment)
IsVisible	如果使用者目前可以看到片段，則傳回 true。 (繼承來源 Fragment)
JniIdentityHashCode	顯示對話框視窗的片段，其活動視窗頂端浮動。 (繼承來源 Object)
JniPeerMembers	顯示對話框視窗的片段，其活動視窗頂端浮動。
LayoutInflater	傳回用來擴充此片段檢視的快取 LayoutInflater。 (繼承來源 Fragment)
LoaderManager	傳回此片段的LoaderManager，視需要建立它。 (繼承來源 Fragment)
ParentFragment	傳回包含這個片段的父片段。 (繼承來源 Fragment)
PeerReference	顯示對話框視窗的片段，其活動視窗頂端浮動。 (繼承來源 Object)
ReenterTransition	傳回轉換，此轉換會在傳回因返回堆疊而傳回時，用來將檢視移至場景中。 -或- 設定轉換，此轉換會在傳回時用來將檢視移至場景中，因為快顯返回堆棧。 (繼承來源 Fragment)
Resources	傳回 `getActivity().getResources()`。 (繼承來源 Fragment)
RetainInstance	控制片段實例是否保留在活動重新建立 (，例如從組態變更) 。 (繼承來源 Fragment)
ReturnTransition	傳回轉換，當片段準備移除、隱藏或中斷連結時，將檢視移出場景，因為快顯回堆棧。 -或- 設定當片段準備移除、隱藏或中斷連結時，用來將檢視移出場景的轉換，因為快顯回堆棧。 (繼承來源 Fragment)
SharedElementEnterTransition	傳回將用於傳輸至內容場景之共用元素的轉換。 -或- 設定將用於傳輸至內容場景之共用元素的轉換。 (繼承來源 Fragment)
SharedElementReturnTransition	傳回轉換，此轉換將用於在返回堆疊快顯期間傳回的共享專案。 -或- 設定轉換，此轉換將用於在返回堆疊快顯期間傳回的共享專案。 (繼承來源 Fragment)
ShowsDialog	傳回的目前值 `#setShowsDialog(boolean)`。 -或- 控制是否應該在對話框中顯示此片段。
Tag	如果指定，請取得片段的標記名稱。 (繼承來源 Fragment)
TargetFragment	傳回所 `#setTargetFragment`設定的目標片段。 (繼承來源 Fragment)
TargetRequestCode	傳回所 `#setTargetFragment`設定的目標要求碼。 (繼承來源 Fragment)
Theme
ThresholdClass	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式代碼使用。
ThresholdType	此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式代碼使用。
UserVisibleHint	將提示設定給系統，以瞭解此片段的UI目前是否對用戶可見。 (繼承來源 Fragment)
View	如果提供，請取得片段版面配置 () 傳 `#onCreateView` 回的根檢視。 (繼承來源 Fragment)

方法

Clone()	建立並傳回這個對象的複本。 (繼承來源 Object)
Dismiss()	關閉片段及其對話框。
DismissAllowingStateLoss()	使用`FragmentTransaction#commitAllowingStateLoss() FragmentTransaction.commitAllowingStateLoss()`的版本`#dismiss()`。
Dispose()	顯示對話框視窗的片段，其活動視窗頂端浮動。 (繼承來源 Object)
Dispose(Boolean)	顯示對話框視窗的片段，其活動視窗頂端浮動。 (繼承來源 Object)
Dump(String, FileDescriptor, PrintWriter, String[])	將片段的狀態列印到指定的數據流中。 (繼承來源 Fragment)
Equals(Object)	已淘汰. 子類別無法覆寫等於 () 。 (繼承來源 Fragment)
GetHashCode()	已淘汰. 子類別無法覆寫hashCode () 。 (繼承來源 Fragment)
GetString(Int32)	從應用程式套件的預設字串數據表傳回當地語系化字串。 (繼承來源 Fragment)
GetString(Int32, Object[])	從應用程式套件的預設字串數據表傳回當地語系化字串。 (繼承來源 Fragment)
GetText(Int32)	從應用程式套件的預設字串數據表傳回當地語系化、樣式的 CharSequence。 (繼承來源 Fragment)
GetTextFormatted(Int32)	從應用程式套件的預設字串數據表傳回當地語系化、樣式的 CharSequence。 (繼承來源 Fragment)
JavaFinalize()	當垃圾收集判斷對象沒有其他參考時，由物件上的垃圾收集行程呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件的監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
OnActivityCreated(Bundle)	建立片段的活動並具現化此片段的檢視階層時呼叫。 (繼承來源 Fragment)
OnActivityResult(Int32, Result, Intent)	從先前對的呼叫 `#startActivityForResult(Intent, int)`接收結果。 (繼承來源 Fragment)
OnAttach(Activity)	已取代這個成員。 (繼承來源 Fragment)
OnAttach(Context)	當片段第一次附加至其內容時呼叫。 (繼承來源 Fragment)
OnAttachFragment(Fragment)	當片段附加為這個片段的子系時呼叫。 (繼承來源 Fragment)
OnCancel(IDialogInterface)	取消對話框時，將會叫用這個方法。
OnConfigurationChanged(Configuration)	當裝置組態在元件執行時變更時，由系統呼叫。 (繼承來源 Fragment)
OnContextItemSelected(IMenuItem)	每當選取操作功能表中的專案時，就會呼叫此勾點。 (繼承來源 Fragment)
OnCreate(Bundle)	呼叫以執行片段的初始建立。 (繼承來源 Fragment)
OnCreateAnimator(FragmentTransit, Boolean, Int32)	當片段載入動畫時呼叫。 (繼承來源 Fragment)
OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo)	即將顯示的內容 `view` 功能表時呼叫。 (繼承來源 Fragment)
OnCreateDialog(Bundle)	覆寫以建置您自己的自定義對話框容器。
OnCreateOptionsMenu(IMenu, MenuInflater)	初始化活動標準選項功能表的內容。 (繼承來源 Fragment)
OnCreateView(LayoutInflater, ViewGroup, Bundle)	呼叫以讓片段具現化其使用者介面檢視。 (繼承來源 Fragment)
OnDestroy()	當片段不再使用時呼叫。 (繼承來源 Fragment)
OnDestroyOptionsMenu()	當此片段的選項功能表項不再包含在整體選項功能表中時呼叫。 (繼承來源 Fragment)
OnDestroyView()	當先前建立 `#onCreateView` 的檢視已從片段中斷連結時呼叫。 (繼承來源 Fragment)
OnDetach()	當片段不再附加至其活動時呼叫。 (繼承來源 Fragment)
OnDismiss(IDialogInterface)	關閉對話框時，將會叫用這個方法。
OnGetLayoutInflater(Bundle)	傳回用來擴充此片段檢視的 LayoutInflater。 (繼承來源 Fragment)
OnHiddenChanged(Boolean)	當片段傳 `#isHidden()` 回的隱藏狀態 (變更時呼叫。 (繼承來源 Fragment)
OnInflate(Activity, IAttributeSet, Bundle)	已取代這個成員。 (繼承來源 Fragment)
OnInflate(Context, IAttributeSet, Bundle)	當片段建立為檢視版面配置擴大的一部分時呼叫，通常是從設定活動的內容檢視。 (繼承來源 Fragment)
OnInflate(IAttributeSet, Bundle)	已淘汰. 已取代這個成員。 (繼承來源 Fragment)
OnLowMemory()	當整體系統記憶體不足時，就會呼叫這個值，而且主動執行的進程應該修剪其記憶體使用量。 (繼承來源 Fragment)
OnMultiWindowModeChanged(Boolean)	當片段的活動從全螢幕模式變更為多視窗模式，反之亦然時呼叫。 (繼承來源 Fragment)
OnMultiWindowModeChanged(Boolean, Configuration)	當片段的活動從全螢幕模式變更為多視窗模式，反之亦然時呼叫。 (繼承來源 Fragment)
OnOptionsItemSelected(IMenuItem)	每當選取選項功能表中的專案時，就會呼叫此勾點。 (繼承來源 Fragment)
OnOptionsMenuClosed(IMenu)	每當使用者取消具有返回/功能表按鈕的功能表，或選取專案) 時，就會呼叫這個勾點 (。 (繼承來源 Fragment)
OnPause()	當片段不再繼續時呼叫。 (繼承來源 Fragment)
OnPictureInPictureModeChanged(Boolean)	當活動變更為圖片內模式時，由系統呼叫。 (繼承來源 Fragment)
OnPictureInPictureModeChanged(Boolean, Configuration)	當活動變更為圖片內模式時，由系統呼叫。 (繼承來源 Fragment)
OnPrepareOptionsMenu(IMenu)	準備要顯示的畫面標準選項功能表。 (繼承來源 Fragment)
OnRequestPermissionsResult(Int32, String[], Permission[])	要求許可權的結果回呼。 (繼承來源 Fragment)
OnResume()	當使用者看到片段並主動執行時呼叫。 (繼承來源 Fragment)
OnSaveInstanceState(Bundle)	呼叫以要求片段儲存其目前的動態狀態，以便稍後可以在進程的新實例中重新建構。 (繼承來源 Fragment)
OnStart()	當使用者看到片段時呼叫。 (繼承來源 Fragment)
OnStop()	當片段不再啟動時呼叫。 (繼承來源 Fragment)
OnTrimMemory(TrimMemory)	當操作系統判斷進程從其進程修剪不需要的記憶體時，呼叫它。 (繼承來源 Fragment)
OnViewCreated(View, Bundle)	在傳回之後 `#onCreateView(LayoutInflater, ViewGroup, Bundle)` 立即呼叫，但在還原至檢視的任何已儲存狀態之前。 (繼承來源 Fragment)
OnViewStateRestored(Bundle)	當所有已儲存的狀態都還原到片段的檢視階層時呼叫。 (繼承來源 Fragment)
PostponeEnterTransition()	延後進入片段轉換，直到 `#startPostponedEnterTransition()` 呼叫或 `FragmentManager#executePendingTransactions()` 為止。 (繼承來源 Fragment)
RegisterForContextMenu(View)	註冊要針對指定檢視顯示的快捷功能表， (多個檢視可以顯示操作功能表) 。 (繼承來源 Fragment)
RequestPermissions(String[], Int32)	要求授與此應用程式的許可權。 (繼承來源 Fragment)
SetEnterSharedElementCallback(SharedElementCallback)	當自定義轉換與片段搭配使用時，當未彈出回溯堆棧時，就會呼叫輸入轉換回呼。 (繼承來源 Fragment)
SetExitSharedElementCallback(SharedElementCallback)	當自定義轉換與片段搭配使用時，會在卸除後端堆疊時呼叫結束轉換回呼。 (繼承來源 Fragment)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetHasOptionsMenu(Boolean)	回報此片段想要透過接收 `#onCreateOptionsMenu` 呼叫和相關方法，參與填入選項功能表。 (繼承來源 Fragment)
SetInitialSavedState(Fragment+SavedState)	設定第一次建構時，此片段應該從還原本身的初始儲存狀態，如所 `FragmentManager#saveFragmentInstanceState(Fragment) FragmentManager.saveFragmentInstanceState`傳回。 (繼承來源 Fragment)
SetMenuVisibility(Boolean)	設定是否應該顯示此片段功能表的提示。 (繼承來源 Fragment)
SetStyle(DialogFragmentStyle, Int32)	呼叫以自定義片段對話框的基本外觀和行為。
SetTargetFragment(Fragment, Int32)	此片段的選擇性目標。 (繼承來源 Fragment)
ShouldShowRequestPermissionRationale(String)	取得是否應該在要求許可權之前先以合理方式顯示 UI。 (繼承來源 Fragment)
Show(FragmentManager, String)	顯示對話框，將片段新增至指定的 FragmentManager。
Show(FragmentTransaction, String)	顯示對話框，使用現有的交易新增片段，然後認可交易。
StartActivity(Intent)	從片段的包含活動呼叫 `Activity#startActivity(Intent)` 。 (繼承來源 Fragment)
StartActivity(Intent, Bundle)	從片段的包含活動呼叫 `Activity#startActivity(Intent, Bundle)` 。 (繼承來源 Fragment)
StartActivityForResult(Intent, Int32)	從片段的包含活動呼叫 `Activity#startActivityForResult(Intent, int)` 。 (繼承來源 Fragment)
StartActivityForResult(Intent, Int32, Bundle)	從片段的包含活動呼叫 `Activity#startActivityForResult(Intent, int, Bundle)` 。 (繼承來源 Fragment)
StartIntentSenderForResult(IntentSender, Int32, Intent, ActivityFlags, ActivityFlags, Int32, Bundle)	從片段的包含活動呼叫 `Activity#startIntentSenderForResult(IntentSender, int, Intent, int, int, int, Bundle)` 。 (繼承來源 Fragment)
StartPostponedEnterTransition()	呼叫之後 `#postponeEnterTransition()` 開始延後轉換。 (繼承來源 Fragment)
ToArray<T>()	顯示對話框視窗的片段，其活動視窗頂端浮動。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterForContextMenu(View)	防止顯示指定檢視的操作功能表。 (繼承來源 Fragment)
UnregisterFromRuntime()	顯示對話框視窗的片段，其活動視窗頂端浮動。 (繼承來源 Object)
Wait()	讓目前的線程等到喚醒為止，通常是藉由 <em>notified</em> 或 <em>interrupted</em> 來喚醒。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

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)	顯示對話框視窗的片段，其活動視窗頂端浮動。

適用於

DialogFragment 類別

定義

備註

建構函式

屬性

方法

明確介面實作

擴充方法

適用於

其他資源