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 d'entrée de chat textuel par défaut. Elle est parentée à TextChatService .
Résumé
Propriétés
Position réelle de l'élément de saisie de chat par défaut en pixels.
Taille réelle de la barre de saisie de chat par défaut en pixels.
Si activer l'autocomplétion pour la barre d'entrée de chat.
Couleur de fond de la barre de saisie de chat par défaut.
Transparence de fond de la barre de saisie de chat par défaut.
Si afficher la barre de saisie de chat par défaut.
Police utilisée pour rendre le texte dans la barre de saisie de chat par défaut.
Si la barre de saisie de chat par défaut est focusée ou non.
Les utilisateurs clés supplémentaires peuvent appuyer pour déclencher la concentration sur la barre d'entrée de chat par défaut.
Couleur du texte du texte de l'espace réservé dans la barre de saisie de chat par défaut.
Une référence à la cible TextChannel.
Référence à une instance désignée TextBox 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 de saisie de chat par défaut.
Couleur du trait de texte pour le texte dans la barre d'entrée de chat par défaut.
Transparence du trait de texte pour le texte dans la barre d'entrée de chat par défaut.
Propriétés
AbsolutePosition
Propriété de lecture seule qui fournit la position de l'écran de la barre de saisie de chat par défaut en pixels. Se comporte de manière similaire à GuiBase2d.AbsolutePosition.
AbsoluteSize
Propriété de lecture seule qui fournit la taille de l'écran de la barre d'entrée de chat par défaut en pixels. Se comporte de manière similaire à GuiBase2d.AbsoluteSize .
AutocompleteEnabled
Si activer l'autocomplétion pour la barre d'entrée de chat. Définir à false pour désactiver l'autocomplétion.
BackgroundColor3
Couleur de fond de la barre de saisie de chat par défaut. La valeur par défaut est Color3.new(25, 27, 29) .
BackgroundTransparency
Transparence arrière-plan de la barre de saisie de chat par défaut comme un nombre entre 0 et 1 .Cette valeur est multipliée par la transparence arrière effective de l'utilisateur GuiService.PreferredTransparency pour créer la transparence arrière effective utilisée par la barre d'entrée de chat, qui peut être plus opaque que la valeur définie ici.La valeur par défaut est 0.2 .
FontFace
Police utilisée pour rendre le texte dans la barre de saisie de chat par défaut. La valeur par défaut est Enum.Font.BuilderSansMedium .
IsFocused
Indique si la barre de saisie de chat par défaut est focusée ou non.Utile pour déclencher des événements de propriété modifiés afin que vous puissiez implémenter des fonctions d'appel qui répondent aux changements dans l'état de concentration de la barre d'entrée.
Échantillons de code
The code below includes a simple way to create a typing indicator bubble above a user's avatar when the user is typing. Paste into a LocalScript.
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 clés supplémentaires peuvent appuyer pour déclencher la concentration sur la barre d'entrée de chat par défaut.Utile lorsque vous souhaitez avoir un raccourci clavier supplémentaire pour vous concentrer en plus de la touche /.
PlaceholderColor3
Couleur du texte du texte de l'espace réservé dans la barre de saisie de chat par défaut. La valeur par défaut est Color3.new(178, 178, 178) .
TargetTextChannel
Détermine lequel TextChannel utiliser lorsque l'utilisateur envoie un message avec la barre de saisie de chat par défaut.
TextBox
Référence à une instance désignée TextBox qui envoie des messages au nom de l'utilisateur.Vous pouvez l'utiliser pour intégrer davantage votre barre de saisie de chat personnalisée dans votre expérience en manipulant librement l'apparence, l'emplacement et le format.Lorsque vous choisissez de définir cette propriété à un comportement personnalisé TextBox, vous n'avez pas besoin d'écrire de code pour le comportement suivant :
- Lorsqu'un utilisateur saisit un message et appuie sur Enum.KeyCode.Return, le message sera envoyé à ChatInputBarConfiguration.TargetTextChannel.
- Lorsqu'un message est envoyé, TextBox.Text sera automatiquement effacer.
Pour des raisons de sécurité, certaines limitations sont imposées sur le TextBox lorsqu'il est promu à ChatInputBarConfiguration.TextBox . Le code Luau ne pourra pas :
- Modifiez 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 trait de texte pour le texte dans la barre de saisie de chat par défaut. La valeur par défaut est Color3.new(0, 0, 0) .
TextStrokeTransparency
Transparence du trait de texte pour le texte dans la barre de saisie de chat par défaut. La valeur par défaut est 0.5 .