ScreenGui
*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.

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
Si cliper le contenu de ce ScreenGui à la zone sûre de l'appareil.
Contrôle l'ordre de l'index Z dans lequel plusieurs conteneurs ScreenGui sont dessinés.
Détermine si les ScreenGui débordent dans la gamme des éléments d'interface utilisateur principaux de Roblox.
Spécifie si des transformations d'interface utilisateur automatiques sont appliquées au descendant « plein écran » GuiObjects sur les écrans avec des coupes d'écran.
Contrôle les insérats de la zone de sécurité qui sont appliqués au contenu du ScreenGui.
Bascule la visibilité de ce LayerCollector .
Détermine si les réinitialisations de LayerCollector (se supprime et se réclone dans le personnage du joueur de PlayerGui ) se produisent chaque fois que le personnage du joueur réapparaît.
Contrôle comment GuiObject.ZIndex se comporte sur tous les descendants de ce LayerCollector .
Décrit la position réelle d'un élément GuiBase2d sur l'écran, en pixels.
Décrit la rotation réelle de l'écran d'un élément GuiBase2d en degrés.
Décrit la taille réelle de l'écran d'un élément GuiBase2d, en pixels.
Lorsqu'il est défini à true, la localisation sera appliquée à ce GuiBase2d et à ses descendants.
Une référence à un LocalizationTable à utiliser pour appliquer une localisation automatisée à ce GuiBase2d et à ses descendants.
Personnalise le comportement de sélection du manette de jeu dans la direction descendante.
Personnalise le comportement de sélection du manette de jeu dans la direction de gauche.
Personnalise le comportement de sélection du gamepad dans la bonne direction.
Personnalise le comportement de sélection du gamepad dans la direction vers le haut.
Permet la personnalisation du mouvement de sélection du gamepad.
Évènements
Évènements hérités de GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se déclenche lorsque la sélection de la manette de jeu se déplace, quitte ou change dans le connecteur GuiBase2d ou dans n'importe quel descendant GuiObjects.
Propriétés
ClipToDeviceSafeArea
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.
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
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
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
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
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
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.

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.