設定預設文字聊天輸入欄的屬性。它與 TextChatService 親和。
概要
屬性
目前屏幕位置的預設聊天輸入欄。
目前屏幕大小的預設聊天輸入欄。
是否啟用聊天輸入欄自動完成。
預設聊天輸入欄的背景顏色。
預設聊天輸入欄的背景透明度。
是否顯示預設聊天輸入欄。
一般用於顯示預設聊天輸入欄中的文字。
是否要將預設聊天輸入欄專注或不專注。
額外的鍵使用者可以按一下以專注在預設聊天輸入欄上。
預設聊天輸入欄中的錯誤文字顏色。
一個指向目標 TextChannel 的引用。
參考一個指定的 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 實例,發送代表用戶的訊息。你可以使用它來在你的體驗中自由地集成你的自訂聊天輸入欄表 UI 。當你選擇將此屬性設置為自訂 TextBox 時,你不需要寫任何代碼來實現以下行為:
- 使用者輸入訊息並按下 Enum.KeyCode.Return 時,訊息會傳送至 ChatInputBarConfiguration.TargetTextChannel 。
- 當發送訊息時,TextBox.Text 將自動清除。
為了安全,有一些限制在 TextBox 提升到 ChatInputBarConfiguration.TextBox 時會被加以限制。 Lua 代碼將無法:
- 變更 TextBox.Text 屬性。