Presentation 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
演示文稿的基类。
[Android.Runtime.Register("android/app/Presentation", DoNotGenerateAcw=true)]
public class Presentation : Android.App.Dialog
[<Android.Runtime.Register("android/app/Presentation", DoNotGenerateAcw=true)>]
type Presentation = class
inherit Dialog
- 继承
- 特性
注解
演示文稿的基类。 演示文稿是一种特殊的对话,其用途是在另一个显示器上显示内容。 虽然传统上用于外部显示器,但从Build.VERSION_CODES开始。BAKLAVA,Display.FLAG_PRESENTATION现在可以附加到内置内部显示器,从而允许在它们上显示演示文稿。 在早期版本中,内部显示器不适用于演示文稿,并且尝试显示一个内容将始终会导致异常。 演示文稿在创建时与目标显示相关联,并根据显示的指标配置其上下文和资源配置。
值得注意的是,演示文稿的上下文不同于其包含活动的上下文。 请务必使用演示文稿自己的上下文来扩充演示文稿的布局并加载其他资源,以确保加载目标显示器大小和密度正确的资产。
当删除附加演示文稿的显示内容或删除应用程序的关联任务时,演示文稿将自动取消(请参阅 Dialog.cancel(见 Dialog.cancel)。。 每当暂停或恢复活动本身时,活动都应注意暂停和恢复演示文稿中播放的任何内容。
在显示演示文稿之前,请务必选择显示它的显示位置。 选择演示文稿显示有时很困难,因为可能附加了多个显示器。 应用程序应该让系统选择合适的演示文稿显示,而不是尝试猜测哪种显示效果最佳。
有两种选择显示的主要方法。
选择演示文稿显示的最简单方法是使用 MediaRouter API。 媒体路由器服务跟踪系统上可用的音频和视频路由。 每当选择或未选择路由或首选显示路由更改时,媒体路由器就会发送通知。 因此,应用程序只需监视这些通知,并自动在首选演示文稿显示上显示或消除演示文稿。
首选的演示文稿显示是媒体路由器建议应用程序在想要在另一个显示器上显示内容时应使用的显示器。 有时可能没有首选的演示文稿显示,在这种情况下,应用程序应在本地显示其内容而不使用演示文稿。
下面介绍如何使用媒体路由器在首选演示文稿显示器上使用 MediaRouter.RouteInfo.getPresentationDisplay()创建和显示演示文稿。
MediaRouter mediaRouter = (MediaRouter) context.getSystemService(Context.MEDIA_ROUTER_SERVICE);
MediaRouter.RouteInfo route = mediaRouter.getSelectedRoute(MediaRouter.ROUTE_TYPE_LIVE_VIDEO);
if (route != null) {
Display presentationDisplay = route.getPresentationDisplay();
if (presentationDisplay != null) {
Presentation presentation = new MyPresentation(context, presentationDisplay);
presentation.show();
}
}
来自 ApiDemos 的以下示例代码演示如何使用媒体路由器在应用程序活动中显示内容以及显示演示文稿中的内容(当演示文稿显示可用时)之间自动切换。
选择演示文稿显示的另一种方法是直接使用 DisplayManager API。 显示管理器服务提供用于枚举和描述附加到系统的所有显示器的功能,包括可用于演示文稿的显示器。
显示管理器跟踪系统中的所有显示器。 但是,并非所有显示都适合显示演示文稿。 例如,不允许在与应用程序顶部可见任务相同的显示器上显示演示文稿,以防止它遮挡其自己的内容。 此外,内部显示器上的演示文稿受到限制,并且可能需要将应用程序的任务集中在不同的显示器上,以确保用户与应用程序积极交互。 违反这些规则将导致调用 show() 时引发 WindowManager.InvalidDisplayException。 如果显示演示文稿的条件在已可见时不再满足,系统将自动将其消除,并且应用程序将收到 onStop() 回调。 显示时,由于安全原因,演示文稿将遮挡目标显示上的其他活动。
下面介绍如何识别适合使用 DisplayManager.getDisplays(String) 和DisplayManager.DISPLAY_CATEGORY_PRESENTATION类别显示演示文稿的显示。
DisplayManager displayManager = (DisplayManager) context.getSystemService(Context.DISPLAY_SERVICE);
Display[] presentationDisplays = displayManager.getDisplays(DisplayManager.DISPLAY_CATEGORY_PRESENTATION);
if (presentationDisplays.length > 0) {
// If there is more than one suitable presentation display, then we could consider
// giving the user a choice. For this example, we simply choose the first display
// which is the one the system recommends as the preferred presentation display.
Display display = presentationDisplays[0];
Presentation presentation = new MyPresentation(context, display);
presentation.show();
}
ApiDemos 中的以下示例代码演示如何使用显示管理器同时枚举显示和显示多个演示文稿上的内容。
Android 参考。android.app.Presentation
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
构造函数
| 名称 | 说明 |
|---|---|
| Presentation(Context, Display, Int32) |
使用可选的指定主题创建附加到指定显示的新演示文稿。 |
| Presentation(Context, Display) |
使用默认主题创建附加到指定显示的新演示文稿。 |
| Presentation(IntPtr, JniHandleOwnership) |
初始化现有 Java Native Interface 对象的托管表示形式。 |
属性
| 名称 | 说明 |
|---|---|
| ActionBar |
|
| Class |
返回此 |
| Context |
检索运行此对话框的上下文。 (继承自 Dialog) |
| CurrentFocus |
如果此活动返回当前焦点视图,请调用 |
| Display |
获取 |
| Handle |
基础 Android 实例的句柄。 (继承自 Object) |
| IsShowing |
获取对话框的装饰视图是否存在和可见。 (继承自 Dialog) |
| JniIdentityHashCode |
获取互操作运行时分配给此Java对等的标识哈希代码。 (继承自 Object) |
| JniManagedPeerState |
获取运行时上次分配的状态标志。 (继承自 JavaObject) |
| JniPeerMembers |
为 Android.App.Presentation 提供 JNI 绑定基础结构。 |
| LayoutInflater |
获取对话框窗口提供的布局膨胀器。 (继承自 Dialog) |
| OnBackInvokedDispatcher |
返回 |
| OwnerActivity |
返回拥有此对话框的活动。 - 或 - 设置拥有此对话框的活动。 (继承自 Dialog) |
| PeerReference |
获取此Java对等方的 JNI 对象引用。 (继承自 Object) |
| Resources |
|
| SearchEvent |
在 onSearchRequested() 回调期间,此函数将返回 |
| ThresholdClass |
为 Android.App.Presentation 提供 JNI 绑定基础结构。 |
| ThresholdType |
为 Android.App.Presentation 提供 JNI 绑定基础结构。 |
| VolumeControlStream |
默认情况下,这将使用所有者活动的建议流类型。 (继承自 Dialog) |
| Window |
检索活动的当前窗口。 (继承自 Dialog) |
方法
| 名称 | 说明 |
|---|---|
| AddContentView(View, ViewGroup+LayoutParams) |
向屏幕添加其他内容视图。 (继承自 Dialog) |
| Cancel() |
取消对话框。 (继承自 Dialog) |
| Clone() |
创建并返回此对象的副本。 (继承自 Object) |
| CloseOptionsMenu() |
另请参阅: (继承自 Dialog) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
将此对等方的构造委托给运行时的值管理器。 (继承自 JavaObject) |
| Create() |
强制立即创建对话。 (继承自 Dialog) |
| Dismiss() |
消除此对话框,将其从屏幕中删除。 (继承自 Dialog) |
| DispatchGenericMotionEvent(MotionEvent) |
调用以处理泛型运动事件。 (继承自 Dialog) |
| DispatchKeyEvent(KeyEvent) |
调用以处理关键事件。 (继承自 Dialog) |
| DispatchKeyShortcutEvent(KeyEvent) |
调用以处理键快捷事件。 (继承自 Dialog) |
| DispatchPopulateAccessibilityEvent(AccessibilityEvent) |
调用以处理 AccessibilityEvents 填充。 (继承自 Dialog) |
| DispatchTouchEvent(MotionEvent) |
调用以处理触摸屏事件。 (继承自 Dialog) |
| DispatchTrackballEvent(MotionEvent) |
调用以处理轨迹球事件。 (继承自 Dialog) |
| Dispose() |
释放此Java对等方持有的资源。 (继承自 Object) |
| Dispose(Boolean) |
释放此Java对等方持有的资源。 (继承自 Object) |
| DisposeUnlessReferenced() |
要求值管理器释放此对等方,除非其映射保留此相同的托管实例。 (继承自 JavaObject) |
| Equals(Object) |
测试另一个托管对等方是否引用同一Java对象。 (继承自 JavaObject) |
| Equals(Object) |
指示其他对象是否“等于”此对象。 (继承自 Object) |
| FindViewById(Int32) |
查找具有给定 ID 的第一个后代视图,或者 |
| FindViewById<T>(Int32) |
按资源 ID 查找视图,并将结果强制转换为请求的视图类型。 (继承自 Dialog) |
| GetHashCode() |
返回对象的哈希代码值。 (继承自 Object) |
| Hide() |
隐藏对话框,但不要将其消除。 (继承自 Dialog) |
| InvalidateOptionsMenu() |
另请参阅: (继承自 Dialog) |
| JavaFinalize() |
已过时.
当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。 (继承自 Object) |
| Notify() |
唤醒正在等待此对象的监视器的单个线程。 (继承自 Object) |
| NotifyAll() |
唤醒正在等待此对象的监视器的所有线程。 (继承自 Object) |
| OnActionModeFinished(ActionMode) |
要添加
(继承自 Dialog)
|
| OnActionModeStarted(ActionMode) |
要添加
(继承自 Dialog)
|
| OnAttachedToWindow() |
当窗口已附加到窗口管理器时调用。 (继承自 Dialog) |
| OnBackPressed() |
当对话框检测到用户按下后退键时调用。 (继承自 Dialog) |
| OnContentChanged() |
只要屏幕的内容视图发生更改(由于调用 Window.setContentView 或 Window.addContentView),将调用此挂钩。 (继承自 Dialog) |
| OnContextItemSelected(IMenuItem) |
另请参阅: (继承自 Dialog) |
| OnContextMenuClosed(IMenu) |
另请参阅: (继承自 Dialog) |
| OnCreate(Bundle) |
与 |
| OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo) |
生成此视图的上下文菜单时调用。 (继承自 Dialog) |
| OnCreateOptionsMenu(IMenu) |
如果客户端需要此对话框的相同菜单,则通常可以安全地将此调用代理到所有者活动的 |
| OnCreatePanelMenu(Int32, IMenu) |
初始化面板“featureId”菜单的内容。 (继承自 Dialog) |
| OnCreatePanelView(Int32) |
实例化视图,以便在“featureId”的面板中显示。 (继承自 Dialog) |
| OnDetachedFromWindow() |
当窗口已从窗口管理器分离时调用。 (继承自 Dialog) |
| OnDisplayChanged() |
当附加演示文稿的属性 |
| OnDisplayRemoved() |
在删除演示文稿附加到的系统上时 |
| OnGenericMotionEvent(MotionEvent) |
当对话中的任何视图未处理泛型运动事件时调用。 (继承自 Dialog) |
| OnKeyDown(Keycode, KeyEvent) |
按下了一个键。 (继承自 Dialog) |
| OnKeyLongPress(Keycode, KeyEvent) |
默认实现: |
| OnKeyMultiple(Keycode, Int32, KeyEvent) |
默认实现: |
| OnKeyShortcut(Keycode, KeyEvent) |
当对话框中的任何视图未处理键快捷方式事件时调用。 (继承自 Dialog) |
| OnKeyUp(Keycode, KeyEvent) |
已释放密钥。 (继承自 Dialog) |
| OnMenuItemSelected(Int32, IMenuItem) |
当用户选择了面板的菜单项时调用。 (继承自 Dialog) |
| OnMenuOpened(Int32, IMenu) |
当用户打开面板的菜单时调用。 (继承自 Dialog) |
| OnOptionsItemSelected(IMenuItem) |
另请参阅: (继承自 Dialog) |
| OnOptionsMenuClosed(IMenu) |
另请参阅: (继承自 Dialog) |
| OnPanelClosed(Int32, IMenu) |
关闭面板时调用。 (继承自 Dialog) |
| OnPrepareOptionsMenu(IMenu) |
如果客户端需要此对话框的相同菜单,则通常可以安全地将此调用代理到所有者活动的 |
| OnPreparePanel(Int32, View, IMenu) |
准备要显示的面板。 (继承自 Dialog) |
| OnRestoreInstanceState(Bundle) |
从以前保存的捆绑包还原对话框的状态。 (继承自 Dialog) |
| OnSaveInstanceState() |
将对话框的状态保存到捆绑包中。 (继承自 Dialog) |
| OnSearchRequested() |
当用户发出开始搜索的信号时,将调用此挂钩。 (继承自 Dialog) |
| OnSearchRequested(SearchEvent) |
当用户发出开始搜索的信号时,将调用此挂钩。 (继承自 Dialog) |
| OnStart() |
启动对话框时调用。 (继承自 Dialog) |
| OnStop() |
被叫来告诉你你正在停止。 (继承自 Dialog) |
| OnTouchEvent(MotionEvent) |
当触摸屏事件未由其下的任何视图处理时调用。 (继承自 Dialog) |
| OnTrackballEvent(MotionEvent) |
在移动轨迹球时调用,并且未由活动内的任何视图处理。 (继承自 Dialog) |
| OnWindowAttributesChanged(WindowManagerLayoutParams) |
每当当前窗口属性发生更改时,将调用此值。 (继承自 Dialog) |
| OnWindowFocusChanged(Boolean) |
每当窗口焦点发生更改时,将调用此挂钩。 (继承自 Dialog) |
| OnWindowStartingActionMode(ActionMode+ICallback, ActionModeType) |
在此窗口启动操作模式时调用。 (继承自 Dialog) |
| OnWindowStartingActionMode(ActionMode+ICallback) |
在此窗口启动操作模式时调用。 (继承自 Dialog) |
| OpenContextMenu(View) |
另请参阅: (继承自 Dialog) |
| OpenOptionsMenu() |
另请参阅: (继承自 Dialog) |
| RegisterForContextMenu(View) |
另请参阅: (继承自 Dialog) |
| RequestWindowFeature(Int32) |
启用扩展窗口功能。 (继承自 Dialog) |
| RequireViewById(Int32) |
查找具有给定 ID 的第一个后代视图,或者如果 ID 无效(< 0)、层次结构中没有匹配的视图,或者尚未完全创建对话框(例如,通过 |
| SetCancelable(Boolean) |
设置此对话框是否可以使用 |
| SetCanceledOnTouchOutside(Boolean) |
设置在窗口边界外触摸时是否取消此对话框。 (继承自 Dialog) |
| SetCancelMessage(Message) |
设置在取消对话框时要发送的消息。 (继承自 Dialog) |
| SetContentView(Int32) |
从布局资源设置屏幕内容。 (继承自 Dialog) |
| SetContentView(View, ViewGroup+LayoutParams) |
将屏幕内容设置为显式视图。 (继承自 Dialog) |
| SetContentView(View) |
将屏幕内容设置为显式视图。 (继承自 Dialog) |
| SetDismissMessage(Message) |
设置在关闭对话框时要发送的消息。 (继承自 Dialog) |
| SetFeatureDrawable(Int32, Drawable) |
方便呼叫 |
| SetFeatureDrawableAlpha(Int32, Int32) |
方便呼叫 |
| SetFeatureDrawableResource(Int32, Int32) |
方便呼叫 |
| SetFeatureDrawableUri(Int32, Uri) |
方便呼叫 |
| SetHandle(IntPtr, JniHandleOwnership) |
设置 Handle 属性。 (继承自 Object) |
| SetOnCancelListener(IDialogInterfaceOnCancelListener) |
设置在取消对话框时要调用的侦听器。 (继承自 Dialog) |
| SetOnDismissListener(IDialogInterfaceOnDismissListener) |
设置在关闭对话框时要调用的侦听器。 (继承自 Dialog) |
| SetOnKeyListener(IDialogInterfaceOnKeyListener) |
设置将密钥调度到对话框时将调用的回调。 (继承自 Dialog) |
| SetOnShowListener(IDialogInterfaceOnShowListener) |
设置在显示对话框时要调用的侦听器。 (继承自 Dialog) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。 (继承自 JavaObject) |
| SetTitle(ICharSequence) |
设置此对话框窗口的标题文本。 (继承自 Dialog) |
| SetTitle(Int32) |
设置此对话框窗口的标题文本。 (继承自 Dialog) |
| SetTitle(String) |
设置此对话框窗口的标题文本。 (继承自 Dialog) |
| Show() |
启动对话框并在屏幕上显示它。 (继承自 Dialog) |
| TakeKeyEvents(Boolean) |
请求关键事件访问此对话框。 (继承自 Dialog) |
| ToArray<T>() |
从此Java数组包装器创建托管数组。 (继承自 Object) |
| ToString() |
返回对象的字符串表示形式。 (继承自 Object) |
| UnregisterForContextMenu(View) |
另请参阅: (继承自 Dialog) |
| UnregisterFromRuntime() |
从互操作运行时取消注册此Java对等。 (继承自 Object) |
| Wait() |
导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。 (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。 (继承自 Object) |
事件
| 名称 | 说明 |
|---|---|
| CancelEvent |
将对话取消回调转发为托管事件。 (继承自 Dialog) |
| DismissEvent |
将对话框消除回调转发为托管事件。 (继承自 Dialog) |
| KeyPress |
将对话框的键侦听程序回调作为托管事件转发。 (继承自 Dialog) |
| ShowEvent |
将对话框的显示回调转发为托管事件。 (继承自 Dialog) |
显式接口实现
| 名称 | 说明 |
|---|---|
| IJavaPeerable.Disposed() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.Finalized() |
将此对等方标记为已释放,并将 |
| IJavaPeerable.JniObjectReferenceControlBlock |
获取此对等方使用的本机控制块指针。 (继承自 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
存储运行时提供的标识哈希代码。 (继承自 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
替换存储的托管对等状态标志。 (继承自 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
更新对等引用,并在引用无效时释放已释放的对等方控制块。 (继承自 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
从运行时的Java对象查找中删除此实例。 (继承自 Dialog) |
扩展方法
| 名称 | 说明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
获取实例 |
| JavaAs<TResult>(IJavaPeerable) |
尝试强制 |
| JavaCast<TResult>(IJavaObject) |
执行 Android 运行时检查的类型转换。 |
| JavaCast<TResult>(IJavaObject) |
重复使用兼容的托管对等,或获取请求类型的包装器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
尝试强制 |