IOnReceiveContentListener.OnReceiveContent(View, ContentInfo) Méthode

Référence

Définition

Espace de noms:: Android.Views

Assembly:: Mono.Android.dll

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.

Recevez le contenu donné.

[Android.Runtime.Register("onReceiveContent", "(Landroid/view/View;Landroid/view/ContentInfo;)Landroid/view/ContentInfo;", "GetOnReceiveContent_Landroid_view_View_Landroid_view_ContentInfo_Handler:Android.Views.IOnReceiveContentListenerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)]
public Android.Views.ContentInfo? OnReceiveContent (Android.Views.View view, Android.Views.ContentInfo payload);

[<Android.Runtime.Register("onReceiveContent", "(Landroid/view/View;Landroid/view/ContentInfo;)Landroid/view/ContentInfo;", "GetOnReceiveContent_Landroid_view_View_Landroid_view_ContentInfo_Handler:Android.Views.IOnReceiveContentListenerInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=31)>]
abstract member OnReceiveContent : Android.Views.View * Android.Views.ContentInfo -> Android.Views.ContentInfo

Paramètres

view: View

Affichage dans lequel l’insertion de contenu a été demandée.

payload: ContentInfo

Contenu à insérer et aux métadonnées associées. La charge utile peut contenir plusieurs éléments et leurs types MIME peuvent être différents (par exemple, un élément d’image et un élément de texte). La charge utile peut également contenir des éléments dont le type MIME n’est pas dans la liste des types MIME spécifiés lorsque View#setOnReceiveContentListener setting l’écouteur. Pour ces éléments, l’écouteur peut rejeter le contenu (différer vers le comportement de la plateforme par défaut) ou exécuter une autre logique de secours (par exemple, afficher un message approprié à l’utilisateur).

Retours

ContentInfo

Partie du contenu transmis dont le traitement doit être délégué à la plateforme. Retourne la valeur Null si tout le contenu a été géré d’une certaine manière. L’insertion réelle du contenu peut être traitée de manière asynchrone en arrière-plan et peut ou non réussir même si cette méthode retourne null. Par exemple, une application peut ne pas insérer un élément s’il dépasse la limite de taille de l’application pour ce type de contenu.

Attributs: RegisterAttribute

Remarques

Recevez le contenu donné.

Les implémentations doivent gérer tous les éléments de contenu intéressants et retourner tous les éléments non gérés afin de préserver le comportement de plateforme par défaut pour le contenu qui n’a pas de gestion spécifique à l’application. Par exemple, une implémentation peut fournir une gestion des URI de contenu (pour prendre en charge l’insertion d’images, etc.) et déléguer le traitement du texte à la plateforme afin de préserver le comportement courant pour l’insertion de texte. Consultez le javadoc de classe pour obtenir un exemple d’implémentation.

<h3>Gestion du contenu< différent/h3><ul><li>Text. Si la ContentInfo#getSource() source valeur est ContentInfo#SOURCE_AUTOFILL autofill, le contenu de la vue doit être entièrement remplacé par le texte transmis. Pour les sources autres que le remplissage automatique, le texte transmis doit remplacer la sélection actuelle ou être inséré à la position actuelle du curseur s’il n’y a pas de sélection. <li>Contenu non texte (par exemple, images). Le contenu peut être inséré en ligne si le widget prend en charge cela, ou il peut être ajouté en tant que pièce jointe (peut être affiché dans une vue complètement distincte). </ul>

<Autorisations< d’URI h3>/h3>

android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION Read permissions sont accordés automatiquement par la plateforme pour n’importe quelle android.content.ContentResolver#SCHEME_CONTENT content URIs charge utile transmise à cet écouteur. Les autorisations sont temporaires et seront publiées automatiquement par la plateforme.

Le traitement du contenu doit normalement être effectué dans un service ou une activité. Pour le traitement long, l’utilisation androidx.work.WorkManager est recommandée. Lors de l’implémentation de ce paramètre, les autorisations doivent être étendues au service ou à l’activité cible en passant le contenu à l’aide android.content.Intent#setClipData Intent.setClipData et android.content.Intent#addFlags(int) setting l’indicateur android.content.Intent#FLAG_GRANT_READ_URI_PERMISSION FLAG_GRANT_READ_URI_PERMISSION.

Sinon, si vous utilisez un thread d’arrière-plan dans le contexte actuel pour traiter le contenu, une référence à l’objet payload doit être conservée pour vous assurer que les autorisations ne sont pas révoquées prématurément.

Documentation Java pour android.view.OnReceiveContentListener.onReceiveContent(android.view.View, android.view.ContentInfo).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

Partager via