View.FitSystemWindows(Rect) Méthode
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.
Attention
deprecated
Appelé par la hiérarchie d’affichage lorsque les ensembles de contenu d’une fenêtre ont changé, pour lui permettre d’ajuster son contenu en fonction de ces fenêtres.
[Android.Runtime.Register("fitSystemWindows", "(Landroid/graphics/Rect;)Z", "GetFitSystemWindows_Landroid_graphics_Rect_Handler")]
[System.Obsolete("deprecated")]
protected virtual bool FitSystemWindows(Android.Graphics.Rect? insets);[<Android.Runtime.Register("fitSystemWindows", "(Landroid/graphics/Rect;)Z", "GetFitSystemWindows_Landroid_graphics_Rect_Handler")>]
[<System.Obsolete("deprecated")>]
abstract member FitSystemWindows : Android.Graphics.Rect -> bool
override this.FitSystemWindows : Android.Graphics.Rect -> boolParamètres
- insets
- Rect
Ensembles de contenu actuel de la fenêtre. Avant de android.os.Build.VERSION_CODES#JELLY_BEAN ne pas modifier les ensembles ou si vous et Android ne serez pas heureux.
Retours
true si cette vue a appliqué les ensembles et qu’elle ne doit pas continuer à se propager plus loin dans la hiérarchie, false sinon.
- Attributs
Remarques
Appelé par la hiérarchie d’affichage lorsque les ensembles de contenu d’une fenêtre ont changé, pour lui permettre d’ajuster son contenu en fonction de ces fenêtres. Les ensembles de contenu vous indiquent l’espace que la barre d’état, la méthode d’entrée et d’autres fenêtres système enfreintnt la fenêtre de l’application.
Vous n’avez pas normalement besoin de traiter cette fonction, car la décoration de fenêtre par défaut donnée aux applications s’occupe de l’appliquer au contenu de la fenêtre. Si vous utilisez #SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN ou #SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION si ce n’est pas le cas, votre contenu peut être placé sous ces éléments système. Vous pouvez ensuite utiliser cette méthode dans votre hiérarchie d’affichage si vous avez des parties de votre interface utilisateur que vous souhaitez vérifier ne sont pas couvertes.
L’implémentation par défaut de cette méthode applique simplement les ensembles de contenu au remplissage de la vue, en consommant ce contenu (en modifiant les ensembles à 0) et en retournant true. Ce comportement est désactivé par défaut, mais peut être activé via #setFitsSystemWindows(boolean).
La traversée de cette fonction vers le bas de la hiérarchie est de profondeur en premier. Le même objet d’ensembles de contenu est propagé vers le bas de la hiérarchie, de sorte que toutes les modifications apportées à celui-ci sont visibles par toutes les vues suivantes (y compris potentiellement celles ci-dessus dans la hiérarchie, car il s’agit d’une traversée de profondeur en premier). La première vue qui retourne true abandonnera toute la traversée.
L’implémentation par défaut fonctionne bien pour une situation où elle est utilisée avec un conteneur qui couvre toute la fenêtre, ce qui lui permet d’appliquer les ensembles appropriés à son contenu sur tous les bords. Si vous avez besoin d’une disposition plus complexe (par exemple, deux fenêtres système d’ajustement de vues différentes, une en haut de la fenêtre et une en bas), vous pouvez remplacer la méthode et gérer les ensembles toutefois vous le souhaitez. Notez que les ensembles fournis par l’infrastructure sont toujours relatifs aux bords éloignés de la fenêtre, et non à l’emplacement de la vue appelée dans cette fenêtre. (En fait, lorsque cette méthode est appelée, vous ne savez pas encore où la disposition placera la vue, car elle est effectuée avant la disposition.)
Remarque : contrairement à de nombreuses méthodes View, il n’existe aucune phase de distribution à cet appel. Si vous le substituez dans un ViewGroup et que vous souhaitez autoriser l’appel à continuer à vos enfants, vous devez être sûr d’appeler la super implémentation.
Voici un exemple de disposition qui utilise des fenêtres système d’ajustement pour avoir des contrôles pour une vue vidéo placée à l’intérieur des décorations de fenêtre qu’elle masque et affiche. Cela peut être utilisé avec du code comme le deuxième exemple (lecteur vidéo) affiché dans #setSystemUiVisibility(int).
{
Ce membre est déconseillé. À partir de l’API 20, utilisez #dispatchApplyWindowInsets(WindowInsets) pour appliquer des ensembles aux vues. Les vues doivent remplacer #onApplyWindowInsets(WindowInsets) ou utiliser #setOnApplyWindowInsetsListener(android.view.View.OnApplyWindowInsetsListener) pour implémenter la gestion de leurs propres ensembles.
Java documentation pour android.view.View.fitSystemWindows(android.graphics.Rect).
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.