ChatWindowConfiguration
*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 fenêtre de chat textuelle par défaut. Elle est parentée à TextChatService .
Résumé
Propriétés
Position réelle de l'écran de la fenêtre de chat par défaut, en pixels.
Taille réelle de la fenêtre de chat par défaut, en pixels.
Couleur de fond de la fenêtre de chat par défaut.
Transparence de fond de la fenêtre de chat par défaut.
Si afficher la fenêtre de chat par défaut.
Police utilisée pour rendre le texte dans la fenêtre de chat par défaut.
Facteur par lequel la hauteur de la fenêtre de chat par défaut doit être mise à l'échelle.
Alignement horizontal de la fenêtre de chat.
Couleur du texte dans la fenêtre de chat par défaut.
Taille du texte dans la fenêtre de chat par défaut.
Couleur du trait de texte pour le texte dans la fenêtre de chat par défaut.
Transparence du trait de texte pour le texte dans la fenêtre de chat par défaut.
Alignement vertical de la fenêtre de chat.
Facteur par lequel la largeur de la fenêtre de chat par défaut doit être mise à l'échelle.
Méthodes
Crée une nouvelle instance ChatWindowMessageProperties qui peut être utilisée pour personnaliser l'apparence des messages dans la fenêtre de chat.
Propriétés
AbsolutePosition
Propriété de lecture seule qui fournit la position de l'écran de la fenêtre 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 fenêtre de chat par défaut en pixels. Se comporte de manière similaire à GuiBase2d.AbsoluteSize.
BackgroundColor3
Couleur de fond de la fenêtre de chat par défaut.Si la couleur de fond n'est pas remplacée, cette valeur respectera la valeur de l'utilisateur GuiService.PreferredTransparency en rendant le menu plus gris à mesure que la transparence du menu diminue.La valeur par défaut est Color3.new(25, 27, 29) .
BackgroundTransparency
Transparence de fond de la fenêtre 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 fenêtre de chat, qui peut être plus opaque que cette valeur définie ici.La valeur par défaut est 0.3 .
FontFace
Police utilisée pour rendre le texte dans la fenêtre de chat par défaut. La valeur par défaut est Enum.Font.BuilderSansMedium .
HeightScale
Facteur par lequel la hauteur de la fenêtre de chat par défaut doit être mise à l'échelle.Doit être une valeur entre 0.5 et 2.Définir une valeur en dehors de la plage clame la valeur réelle à la limite la plus proche.
HorizontalAlignment
Alignement horizontal de la fenêtre de chat.Comporte de manière similaire à UIGridStyleLayout.HorizontalAlignment.Réglage à Left ou Right en ajoutant un petit espace loin de toucher l'extrémité horizontale correspondante de l'écran.Le paramètre à Center aligne la fenêtre au milieu horizontal de l'écran.La valeur par défaut est Left .
TextColor3
Couleur du texte dans la fenêtre de chat par défaut. La valeur par défaut est Color3.new(255, 255, 255) .
TextStrokeColor3
Couleur du trait de texte pour le texte dans la fenêtre de chat par défaut. La valeur par défaut est Color3.new(0, 0, 0) .
TextStrokeTransparency
Transparence du trait du texte pour le texte dans la fenêtre de chat par défaut. La valeur par défaut est 0.5 .
VerticalAlignment
Alignement vertical de la fenêtre de chat.Comporte de manière similaire à UIGridStyleLayout.VerticalAlignment.Le paramètre à Top ou Bottom ajoute un petit espace loin de toucher l'edge correspondante de l'écran.Le paramètre à Center aligne la fenêtre au milieu vertical de l'écran.La valeur par défaut est Top .
WidthScale
Facteur par lequel la largeur de la fenêtre de chat par défaut doit être mise à l'échelle.Doit être une valeur entre 0.5 et 2.Définir une valeur en dehors de la plage clame la valeur réelle à la limite la plus proche.
Méthodes
DeriveNewMessageProperties
Crée une nouvelle instance ChatWindowMessageProperties qui peut être utilisée pour personnaliser l'apparence des messages dans la fenêtre de chat. ChatWindowMessageProperties hérite de TextChatMessageProperties.
Cela est destiné à être utilisé lors de rappels personnalisés TextChatService.OnChatWindowAdded .
local TextChatService = game:GetService("TextChatService")
local ChatWindowConfiguration = TextChatService.ChatWindowConfiguration
TextChatService.OnChatWindowAdded = function(textChatMessage)
local properties = ChatWindowConfiguration:DeriveNewMessageProperties()
if textChatMessage.Metadata == "Important" then
properties.TextColor3 = Color3.fromRGB(255, 0, 0)
end
return properties
end
Retours
Échantillons de code
This example checks if two users can chat, creates a new TextChannel, and adds them to it.
local TextChatService = game:GetService("TextChatService")
local directChatParticipants = TextChatService:CanUsersDirectChatAsync(userId1, { userId2 })
-- Check for eligible participants
if #directChatParticipants > 0 then
local directChannel = Instance.new("TextChannel")
directChannel.Parent = TextChatService
for _, participant in directChatParticipants do
directChannel:AddUserAsync(participant)
end
return directChannel
end
warn("Could not create TextChannel. Not enough eligible users.")
return nil