Dialog 類別

定義

命名空間:: Android.App

組件:: Mono.Android.dll

重要

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

對話的基底類別。

[Android.Runtime.Register("android/app/Dialog", DoNotGenerateAcw=true)]
public class Dialog : Java.Lang.Object, Android.Content.IDialogInterface, Android.Views.KeyEvent.ICallback, Android.Views.View.IOnCreateContextMenuListener, Android.Views.Window.ICallback, IDisposable

[<Android.Runtime.Register("android/app/Dialog", DoNotGenerateAcw=true)>]
type Dialog = class
    inherit Object
    interface IDialogInterface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface KeyEvent.ICallback
    interface View.IOnCreateContextMenuListener
    interface Window.ICallback

繼承: Object

JavaObject

Object
Dialog

衍生: Android.App.AlertDialog

Android.App.Presentation

Android.Text.Method.CharacterPickerDialog

屬性: RegisterAttribute

實作: IDialogInterface IJavaObject KeyEvent.ICallback View.IOnCreateContextMenuListener Window.ICallback IJavaPeerable IDisposable

備註

對話的基底類別。注意：活動提供管理對話建立、儲存與還原的設施。請參見 Activity.onCreateDialog（int）、Activity.onPrepareDialog（int，Dialog）、Activity.showDialog（int）及 Activity.dismissDialog（int）。若使用這些方法，getOwnerActivity（）會回傳管理此對話框的 Activity。通常你會希望在目前輸入法上方顯示對話框，因為沒有理由讓它接受文字。你可以透過以下程式碼設定WindowManager.LayoutParams.FLAG_ALT_FOCUSABLE_IM視窗旗標（假設你的對話框採用預設的輸入焦點）來達成：開發者指南欲了解更多關於建立對話框的資訊，請閱讀對話框開發者指南。

Android 參考資料。android.app.Dialog

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
Dialog(Context, Boolean, EventHandler)
Dialog(Context, Boolean, IDialogInterfaceOnCancelListener)	建立一個使用預設對話主題的對話視窗。
Dialog(Context, Int32)	建立一個使用自訂對話樣式的對話視窗。
Dialog(Context)	建立一個使用預設對話主題的對話視窗。
Dialog(IntPtr, JniHandleOwnership)	初始化現有 Java 原生介面物件的受管理表示。

屬性

名稱	Description
ActionBar	如果有的話，請取回附在這段對話框上的。`ActionBar`
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Context	取得此對話正在執行的上下文。
CurrentFocus	呼叫 `android.view.Window#getCurrentFocus` 此活動視窗以返回當前聚焦的視圖。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsShowing
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	對話的基底類別。 (繼承來源 JavaObject)
JniPeerMembers	提供 Android.App.Dialog 的 JNI 綁定基礎架構。
LayoutInflater
OnBackInvokedDispatcher	回傳 `OnBackInvokedDispatcher` 與該對話框所連結視窗相關的實例。
OwnerActivity	回傳擁有此對話的活動。 -或- 設定擁有此對話框的活動。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
SearchEvent	在 onSearchRequested（）回調時，這個函式會回傳 `SearchEvent` 觸發回調的（如果存在的話）。
ThresholdClass	提供 Android.App.Dialog 的 JNI 綁定基礎架構。
ThresholdType	提供 Android.App.Dialog 的 JNI 綁定基礎架構。
VolumeControlStream	預設情況下，這會使用擁有者活動建議的串流類型。
Window	取得該活動目前的視窗。

方法

