ChatInputBarConfiguration
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
Configure les propriétés de la barre de saisie de chat par défaut. Il est associé à TextChatService.
Résumé
Propriétés
Position d'écran actuelle de la barre d'entrée par défaut dans les pixels.
Taille d'écran actuelle de la barre d'entrée par défaut dans les pixels.
Si activer l'autocomplétion pour la barre de saisie de chat.
Couleur de l'arrière-plan de la barre d'entrée par défaut.
Transparence de l'arrière-plan de la barre d'entrée par défaut.
Afficher la barre d'entrée de chat par défaut.
Police utilisée pour rendre le texte dans la barre d'entrée par défaut.
Que la barre d'entrée par défaut du chat soit ou non focalisée.
Les utilisateurs clés supplémentaires peuvent appuyer pour activer le focus sur la barre d'entrée par défaut.
Couleur du texte du modèle de texte dans la barre d'entrée par défaut.
Une référence à la cible TextChannel .
Référence à une instance TextBox définie qui envoie des messages au nom de l'utilisateur.
Couleur du texte dans la barre de saisie de chat par défaut.
Taille du texte dans la barre d'entrée par défaut.
Couleur du texte de l'épée pour le texte par défaut dans la barre d'entrée de chat.
Transparence du texte de la couleur pour le texte dans la barre d'entrée par défaut.
Propriétés
AbsolutePosition
Propriété de lecture qui fournit la position de l'écran de l'entrée de discussion par défaut en pixels. Comporte également la même chose que GuiBase2d.AbsolutePosition.
AbsoluteSize
Propriété de lecture qui fournit la taille de l'écran de l'entrée de chat par défaut en pixels. Se comporte comme GuiBase2d.AbsoluteSize .
AutocompleteEnabled
Si activer l'autocomplétion pour la barre de saisie de chat. Défini sur false pour désactiver l'autocomplétion.
BackgroundColor3
Couleur de l'arrière-plan de la barre d'entrée par défaut. La valeur par défaut est Color3.new(25, 27, 29) .
BackgroundTransparency
Transparence de l'arrière-plan de la barre de saisie de chat par défaut comme un nombre entre 0 et 1. Ce valeur est multipliée avec le GuiService.PreferredTransparency de l'utilisateur pour créer la transparence d'arrière-plan efficace utilisée par la barre de saisie de chat, qui peut être plus opaque que ce valeur définie
FontFace
Police utilisée pour rendre le texte dans la barre d'entrée par défaut. Par défaut, c'est Enum.Font.BuilderSansMedium .
IsFocused
Indique si la barre d'entrée de chat par défaut est concentrée ou non. Utile pour tirer les événements de propriété modifiés afin que vous puissiez implémenter des fonctions d'appel qui répondent au changement de l'état de focus de la barre d'entrée.
Échantillons de code
local Players = game:GetService("Players")
local TextChatService = game:GetService("TextChatService")
local ChatInputBarConfiguration = TextChatService:FindFirstChildOfClass("ChatInputBarConfiguration")
local BubbleChatConfiguration = TextChatService:FindFirstChildOfClass("BubbleChatConfiguration")
local LocalPlayer = Players.LocalPlayer
local Character = LocalPlayer.Character or LocalPlayer.CharacterAdded:Wait()
-- Set up TextLabel
local textLabel = Instance.new("TextLabel")
textLabel.Size = UDim2.fromScale(1, 1)
textLabel.Text = ". . ."
textLabel.BackgroundColor3 = BubbleChatConfiguration.BackgroundColor3
textLabel.BorderColor3 = BubbleChatConfiguration.BackgroundColor3
textLabel.BackgroundTransparency = BubbleChatConfiguration.BackgroundTransparency
textLabel.TextColor3 = BubbleChatConfiguration.TextColor3
textLabel.FontFace = BubbleChatConfiguration.FontFace
textLabel.TextSize = BubbleChatConfiguration.TextSize
-- Parent a UICorner to the TextLabel to have rounded corners
local uiCorner = Instance.new("UICorner")
uiCorner.CornerRadius = UDim.new(0,12)
uiCorner.Parent = textLabel
-- Set up Billboard
local typingIndicatorBillboard = Instance.new("BillboardGui")
typingIndicatorBillboard.Enabled = false
typingIndicatorBillboard.Size = UDim2.fromScale(1, 1)
typingIndicatorBillboard.StudsOffsetWorldSpace = Vector3.new(-0,4,0)
typingIndicatorBillboard.Adornee = Character
textLabel.Parent = typingIndicatorBillboard
typingIndicatorBillboard.Parent = LocalPlayer:FindFirstChildOfClass("PlayerGui")
ChatInputBarConfiguration:GetPropertyChangedSignal("IsFocused"):Connect(function()
-- Enable the typing indicator when the input bar is focused and disable otherwise
typingIndicatorBillboard.Enabled = ChatInputBarConfiguration.IsFocused
end)
KeyboardKeyCode
Les utilisateurs de clés supplémentaires peuvent appuyer pour activer le focus sur la barre de saisie de chat par défaut. Utile lorsque vous voulez avoir un raccourci clé supplémentaire pour le focus en plus de la touche /.
PlaceholderColor3
Couleur du texte du masque de texte dans la barre d'entrée par défaut. La valeur par défaut est Color3.new(178, 178, 178) .
TargetTextChannel
Déterminez lequel TextChannel à utiliser lorsque l'utilisateur envoie un message avec la barre d'entrée de chat par défaut.
TextBox
Référence à une instance TextBox définie qui envoie des messages au nom de l'utilisateur. Vous pouvez l'utiliser pour intégrer plus intégrer votre bar d'entrée de chat personnalisé dans votre expérience en manipulant librement l'apparence, le lieu et la disposition. Lorsque vous choisissez d'opter pour définir cette propriété sur un TextBox personnalisé, vous n'avez pas besoin d'écrire
- Lorsqu'un utilisateur saisit un message et appuie sur Enum.KeyCode.Return, le message est envoyé à ChatInputBarConfiguration.TargetTextChannel .
- Lorsqu'un message est envoyé, TextBox.Text sera automatiquement effacer.
Pour la sécurité, certaines limites sont imposées sur le TextBox lorsqu'il est promu en ChatInputBarConfiguration.TextBox. Le code Lua ne pourra pas :
- Changez la propriété TextBox.Text.
- Utilisez les méthodes TextBox:CaptureFocus() ou TextBox:ReleaseFocus().
TextColor3
Couleur du texte dans la barre de saisie de chat par défaut. La valeur par défaut est Color3.new(255, 255, 255) .
TextSize
Taille du texte dans la barre de saisie de chat par défaut. La valeur par défaut est 14 .
TextStrokeColor3
Couleur du texte de l'épée pour le texte dans la barre d'entrée par défaut. La valeur par défaut est Color3.new(0, 0, 0) .
TextStrokeTransparency
Transparence du texte pour le texte dans la barre de saisie de chat par défaut. La valeur par défaut est 0.5 .