ChatWindowConfiguration

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.

Création impossible

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

Méthodes

Propriétés

AbsolutePosition

Lecture uniquement
Non répliqué

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

Lecture uniquement
Non répliqué

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

Lecture parallèle

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

Lecture parallèle

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 .

Enabled

Lecture parallèle

Si afficher la fenêtre de chat par défaut. Désactivé à false pour se masquer.

FontFace

Lecture parallèle

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

Lecture parallèle

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

Lecture parallèle

Couleur du texte dans la fenêtre de chat par défaut. La valeur par défaut est Color3.new(255, 255, 255) .

TextSize

Lecture parallèle

Taille du texte dans la fenêtre de chat par défaut. La valeur par défaut est 14 .

TextStrokeColor3

Lecture parallèle

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

Lecture parallèle

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

Lecture parallèle

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.

CanUsersDirectChatAsync

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

Évènements