ScrollingFrame
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
ScrollingFrame est un type spécial Frame avec une interaction de défilement intégrée et différentes façons de personnaliser la façon dont le défilement fonctionne.
Résumé
Propriétés
La taille de la zone qui peut être déplacée, en décalage.
La taille du cadre, en décalage, sans les barres de défilement.
Détermine si ScrollingFrame.CanvasSize est redimensionné en fonction du contenu enfant.
Image qui s'affiche en bas d'une barre de défilement verticale, ou à droite d'une barre de défilement horizontale (pivotée de 90° vers la gauche pour une barre de défilement horizontale).
Réfléte le décalage positionnel actuel de la toile dans le cadre, en pixels, et définit la position des barres de défilement en conséquence.
Détermine la taille de la zone scrollable.
Détermine si et quand le défilement élastique est autorisé sur les appareils tactiles activables.
Indique si CanvasSize est inséré par ScrollBarThickness sur l'axe horizontal.
Image qui couvre la zone entre TopImage et BottomImage (pivotée de 90° vers la gauche pour une barre de défilement horizontale).
Détermine comment les images de barre de défilement rendues sont colorées.
Détermine l'opacité des images de la barre de défilement.
Épaisseur de la barre de défilement en pixels ; s'applique à la fois aux barres de défilement horizontales et verticales.
Détermine la direction(s) dans laquelle le défilement est autorisé.
Détermine si le défilement est autorisé sur le cadre.
Image qui s'affiche en haut d'une barre de défilement verticale, ou à gauche d'une barre de défilement horizontale (pivotée de 90° vers la gauche pour une barre de défilement horizontale).
Indique si CanvasSize est inséré par ScrollBarThickness sur l'axe vertical.
Indique si la barre de défilement verticale est positionnée à gauche ou à droite de la toile.
Détermine si cet élément d'interface utilisateur coule l'entrée.
Détermine le point d'origine d'un GuiObject , par rapport à sa taille absolue.
Détermine si la redimensionisation se produit en fonction du contenu de l'enfant.
Détermine la couleur de fond GuiObject.
Détermine la transparence du fond et des bords GuiObject.
Détermine la couleur de la bordure GuiObject.
Détermine de quelle manière la bordure GuiObject est disposée par rapport à ses dimensions.
Détermine la largeur des pixels de la bordure GuiObject.
Détermine si le descendant GuiObjects en dehors des limites d'un élément GUI parent doit s'rendu.
Détermine si la souris du joueur est activement pressée sur le GuiObject ou non.
Détermine si la GuiButton peut être interagie ou non, ou si la GuiState du GuiObject change ou non.
Contrôle l'ordre de tri des GuiObject lorsqu'ils sont utilisés avec un UIGridStyleLayout .
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de manette sera déplacé vers le bas.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de manette sera déplacé à gauche.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de manette sera déplacé à droite.
Définit le GuiObject qui sera sélectionné lorsque le sélecteur de manette sera déplacé vers le haut.
Détermine la position pixelaire et vectorielle du GuiObject .
Détermine le nombre de degrés par lesquels le GuiObject est pivoté.
Déterminez si le GuiObject peut être sélectionné par une manette de jeu.
Annule la décoration de sélection par défaut utilisée pour les gamepads.
L'ordre de GuiObjects sélectionné par la sélection de l'interface de jeu.
Détermine la taille des pixels et des échelles du GuiObject .
Définit les axes Size sur lesquels la GuiObject sera basée, par rapport à la taille de son parent.
Une propriété mixée de BackgroundTransparency et TextTransparency.
Détermine si le GuiObject et ses descendants seront rendus.
Détermine l'ordre dans lequel un GuiObject rendu se rapporte aux autres.
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.
Méthodes
Méthodes hérités de GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Déplace doucement une GUI vers une nouvelle UDim2.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Redimensionne sans problème un GuiObject à un nouveau UDim2.
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Déplace doucement une interface graphique à une nouvelle taille et position.
Évènements
Évènements hérités de GuiObjectTiré lorsqu'un utilisateur commence à interagir via un appareil d'interface humain-ordinateur (bouton de souris vers le bas, toucher début, bouton de clavier vers le bas, etc).
Tiré lorsqu'un utilisateur modifie la façon dont il interagit via un appareil d'interface homme-ordinateur (bouton de souris vers le bas, toucher début, bouton de clavier vers le bas, etc.).
Tiré lorsqu'un utilisateur cesse d'interagir via un appareil d'interface humain-ordinateur (bouton de souris vers le bas, toucher début, bouton du clavier vers le bas, etc).
Se déclenche lorsqu'un utilisateur déplace sa souris dans un élément GUI.
Se déclenche lorsqu'un utilisateur déplace sa souris en dehors d'un élément GUI.
Se déclenche chaque fois qu'un utilisateur déplace sa souris alors qu'elle se trouve à l'intérieur d'un élément GUI.
Se déclenche lorsqu'un utilisateur fait défiler la molette de sa souris en arrière lorsque la souris se trouve sur un élément de l'interface graphique.
Se déclenche lorsqu'un utilisateur fait défiler sa molette de souris vers l'avant lorsque la souris se trouve sur un élément de l'interface graphique.
Tiré lorsque l'objet Gui est mis en évidence avec le sélecteur de manette.
Tiré lorsque le sélecteur de manette arrête de se concentrer sur l'objet Gui.
Se déclenche lorsque le joueur commence, continue et s'arrête en appuyant longuement sur l'élément d'interface utilisateur.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur déplace son doigt sur l'élément d'interface utilisateur.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur effectue une gestuelle de pinçage ou de tirage à l'aide de deux doigts sur l'élément d'interface.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Se déclenche lorsque le joueur effectue une gestuelle de rotation à l'aide de deux doigts sur l'élément d'interface utilisateur.
Se déclenche lorsque le joueur effectue une gestuelle de glissement sur l'élément d'interface utilisateur.
S'enflamme lorsque le joueur effectue une gestuelle de tap sur l'élément d'interface.
- 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
AbsoluteCanvasSize
La taille de la zone qui peut être déplacée, en décalage.Cette propriété est définie sur la valeur maximale de la propriété CanvasSize et la taille des enfants si AutomaticCanvasSize est définie sur autre chose que Enum.AutomaticSize.None.
AutomaticCanvasSize
Cette propriété est utilisée pour dimensionner automatiquement les objets d'interface utilisateur parents en fonction de la taille de leurs descendants.Vous pouvez utiliser cette propriété pour ajouter dynamiquement du texte et d'autres contenus à un ScrollingFrame à l'édition ou au moment de l'exécution, et la taille s'ajustera pour s'adapter à ce contenu.
Lorsque cette propriété est définie sur une valeur Enum.AutomaticSize autre que None, AbsoluteCanvasSize peut redimensionner en fonction de son contenu enfant.
BottomImage
Image qui s'affiche en bas d'une barre de défilement verticale, ou à droite d'une barre de défilement horizontale (pivotée de 90° vers la gauche pour une barre de défilement horizontale).
CanvasPosition
Réfléte le décalage positionnel actuel de la toile dans le cadre, en pixels, et définit la position des barres de défilement en conséquence.Notez que cette propriété ne fait rien si les barres de défilement ne sont pas visibles.
CanvasSize
Détermine la taille de la zone scrollable.Pour une alternative adaptative basée sur la taille globale des enfants dans le ScrollingFrame , envisagez d'utiliser AutomaticCanvasSize .
ElasticBehavior
Cette propriété détermine si et quand le défilement élastique est autorisé sur les appareils activables par le toucher. Par défaut, c'est WhenScrollable .
HorizontalScrollBarInset
Indique si CanvasSize est inséré par ScrollBarThickness sur l'axe horizontal.
MidImage
Image qui couvre la zone entre TopImage et BottomImage (pivotée de 90° vers la gauche pour une barre de défilement horizontale).Cette image s'adapte automatiquement pour remplir l'espace entre les segments de couverture.
ScrollBarImageColor3
Détermine comment les images de la barre de défilement ( TopImage , MidImage , BottomImage ) sont colorées.Lorsqu'il est réglé sur blanc, aucune coloration n'a lieu.Cette propriété est utile pour réutiliser des ressources d'image ; si les images sources sont complètement blanches avec de la transparence, vous pouvez définir la couleur de la barre de défilement entière à la fois.
ScrollBarImageTransparency
Détermine l'opacité des images de la barre de défilement ( TopImage , MidImage , BottomImage ).Une valeur de 0 est complètement opaque et une valeur de 1 est complètement transparente (invisible).
ScrollBarThickness
Épaisseur de la barre de défilement en pixels ; s'applique à la fois aux barres de défilement horizontales et verticales. Si elle est réglée sur 0, aucune barre de défilement n'est rendue.
ScrollingDirection
Cette propriété détermine la direction(s) dans laquelle le défilement est autorisé.Si la défilement est interdit dans une direction, la barre de défilement associée n'apparaîtra pas.Par défaut à Enum.ScrollingDirection.XY.
ScrollingEnabled
Détermine si le défilement est autorisé sur le cadre. Si false , aucune barre de défilement ne sera rendue.
TopImage
Image qui s'affiche en haut d'une barre de défilement verticale, ou à gauche d'une barre de défilement horizontale (pivotée de 90° vers la gauche pour une barre de défilement horizontale).
VerticalScrollBarPosition
Indique si la barre de défilement verticale est positionnée à gauche ou à droite de la toile. Défaut à Enum.VerticalScrollBarPosition.Right .