名稱	Description
AddContentView(View, ViewGroup+LayoutParams)	在螢幕上新增一個額外的內容檢視。
Cancel()	取消對話。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CloseOptionsMenu()	另請參閱：
Construct(JniObjectReference, JniObjectReferenceOptions)	對話的基底類別。 (繼承來源 JavaObject)
Create()	強制立即創建對話。
Dismiss()	關閉此對話框，從螢幕上移除。
DispatchGenericMotionEvent(MotionEvent)	被召喚處理一般動態事件。
DispatchKeyEvent(KeyEvent)	被召喚處理關鍵事件。
DispatchKeyShortcutEvent(KeyEvent)	被呼叫處理一個關鍵捷徑事件。
DispatchPopulateAccessibilityEvent(AccessibilityEvent)	被召喚處理無障礙事件的人口。
DispatchTouchEvent(MotionEvent)	被召喚來處理觸控螢幕事件。
DispatchTrackballEvent(MotionEvent)	被召喚處理軌跡球事件。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	對話的基底類別。 (繼承來源 JavaObject)
Equals(Object)	對話的基底類別。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FindViewById(Int32)	尋找具有相同 ID 的第一個後代視圖，或 `null` 若 ID 無效（< 0）、階層中無匹配視圖，或對話尚未完整建立（例如 via `#show()` 或 `#create()`）。
FindViewById<T>(Int32)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
Hide()	隱藏對話，但不要忽視它。
InvalidateOptionsMenu()	另請參閱：
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
OnActionModeFinished(ActionMode)	待補充 `Note that if you override this method you should always call through to the superclass implementation by calling super.`
OnActionModeStarted(ActionMode)	待補充 `Note that if you override this method you should always call through to the superclass implementation by calling super.`
OnAttachedToWindow()	當視窗連接到視窗管理器時，我會打電話。
OnBackPressed()	當對話框偵測到使用者按下返回鍵時，會被呼叫。
OnContentChanged()	每當螢幕內容檢視改變（因呼叫 Window.setContentView 或 Window.addContentView）時，都會呼叫這個鉤子。
OnContextItemSelected(IMenuItem)	另請參閱：
OnContextMenuClosed(IMenu)	另請參閱：
OnCreate(Bundle)	類似 `Activity#onCreate`地，你應該用這種方式初始化對話，包括呼叫 `#setContentView`。
OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo)	當此視圖的右鍵選單建立時會被呼叫。
OnCreateOptionsMenu(IMenu)	如果客戶端希望該對話對話使用相同的選單，通常可以將此呼叫代理給擁有者的活動 `Activity#onCreateOptionsMenu(Menu)` 。
OnCreatePanelMenu(Int32, IMenu)	初始化選單中面板「featureId」的內容。
OnCreatePanelView(Int32)	在面板裡的「featureId」裡實例化顯示的視圖。
OnDetachedFromWindow()	當視窗從視窗管理器中分離後，我會打電話。
OnGenericMotionEvent(MotionEvent)	當對話框內的任何視圖都未處理一般動作事件時，會被呼叫。
OnKeyDown(Keycode, KeyEvent)	一個按鍵被按下。
OnKeyLongPress(Keycode, KeyEvent)	預設實作 `KeyEvent.Callback#onKeyLongPress(int, KeyEvent) KeyEvent.Callback.onKeyLongPress()`：總是回傳 false（不處理事件）。
OnKeyMultiple(Keycode, Int32, KeyEvent)	預設實作 `KeyEvent.Callback#onKeyMultiple(int, int, KeyEvent) KeyEvent.Callback.onKeyMultiple()`：總是回傳 false（不處理事件）。
OnKeyShortcut(Keycode, KeyEvent)	當對話框中任何檢視都未處理某個快捷鍵事件時，會呼叫此事件。
OnKeyUp(Keycode, KeyEvent)	一把鑰匙被釋放了。
OnMenuItemSelected(Int32, IMenuItem)	當使用者選擇面板的選單項目時，會被呼叫。
OnMenuOpened(Int32, IMenu)	當使用者打開面板選單時呼叫。
OnOptionsItemSelected(IMenuItem)	另請參閱：
OnOptionsMenuClosed(IMenu)	另請參閱：
OnPanelClosed(Int32, IMenu)	當面板關閉時會被打電話。
OnPrepareOptionsMenu(IMenu)	如果客戶端希望該對話對話使用相同的選單，通常可以將此呼叫代理給擁有者的活動 `Activity#onPrepareOptionsMenu(Menu)` 。
OnPreparePanel(Int32, View, IMenu)	準備一個展示面板。
OnRestoreInstanceState(Bundle)	從先前儲存的套件中恢復對話狀態。
OnSaveInstanceState()	將對話狀態存成一個 bundle。
OnSearchRequested()	當使用者表示想要開始搜尋時，會呼叫這個鉤子。
OnSearchRequested(SearchEvent)	當使用者表示想要開始搜尋時，會呼叫這個鉤子。
OnStart()	對話開始時會被打電話。
OnStop()	打電話告訴你你要停下來了。
OnTouchEvent(MotionEvent)	當觸控螢幕事件未被任何視圖處理時會被呼叫。
OnTrackballEvent(MotionEvent)	當軌跡球移動且未被活動內任何視角處理時，該動作被判定。
OnWindowAttributesChanged(WindowManagerLayoutParams)	每當目前視窗屬性改變時，都會呼叫這個功能。
OnWindowFocusChanged(Boolean)	每當視窗焦點改變時，就會呼叫這個鉤子。
OnWindowStartingActionMode(ActionMode+ICallback, ActionModeType)	當動作模式啟動時會呼叫。
OnWindowStartingActionMode(ActionMode+ICallback)	當動作模式啟動時會呼叫。
OpenContextMenu(View)	另請參閱：
OpenOptionsMenu()	另請參閱：
RegisterForContextMenu(View)	另請參閱：
RequestWindowFeature(Int32)	啟用擴充視窗功能。
RequireViewById(Int32)	若該 ID 無效（< 0）、階層中無匹配視圖，或對話框尚未完整建立（例如 via `#show()` 或 `#create()`），則會拋出 IllegalArgumentException。
SetCancelable(Boolean)	設定此對話是否可用 `KeyEvent#KEYCODE_BACK BACK` 鍵取消。
SetCanceledOnTouchOutside(Boolean)	設定當被觸碰視窗範圍外時，該對話是否會被取消。
SetCancelMessage(Message)	設定在對話取消時發送訊息。
SetContentView(Int32)	從版面資源設定螢幕內容。
SetContentView(View, ViewGroup+LayoutParams)	將螢幕內容設定為明確視圖。
SetContentView(View)	將螢幕內容設定為明確視圖。
SetDismissMessage(Message)	設定在對話結束時發送訊息。
SetFeatureDrawable(Int32, Drawable)	方便打電話 `android.view.Window#setFeatureDrawable(int, Drawable)`。
SetFeatureDrawableAlpha(Int32, Int32)	方便打電話 `android.view.Window#setFeatureDrawableAlpha`。
SetFeatureDrawableResource(Int32, Int32)	方便打電話 `android.view.Window#setFeatureDrawableResource`。
SetFeatureDrawableUri(Int32, Uri)	方便打電話 `android.view.Window#setFeatureDrawableUri`。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetOnCancelListener(IDialogInterfaceOnCancelListener)	設定一個監聽器，當對話被取消時被呼叫。
SetOnDismissListener(IDialogInterfaceOnDismissListener)	設定一個聆聽者，當對話被關閉時被調用。
SetOnKeyListener(IDialogInterfaceOnKeyListener)	設定若將金鑰派遣到對話框時會呼叫的回調。
SetOnShowListener(IDialogInterfaceOnShowListener)	設定一個監聽器，在對話顯示時被呼叫。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	對話的基底類別。 (繼承來源 JavaObject)
SetTitle(ICharSequence)	為此對話視窗設定標題文字。
SetTitle(Int32)	為此對話視窗設定標題文字。
SetTitle(String)	為此對話視窗設定標題文字。
Show()	開始對話框並在螢幕上顯示。
TakeKeyEvents(Boolean)	請求將關鍵事件納入此對話。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterForContextMenu(View)	另請參閱：
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

事件

名稱	Description
CancelEvent
DismissEvent
KeyPress
ShowEvent

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	對話的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	對話的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	對話的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	對話的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	對話的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	對話的基底類別。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	對話的基底類別。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	對話的基底類別。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於