配置默认文本聊天输入栏的属性。它是父级的 TextChatService 。
概要
属性
在像素的默认聊天输入栏的实际屏幕位置。
默认聊天输入框的实际屏幕大小。
是否启用聊天输入栏的自动完成。
默认聊天输入框的背景颜色。
默认聊天输入框的背景透明度。
是否显示默认聊天输入栏。
用于在默认聊天输入栏中渲染文本的字体。
是否显示或不显示默认聊天输入栏。
额外的键用户可以按下以在默认聊天输入栏上集中。
在默认聊天输入栏中的占位符文本颜色。
一个引用目标 TextChannel 。
参考用户 behalf 发送消息的指定 TextBox 实例。
默认聊天输入栏中的文本颜色。
默认聊天输入栏的文本大小。
默认聊天输入栏中的文本颜色。
默认聊天输入栏中的文本溢色的透明度。
属性
BackgroundTransparency
默认聊天输入栏的背景透明度作为数字在 0 和 1 之间。 此值与用户的 GuiService.PreferredTransparency 乘以使用户在此处设置的默认值,可能比此值集在这里。默认值为 1> 0.21>。
IsFocused
指示是否显示默认聊天输入栏的焦点。 有助于发射属性更改事件,以便您可以实现在输入栏的焦点状态下响应的回调函数。
代码示例
Typing Indicator Bubble
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)
TextBox
在代表用户发送消息的指定 TextBox 实例上的引用。您可以使用它来在您的体验中自由操作外观、位置和布局,以进一步集成您的自定义聊天输入栏用户界面。当您选择将此属性设置为自定义 TextBox 时,您不需要写代码为以下行为:
- 当用户键入一条消息并按下 Enum.KeyCode.Return 时,消息将发送到 ChatInputBarConfiguration.TargetTextChannel 。
- 当发送消息时,TextBox.Text 将自动清除。
为了安全,一些限制在TextBox升级到ChatInputBarConfiguration.TextBox时会被禁用。 Lua 代码将无法:
- 改变 TextBox.Text 属性。