Presentation Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Classe de base pour les présentations.
[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- Héritage
- Attributs
Remarques
Classe de base pour les présentations. Une présentation est un type spécial de dialogue dont l’objectif est de présenter du contenu sur un autre affichage. Bien que traditionnellement utilisé pour les affichages externes, à partir de Build.VERSION_CODES. BAKLAVA, Display.FLAG_PRESENTATION peut désormais être attaché à des affichages internes intégrés, ce qui permet également aux présentations d’être affichées sur eux. Dans les versions antérieures, les affichages internes n’étaient pas adaptés aux présentations et la tentative d’affichage d’un affichage entraînerait toujours une exception. Une présentation est associée à l’affichage cible au moment de la création et configure son contexte et sa configuration de ressource en fonction des métriques de l’affichage.
Notamment, le contexte d’une présentation est différent du contexte de son activité contenante. Il est important de gonfler la disposition d’une présentation et de charger d’autres ressources à l’aide du contexte de la présentation pour s’assurer que les ressources de la taille et de la densité correctes pour l’affichage cible sont chargées.
Une présentation est automatiquement annulée (voir Dialog.cancel()) lorsque l’affichage auquel il est attaché est supprimé ou lorsque la tâche associée de l’application est supprimée. Une activité doit prendre soin de suspendre et de reprendre le contenu qui est en cours de lecture dans la présentation chaque fois que l’activité elle-même est suspendue ou reprise.
Avant d’afficher une présentation, il est important de choisir l’affichage sur lequel il apparaîtra. Le choix d’un affichage de présentation est parfois difficile, car il peut y avoir plusieurs affichages attachés. Au lieu d’essayer de deviner l’affichage le mieux, une application doit laisser le système choisir un affichage de présentation approprié.
Il existe deux façons principales de choisir un affichage.
Le moyen le plus simple de choisir un affichage de présentation consiste à utiliser l’API MediaRouter. Le service de routeur multimédia effectue le suivi des itinéraires audio et vidéo disponibles sur le système. Le routeur multimédia envoie des notifications chaque fois que les itinéraires sont sélectionnés ou non sélectionnés ou lorsque l’affichage de présentation préféré d’un itinéraire change. Par conséquent, une application peut simplement regarder ces notifications et afficher ou ignorer une présentation sur l’affichage de présentation préféré automatiquement.
L’affichage de présentation préféré est l’affichage que le routeur multimédia recommande que l’application utilise si elle souhaite afficher du contenu sur un autre affichage. Il peut arriver qu’il n’y ait pas d’affichage de présentation par défaut, auquel cas l’application doit afficher son contenu localement sans utiliser de présentation.
Voici comment utiliser le routeur multimédia pour créer et afficher une présentation sur l’affichage de présentation préféré à l’aide de MediaRouter.RouteInfo.getPresentationDisplay().
L’exemple de code suivant d’ApiDemos montre comment utiliser le routeur multimédia pour basculer automatiquement entre l’affichage du contenu dans l’activité de l’application et l’affichage du contenu dans une présentation lorsqu’un affichage de présentation est disponible.
Une autre façon de choisir un affichage de présentation consiste à utiliser directement l’API DisplayManager. Le service Display Manager fournit des fonctions permettant d’énumérer et de décrire tous les affichages attachés au système, y compris les affichages qui peuvent être utilisés pour les présentations.
Le gestionnaire d’affichage effectue le suivi de tous les affichages dans le système. Toutefois, tous les affichages ne sont pas appropriés pour afficher des présentations. Par exemple, une présentation n’est pas autorisée sur le même affichage que la tâche visible supérieure de l’application pour l’empêcher d’obscurcir son propre contenu. En outre, les présentations sur les affichages internes sont restreintes et peuvent nécessiter que la tâche de l’application soit axée sur un autre affichage pour s’assurer que l’utilisateur interagit activement avec l’application. La violation de ces règles entraîne la levée de WindowManager.InvalidDisplayException lors de l’appel de show(). Si les conditions d’affichage d’une présentation ne sont plus remplies alors qu’elles sont déjà visibles, le système l’ignore automatiquement et l’application reçoit le rappel onStop(). Lorsqu’elle est affichée, une présentation permet d’obstruer d’autres activités sur l’affichage cible pour des raisons de sécurité.
Voici comment identifier les affichages appropriés pour afficher des présentations à l’aide de DisplayManager.getDisplays(String) et de la catégorie DisplayManager.DISPLAY_CATEGORY_PRESENTATION.
L’exemple de code suivant d’ApiDemos montre comment utiliser le gestionnaire d’affichage pour énumérer les affichages et afficher le contenu sur plusieurs affichages de présentation simultanément.
Référence Android pour android.app.Presentation.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.
Constructeurs
| Nom | Description |
|---|---|
| Presentation(Context, Display, Int32) |
Crée une présentation attachée à l’affichage spécifié à l’aide du thème éventuellement spécifié. |
| Presentation(Context, Display) |
Crée une présentation attachée à l’affichage spécifié à l’aide du thème par défaut. |
| Presentation(IntPtr, JniHandleOwnership) |
Initialise une représentation managée d’un objet Java Native Interface existant. |
Propriétés
| Nom | Description |
|---|---|
| ActionBar |
Récupérez la barre d’actions attachée à cette boîte de dialogue, le cas échéant. (Hérité de Dialog) |
| Class |
Retourne la classe runtime de ce |
| Context |
Récupérez le contexte dans lequel cette boîte de dialogue s’exécute. (Hérité de Dialog) |
| CurrentFocus |
Appelez Window.getCurrentFocus() sur la fenêtre si cette activité doit retourner la vue actuellement axée. (Hérité de Dialog) |
| Display |
Obtient l’affichage sur lequel cette présentation s’affiche. |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| IsShowing |
Classe de base pour les présentations. (Hérité de Dialog) |
| JniIdentityHashCode |
Obtient le code de hachage d’identité affecté à cet homologue Java par le runtime d’interopérabilité. (Hérité de Object) |
| JniManagedPeerState |
Classe de base pour les présentations. (Hérité de JavaObject) |
| JniPeerMembers |
Fournit une infrastructure de liaison JNI pour Android.App.Presentation. |
| LayoutInflater |
Classe de base pour les présentations. (Hérité de Dialog) |
| OnBackInvokedDispatcher |
Retourne l’instance OnBackInvokedDispatcher associée à la fenêtre à laquelle cette boîte de dialogue est attachée. (Hérité de Dialog) |
| OwnerActivity |
Retourne l’activité qui possède cette boîte de dialogue. (Hérité de Dialog) |
| PeerReference |
Obtient la référence d’objet JNI pour cet homologue Java. (Hérité de Object) |
| Resources |
Obtient les ressources qui doivent être utilisées pour gonfler la disposition de cette présentation. |
| SearchEvent |
Pendant les rappels onSearchRequested(), cette fonction retourne l’événement SearchEvent qui a déclenché le rappel, s’il existe. (Hérité de Dialog) |
| ThresholdClass |
Fournit une infrastructure de liaison JNI pour Android.App.Presentation. |
| ThresholdType |
Fournit une infrastructure de liaison JNI pour Android.App.Presentation. |
| VolumeControlStream |
Voir aussi : (Hérité de Dialog) |
| Window |
Récupérez la fenêtre active de l’activité. (Hérité de Dialog) |
Méthodes
| Nom | Description |
|---|---|
| AddContentView(View, ViewGroup+LayoutParams) |
Ajoutez une vue de contenu supplémentaire à l’écran. (Hérité de Dialog) |
| Cancel() |
Annulez la boîte de dialogue. (Hérité de Dialog) |
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| CloseOptionsMenu() |
Voir aussi : (Hérité de Dialog) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
Classe de base pour les présentations. (Hérité de JavaObject) |
| Create() |
Force la création immédiate du dialogue. (Hérité de Dialog) |
| Dismiss() |
Ignorer cette boîte de dialogue, en la supprimant de l’écran. (Hérité de Dialog) |
| DispatchGenericMotionEvent(MotionEvent) |
Appelé pour traiter les événements de mouvement génériques. (Hérité de Dialog) |
| DispatchKeyEvent(KeyEvent) |
Appelé pour traiter les événements clés. (Hérité de Dialog) |
| DispatchKeyShortcutEvent(KeyEvent) |
Appelé pour traiter un événement de raccourci de touche. (Hérité de Dialog) |
| DispatchPopulateAccessibilityEvent(AccessibilityEvent) |
Appelé pour traiter la population d’AccessibilityEvents. (Hérité de Dialog) |
| DispatchTouchEvent(MotionEvent) |
Appelé pour traiter les événements d’écran tactile. (Hérité de Dialog) |
| DispatchTrackballEvent(MotionEvent) |
Appelé pour traiter les événements trackball. (Hérité de Dialog) |
| Dispose() |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| Dispose(Boolean) |
Libère les ressources détenues par cet homologue Java. (Hérité de Object) |
| DisposeUnlessReferenced() |
Classe de base pour les présentations. (Hérité de JavaObject) |
| Equals(Object) |
Classe de base pour les présentations. (Hérité de JavaObject) |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| FindViewById(Int32) |
Recherche la première vue descendante avec l’ID donné ou null si l’ID n’est pas valide (< 0), il n’existe aucune vue correspondante dans la hiérarchie, ou la boîte de dialogue n’a pas encore été entièrement créée (par exemple, via show() ou create()). (Hérité de Dialog) |
| FindViewById<T>(Int32) |
Classe de base pour les présentations. (Hérité de Dialog) |
| GetHashCode() |
Retourne une valeur de code de hachage pour l’objet. (Hérité de Object) |
| Hide() |
Masquez la boîte de dialogue, mais ne l’ignorez pas. (Hérité de Dialog) |
| InvalidateOptionsMenu() |
Voir aussi : (Hérité de Dialog) |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| OnActionModeFinished(ActionMode) |
Appelé lorsqu’un mode d’action a été terminé. (Hérité de Dialog) |
| OnActionModeStarted(ActionMode) |
Appelé lorsqu’un mode d’action a été démarré. (Hérité de Dialog) |
| OnAttachedToWindow() |
Appelé lorsque la fenêtre a été attachée au gestionnaire de fenêtres. (Hérité de Dialog) |
| OnBackPressed() |
Cette méthode a été déconseillée au niveau de l’API 33. (Hérité de Dialog) |
| OnContentChanged() |
Ce hook est appelé chaque fois que l’affichage de contenu de l’écran change (en raison d’un appel à Window.setContentView ou Window.addContentView). (Hérité de Dialog) |
| OnContextItemSelected(IMenuItem) |
Voir aussi : (Hérité de Dialog) |
| OnContextMenuClosed(IMenu) |
Voir aussi : (Hérité de Dialog) |
| OnCreate(Bundle) |
Comme Activity.onCreate, vous devez initialiser votre boîte de dialogue dans cette méthode, notamment appeler setContentView(View). (Hérité de Dialog) |
| OnCreateContextMenu(IContextMenu, View, IContextMenuContextMenuInfo) |
Appelé lorsque le menu contextuel de cette vue est généré. (Hérité de Dialog) |
| OnCreateOptionsMenu(IMenu) |
Il est généralement sûr de proxyer cet appel à l’activité du propriétaire.onCreateOptionsMenu(Menu) si le client souhaite le même menu pour cette boîte de dialogue. (Hérité de Dialog) |
| OnCreatePanelMenu(Int32, IMenu) |
Initialisez le contenu du menu pour le panneau « featureId ». (Hérité de Dialog) |
| OnCreatePanelView(Int32) |
Instanciez la vue à afficher dans le panneau pour « featureId ». (Hérité de Dialog) |
| OnDetachedFromWindow() |
Appelé lorsque la fenêtre a été détachée du gestionnaire de fenêtres. (Hérité de Dialog) |
| OnDisplayChanged() |
Appelé par le système lorsque les propriétés de l’affichage auquel la présentation est attachée ont changé. |
| OnDisplayRemoved() |
Appelé par le système lorsque l’affichage auquel la présentation est attachée a été supprimée. |
| OnGenericMotionEvent(MotionEvent) |
Appelé lorsqu’un événement de mouvement générique n’a pas été géré par l’une des vues à l’intérieur de la boîte de dialogue. (Hérité de Dialog) |
| OnKeyDown(Keycode, KeyEvent) |
Une touche a été enfoncée. (Hérité de Dialog) |
| OnKeyLongPress(Keycode, KeyEvent) |
Implémentation par défaut de KeyEvent.Callback.onKeyLongPress() : retourne toujours false (ne gère pas l’événement). (Hérité de Dialog) |
| OnKeyMultiple(Keycode, Int32, KeyEvent) |
Implémentation par défaut de KeyEvent.Callback.onKeyMultiple() : retourne toujours false (ne gère pas l’événement). (Hérité de Dialog) |
| OnKeyShortcut(Keycode, KeyEvent) |
Appelé lorsqu’un événement de raccourci de touche n’est pas géré par l’une des vues de la boîte de dialogue. (Hérité de Dialog) |
| OnKeyUp(Keycode, KeyEvent) |
Une clé a été libérée. (Hérité de Dialog) |
| OnMenuItemSelected(Int32, IMenuItem) |
Appelé lorsque l’élément de menu d’un panneau a été sélectionné par l’utilisateur. (Hérité de Dialog) |
| OnMenuOpened(Int32, IMenu) |
Appelé lorsque le menu d’un panneau est ouvert par l’utilisateur. (Hérité de Dialog) |
| OnOptionsItemSelected(IMenuItem) |
Voir aussi : (Hérité de Dialog) |
| OnOptionsMenuClosed(IMenu) |
Voir aussi : (Hérité de Dialog) |
| OnPanelClosed(Int32, IMenu) |
Appelé lorsqu’un panneau est fermé. (Hérité de Dialog) |
| OnPrepareOptionsMenu(IMenu) |
Il est généralement sûr de proxyer cet appel à l’activité du propriétaire.onPrepareOptionsMenu(Menu) si le client souhaite le même menu pour cette boîte de dialogue. (Hérité de Dialog) |
| OnPreparePanel(Int32, View, IMenu) |
Préparez un panneau à afficher. (Hérité de Dialog) |
| OnRestoreInstanceState(Bundle) |
Restaurez l’état de la boîte de dialogue à partir d’un bundle précédemment enregistré. (Hérité de Dialog) |
| OnSaveInstanceState() |
Enregistre l’état de la boîte de dialogue dans un bundle. (Hérité de Dialog) |
| OnSearchRequested() |
Ce hook est appelé lorsque l’utilisateur signale le désir de démarrer une recherche. (Hérité de Dialog) |
| OnSearchRequested(SearchEvent) |
Ce hook est appelé lorsque l’utilisateur signale le désir de démarrer une recherche. (Hérité de Dialog) |
| OnStart() |
Appelé lorsque la boîte de dialogue démarre. (Hérité de Dialog) |
| OnStop() |
Appelé pour vous dire que vous arrêtez. (Hérité de Dialog) |
| OnTouchEvent(MotionEvent) |
Appelé lorsqu’un événement d’écran tactile n’a pas été géré par l’un des affichages sous celui-ci. (Hérité de Dialog) |
| OnTrackballEvent(MotionEvent) |
Appelé lorsque le trackball a été déplacé et non géré par l’une des vues à l’intérieur de l’activité. (Hérité de Dialog) |
| OnWindowAttributesChanged(WindowManagerLayoutParams) |
Cela est appelé chaque fois que les attributs de fenêtre actuels changent. (Hérité de Dialog) |
| OnWindowFocusChanged(Boolean) |
Ce hook est appelé chaque fois que le focus de la fenêtre change. (Hérité de Dialog) |
| OnWindowStartingActionMode(ActionMode+ICallback, ActionModeType) |
Appelé lorsqu’un mode d’action est démarré pour cette fenêtre. (Hérité de Dialog) |
| OnWindowStartingActionMode(ActionMode+ICallback) |
Appelé lorsqu’un mode d’action est démarré pour cette fenêtre. (Hérité de Dialog) |
| OpenContextMenu(View) |
Voir aussi : (Hérité de Dialog) |
| OpenOptionsMenu() |
Voir aussi : (Hérité de Dialog) |
| RegisterForContextMenu(View) |
Voir aussi : (Hérité de Dialog) |
| RequestWindowFeature(Int32) |
Activer les fonctionnalités de fenêtre étendues. (Hérité de Dialog) |
| RequireViewById(Int32) |
Recherche la première vue descendante avec l’ID donné ou lève une exception IllegalArgumentException si l’ID n’est pas valide (< 0), il n’existe aucune vue correspondante dans la hiérarchie, ou la boîte de dialogue n’a pas encore été entièrement créée (par exemple, via show() ou create()). (Hérité de Dialog) |
| SetCancelable(Boolean) |
Définit si cette boîte de dialogue est annulable avec la clé BACK. (Hérité de Dialog) |
| SetCanceledOnTouchOutside(Boolean) |
Définit si cette boîte de dialogue est annulée lorsqu’elle est tactile en dehors des limites de la fenêtre. (Hérité de Dialog) |
| SetCancelMessage(Message) |
Définissez un message à envoyer lorsque la boîte de dialogue est annulée. (Hérité de Dialog) |
| SetContentView(Int32) |
Définissez le contenu de l’écran à partir d’une ressource de disposition. (Hérité de Dialog) |
| SetContentView(View, ViewGroup+LayoutParams) |
Définissez le contenu de l’écran sur une vue explicite. (Hérité de Dialog) |
| SetContentView(View) |
Définissez le contenu de l’écran sur une vue explicite. (Hérité de Dialog) |
| SetDismissMessage(Message) |
Définissez un message à envoyer lorsque la boîte de dialogue est ignorée. (Hérité de Dialog) |
| SetFeatureDrawable(Int32, Drawable) |
Commodité pour appeler android.view.Window.setFeatureDrawable(int,Drawable). (Hérité de Dialog) |
| SetFeatureDrawableAlpha(Int32, Int32) |
Commodité pour appeler Window.setFeatureDrawableAlpha(int, int). (Hérité de Dialog) |
| SetFeatureDrawableResource(Int32, Int32) |
Commodité pour appeler Window.setFeatureDrawableResource(int, int). (Hérité de Dialog) |
| SetFeatureDrawableUri(Int32, Uri) |
Commodité pour appeler Window.setFeatureDrawableUri(int, Uri). (Hérité de Dialog) |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetOnCancelListener(IDialogInterfaceOnCancelListener) |
Définissez un écouteur à appeler lorsque la boîte de dialogue est annulée. (Hérité de Dialog) |
| SetOnDismissListener(IDialogInterfaceOnDismissListener) |
Définissez un écouteur à appeler lorsque la boîte de dialogue est ignorée. (Hérité de Dialog) |
| SetOnKeyListener(IDialogInterfaceOnKeyListener) |
Définit le rappel qui sera appelé si une clé est distribuée dans la boîte de dialogue. (Hérité de Dialog) |
| SetOnShowListener(IDialogInterfaceOnShowListener) |
Définit un écouteur à appeler lorsque la boîte de dialogue s’affiche. (Hérité de Dialog) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
Classe de base pour les présentations. (Hérité de JavaObject) |
| SetTitle(ICharSequence) |
Définissez le texte du titre de la fenêtre de cette boîte de dialogue. (Hérité de Dialog) |
| SetTitle(Int32) |
Définissez le texte du titre de la fenêtre de cette boîte de dialogue. (Hérité de Dialog) |
| SetTitle(String) |
Définissez le texte du titre de la fenêtre de cette boîte de dialogue. (Hérité de Dialog) |
| Show() |
Démarrez la boîte de dialogue et affichez-la à l’écran. (Hérité de Dialog) |
| TakeKeyEvents(Boolean) |
Demandez que les événements clés viennent dans cette boîte de dialogue. (Hérité de Dialog) |
| ToArray<T>() |
Crée un tableau managé à partir de ce wrapper de tableau Java. (Hérité de Object) |
| ToString() |
Retourne une représentation sous forme de chaîne de l’objet. (Hérité de Object) |
| UnregisterForContextMenu(View) |
Voir aussi : (Hérité de Dialog) |
| UnregisterFromRuntime() |
Annule l’inscription de cet homologue Java à partir du runtime d’interopérabilité. (Hérité de Object) |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti> par< em>ou <em>interrompu/em<,> ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Événements
| Nom | Description |
|---|---|
| CancelEvent |
Classe de base pour les présentations. (Hérité de Dialog) |
| DismissEvent |
Classe de base pour les présentations. (Hérité de Dialog) |
| KeyPress |
Classe de base pour les présentations. (Hérité de Dialog) |
| ShowEvent |
Classe de base pour les présentations. (Hérité de Dialog) |
Implémentations d’interfaces explicites
| Nom | Description |
|---|---|
| IJavaPeerable.Disposed() |
Classe de base pour les présentations. (Hérité de JavaObject) |
| IJavaPeerable.Finalized() |
Classe de base pour les présentations. (Hérité de JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
Classe de base pour les présentations. (Hérité de JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Classe de base pour les présentations. (Hérité de JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Classe de base pour les présentations. (Hérité de JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Classe de base pour les présentations. (Hérité de JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
Classe de base pour les présentations. (Hérité de Dialog) |
Méthodes d’extension
| Nom | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
Obtient le nom JNI du type de l’instance |
| JavaAs<TResult>(IJavaPeerable) |
Essayez de forcer |
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Classe de base pour les présentations. |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
Essayez de forcer |