UIGridLayout

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.

Un UIGridLayout (ne pas être confondu avec l'interface abstraite UIGridStyleLayout dont cette classe hérite) définit des éléments d'interface frères dans plusieurs colonnes dans l'élément parent, ajoutant des éléments à une colonne à la fois jusqu'à ce que l'élément suivant ne soit pas en mesure de s'y insérer.Il poursuit ensuite l'ajout d'éléments dans la prochaine colonne.Un UIGridLayout prendra les éléments d'interface utilisateur GuiObject.Size et GuiObject.Position sous contrôle.Pendant qu'ils sont sous contrôle, les propriétés de ces éléments d'interface ne seront pas modifiables dans la fenêtre propriétés.

Par défaut, il organise les éléments dans l'ordre ascendant où les valeurs inférieures prennent plus de priorité sur les valeurs plus élevées, mais cela peut être modifié pour utiliser les noms des éléments en changeant en Nom .Un UIListLayout réorganisera automatiquement les éléments lorsque des éléments sont ajoutés/supprimés ou si une propriété pertinente change : GuiObject.LayoutOrder ou Instance.Name .Cela peut être déclenché manuellement en appelant UIGridStyleLayout:ApplyLayout() , bien que ce ne soit généralement pas nécessaire.

Les tailles de cellule réelles sont les mêmes pour toutes les cellules.Un UIGridLayout respectera les contraintes d'interface utilisateur placées avec lui, telles que UISizeConstraint et UIAspectRatioConstraint.Les éléments dans la mise en page peuvent couvrir plusieurs cellules s'ils ont un UISizeConstraint avec un MinSize jeu de paramètres supérieur au CellSize .Il est possible de limiter le nombre d'éléments par rang en utilisant UIGridLayout.FillDirectionMaxCells .Si la valeur est réglée sur 1, il est possible de créer une seule rangée d'éléments (comme chaque élément serait positionné dans sa propre rangée).

Ce format est approprié lorsque les breaks de ligne sont OK après des cellules arbitraires.Par exemple, un ensemble d'espaces d'inventaire est un bon usage de ce format.Si vous construisez une table de valeurs dans laquelle une rupture de ligne n'est pas appropriée au milieu des données tabulaires, il peut être une meilleure idée d'utiliser un UITableLayout à la place.

Résumé

Propriétés

  • Lecture uniquement
    Non répliqué

    Le nombre d'éléments dans la grille.

  • Lecture uniquement
    Non répliqué

    La taille absolue de chaque élément dans la grille.

  • Lecture parallèle

    Détermine la quantité d'espace entre les éléments dans la grille.

  • Lecture parallèle

    Détermine la taille de chaque élément dans la grille.

  • Lecture parallèle

    Détermine le nombre maximum de cellules qui peuvent être utilisées en ligne ou en colonne avant le début de la suivante.

  • Lecture parallèle

    Détermine à partir de quel coin la grille commence à déployer des éléments d'interface utilisateur.

Propriétés hérités de UIGridStyleLayout

Propriétés

AbsoluteCellCount

Lecture uniquement
Non répliqué

Mesure le nombre maximum d'éléments dans chaque direction. Lecture seule.

AbsoluteCellSize

Lecture uniquement
Non répliqué

Fournit la taille de chaque élément de la grille en décalage.Lecture seule.Non affecté par tout UIScale , UISizeConstraint ou UIAspectRatioConstraint appliqué à tout élément individuel dans la grille.

CellPadding

Lecture parallèle

(par défaut 0, 5, 0, 5) Détermine la quantité d'espace entre les éléments dans la grille.Comme pour tous les UDim2s, cet espace peut être à la fois dans un pourcentage de la taille du conteneur parent et de l'offset de pixel brut.

CellSize

Lecture parallèle

(par défaut 0, 100, 0, 100) Détermine la taille de chaque élément dans la grille.Comme pour tous les UDim2s, cette taille peut être à la fois dans un pourcentage de la taille du conteneur parent et dans un décalage de pixel décentrage.Si l'élément à la taille a un UIConstraint alors la taille sera déterminée par la contrainte, pas la grille.

FillDirectionMaxCells

Lecture parallèle

FillDirectionMaxCells détermine le nombre de cellules dans la grille qui peuvent être utilisées avant de poursuivre sur la prochaine ligne/ colonne (si cela est une ligne ou une colonne dépend de UIGridStyleLayout.FillDirection ).Cette valeur doit être non négative.

  • Si la valeur est réglée sur zéro, il n'y a pas de nombre maximum de cellules qui peuvent apparaître dans une colonne/ligne à l'exception du nombre de cellules qui peuvent tenir dans l'élément parent de l'interface utilisateur.
  • Si elle est réglée sur une, cela crée une liste similaire à celles créées par UIListLayout.

StartCorner

Lecture parallèle

StartCorner ( Enum.StartCorner ) détermine à partir de quel coin la grille commence à déployer des éléments d'interface utilisateur.La grille se poursuit dans le UIGridStyleLayout.FillDirection , remplissant les éléments un par un jusqu'à ce que UIGridLayout.FIllDirectionMaxCells cellules aient été disposées dans cette rangée/ colonne ou si l'espace de l'élément parent de l'interface utilisateur a été occupé par des cellules précédentes.

En haut, la potion est la première ImageLabel, suivie de la gemme et de l'épée.La mise en page UIGrid utilise un Enum.StartCorner de BottomRight.Le UIGridStyleLayout.FillDirection est horizontal.

Méthodes

Évènements