ScreenGui

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

ScreenGui est un conteneur de stockage pour 2D GuiObjects affiché sur l'écran de l'utilisateur.Un ScreenGui ne s'affiche que si il est parenté à un joueur de PlayerGui ; parenter un ScreenGui à StarterGui garantit qu'il se clone dans chaque joueur de PlayerGui lorsqu'ils rejoignent l'expérience et que leur personnage apparaît en premier.Voir Conteneurs d'interface utilisateur sur écran pour plus de détails.

Example ScreenGui with various GuiObject children, including a Frame, TextLabel, TextBox, and ImageButton.

Pour les améliorations des performances, l'apparence d'un ScreenGui est mise en cache jusqu'à ce qu'un des événements suivants se produise :

  • Un descendant est ajouté ou supprimé de celui-ci.
  • Une propriété d'un descendant change.
  • Une propriété de la ScreenGui elle-même change.

Si l'un de ces événements survernir, l'apparence ScreenGui est récalculée sur le prochain cadre qu'il reçoit.

Résumé

Propriétés

Propriétés hérités de LayerCollectorPropriétés hérités de GuiBase2d

Évènements

Évènements hérités de GuiBase2d

Propriétés

ClipToDeviceSafeArea

Lecture parallèle

Si cette propriété est true , tous les descendants de GuiObject de la propriété ScreenGui seront coupés dans la zone sûre de l'appareil (voir Enum.ScreenInsets ).La valeur par défaut est true pour maintenir la compatibilité ascendante de l'interface utilisateur qui est intentionnellement cachée hors écran, comme les objets qui glissent en vue à partir d'un bord d'écran lorsqu'ils sont nécessaires.

Mobile device showing UI button clipped by device safe
area

Si cette propriété est false , GuiObject les descendants ne seront pas coupés dans la zone sûre de l'appareil et peuvent être obstrués par le notch de la caméra ou d'autres découpes d'écran

Mobile device showing UI button overflowing device safe
area, obscured by screen camera notch

Notez que cette propriété sera ignorée si vous définissez ScreenInsets à None, car cela implique que vous voulez intentionnellement ignorer les insérés sûrs du appareil.

DisplayOrder

Lecture parallèle

Cette propriété contrôle l'ordre Z-index dans lequel plusieurs conteneurs ScreenGui sont dessinés.Ceux avec une valeur plus élevée DisplayOrder seront dessinés au-dessus de ceux avec une valeur inférieure.

IgnoreGuiInset

Non répliqué
Lecture parallèle

Si cette propriété est false (par défaut), ScreenInsets est définie à CoreUISafeInsets , ce qui maintient efficacement ses limites en dessous de l'interface utilisateur principale de Roblox.

Si cette propriété est modifiée à true et ScreenInsets est actuellement définie à CoreUISafeInsets , ScreenInsets sera définie à DeviceSafeInsets .

Voir ScreenInsets pour les détails sur la façon dont les insérats d'écran affectent le contenu d'un ScreenGui .

SafeAreaCompatibility

Lecture parallèle

Cette propriété spécifie si des transformations d'interface utilisateur automatiques sont appliquées au descendant « plein écran » GuiObjects du ScreenGui sur les écrans avec des coupes d'écran.L'éligibilité se produit si la superficie totale du descendant GuiObject (y compris toute frontière appliquée ou UIStroke ) couvre la zone sûre de l'appareil à la fois horizontalement et verticalement.Voir la référence Enum.SafeAreaCompatibility enum pour les détails.

La valeur par défaut est FullscreenExtension afin d'améliorer automatiquement l'apparence de l'interface utilisateur qui a été rédigée pour les écrans sans aucune découpe.Cependant, il est recommandé d'éviter les extensions plein écran pour le nouveau travail ; au lieu de cela, utilisez la propriété ScreenInsets pour spécifier les insérats qui doivent être respectés pour différents conteneurs ScreenGui.

Notez que les objets d'interface utilisateur descendants continueront d'être coupés par la zone sûre de l'appareil si ClipToDeviceSafeArea est réglé sur true .

ScreenInsets

Lecture parallèle

Cette propriété contrôle les insérats d'espace sécurisé qui sont appliqués au contenu du ScreenGui .

La valeur par défaut de CoreUISafeInsets garde tous les descendants GuiObjects à l'intérieur de la zone de sécurité de l'interface utilisateur principale, dégagée des boutons de la barre supérieure de Roblox et d'autres découpes d'écran comme l'encoche de la caméra de l'appareil.

Mobile device showing UI buttons inside core UI safe area

Si vous définissez cette propriété à None, les objets d'interface utilisateur peuvent être obscurcis derrière des objets d'interface utilisateur du noyau ou des découpes d'appareil comme l'encoche de la caméra.Par resultats, vous ne devez utiliser None que pour un ScreenGui contenant du contenu non interactif comme des images de fond.

Voir Conteneurs d'interface utilisateur sur écran pour des exemples alternatifs.

Méthodes

Évènements