ScreenGui
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
L'objet de stockage principal pour 2D GuiObjects affiché sur l'écran de l'joueur. Un ScreenGui ne montre que si son
Pour améliorer les 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é à partir de lui.
- 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 la prochaine fenêtre qui obtient le rendu.
Résumé
Propriétés
Whether to clip the contents of this ScreenGui to the appareil's safe area.
Contrôle l'ordre d'indexation Z dans lequel plusieurs ScreenGuis sont dessinés.
Détermine si ce ScreenGui dépasse dans la portée des éléments de l'interface utilisateur principale de Roblox.
Spécifie si les transformations de compatibilité de l'interface utilisateur automatiques sont appliquées aux descendants plein écranGuiObjects sur les afficheurs avec des coupes d'écran.
Contrôle les zones de sécurité qui sont appliquées aux contenus de ce ScreenGui .
Bascule la visibilité de ce LayerCollector.
Détermine si le LayerCollector réinitialise (se supprime et se clone dans le joueur's PlayerGui ) chaque fois que le personnage du joueur réapparaît.
Contrôle la façon dont GuiObject.ZIndex se comporte sur tous les descendants de ce LayerCollector .
Décrivez la position d'écran réelle d'un élément UI, en pixels.
Décrivez la rotation de l'écran réelle d'un élément UI, en degrés.
Décrivez la taille réelle de l'interface utilisateur, en pixels.
Lorsqu'il est réglé sur vrai, la localisation sera appliquée à ce GuiBase2d et à ses descendants.
Une référence à un LocalizationTable pour être utilisé pour appliquer la localisation automatisée à ce GuiBase2d et à ses descendants.
Personnalise le comportement de sélection du gamepad dans la direction vers le bas.
Personnalise le comportement de sélection du gamepad 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 de la 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 du gamepad se déplace, quitte ou change dans la GuiBase2d ou tout descendant GuiObjects connecté.
Propriétés
ClipToDeviceSafeArea
Si cette propriété est true, tous les descendants de cette GuiObject seront coupés dans la zone de sécurité de l'appareil (voir ScreenGui ) par défaut. Le par défaut est 1> true1> pour maintenir la compatibilité avec l'ancienne version de l'interface utilisateur qui est intentionnellement
Si cette propriété est false , les descendants de GuiObject seront non coupés dans la zone de sécurité du appareilet peuvent être ombrés par la coupure de caméra ou d'autres coupes d'écran.
Remarquez que cette propriété sera ignorée si vous avez configuré ScreenGui.ScreenInsets pour None, car cela implique que vous souhaitez intentionnellement ignorer les ensembles de sécurité du appareil.
DisplayOrder
Cette propriété contrôle l'ordre dans lequel plusieurs ScreenGuis sont dessinés. ScreenGuis avec une valeur supérieure DisplayOrder sera dessiné au-dessus de ceux avec une valeur inférieure.
IgnoreGuiInset
Si cette propriété est false (par défaut), ScreenInsets est réglé sur CoreUISafeInsets, ce qui garde ses limites en dessous de la barre supérieure Roblox.
Si cette propriété est modifiée en true et ScreenInsets est actuellement réglé sur CoreUISafeInsets, 1> Class.ScreenGui.ScreenInsets|ScreenInsets1> sera réglé sur 4> Class.ScreenGui.ScreenInsets|DeviceSafe
Voir ScreenInsets pour plus de détails sur la façon dont les insérés d'écran affectent le contenu d'un ScreenGui .
SafeAreaCompatibility
Cette propriété spécifie si les transformations de compatibilité de l'appareilautomatique s'appliquent à la descendant "plein écran" GuiObjects de ce ScreenGui sur les affichages avec des coupes de sécurité. L
La valeur par défaut est FullscreenExtension afin d'améliorer automatiquement l'apparence de l'interface utilisateur qui a été autorisée pour les écrans sans coupes. Cependant, il est recommandé d'éviter les extensions d'écran pour le travail nouveau; à la place, utilisez la propriété ScreenInsets
Remarquez que les objets d'interface utilisateur descendants seront continuellement coupés par la zone de sécurité de l'appareil si ClipToDeviceSafeArea est réglé sur true .
ScreenInsets
Cette propriété contrôle les ensembles de sécurité qui sont appliqués aux contenus de ce ScreenGui .
La valeur par défaut de CoreUISafeInsets garde tous les descendants GuiObjects à l'intérieur de la zone de sécurité UI du noyau, effacé des boutons de la barre supérieure Roblox et d'autres coupes d'écran comme la niche de la caméra de l'appareil.
Si vous avez défini cette propriété sur None, les objets de l'interface utilisateur peuvent être ombrés derrière les objets de l'interface utilisateur de base ou les découpes d'appareil comme la poignée de caméra. Par resultats, vous ne devriez utiliser que None pour un ScreenGui qui contient du contenu noninteractif comme des images de fond.
Voir Conteneurs d'interface utilisateur sur l'écran pour des exemples alternatifs.