ChatInputBarConfiguration
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
Konfigurasi properti bilah masuk obrolan teks default. Ini diwarisi ke TextChatService .
Rangkuman
Properti
Posisi layar aktual dari bilah input obrolan default dalam piksel.
Ukuran layar aktual dari bilah input obrolan default dalam piksel.
Apakah untuk mengaktifkan autocomplete untuk bilah input obrolan.
Warna latar belakang dari bilah masuk obrolan default.
Transparansi latar belakang dari bilah input obrolan default.
Apakah akan menampilkan bilah masuk obrolan default.
Font yang digunakan untuk menampilkan teks di bilah masuk obrolan default.
Apakah bilah masuk obrolan default difokuskan atau tidak.
Pengguna kunci tambahan dapat menekan untuk memicu fokus pada bilah input obrolan default.
Warna teks tempat pengisi teks dalam bilah input obrolan default.
Referensi ke target TextChannel .
Referensi ke instance ditentukan TextBox yang mengirim pesan atas nama pengguna.
Warna teks di bilah masuk obrolan default.
Ukuran teks di bilah masuk obrolan default.
Warna garis teks untuk teks di bilah masuk obrolan default.
Transparansi garis teks untuk teks di bilah masuk obrolan default.
Properti
AbsolutePosition
Properti hanya baca yang memberikan posisi layar dari bilah input obrolan default dalam piksel. Berperilaku serupa dengan GuiBase2d.AbsolutePosition .
AbsoluteSize
Properti hanya baca yang memberikan ukuran layar input obrolan default dalam piksel. Berperilaku serupa dengan GuiBase2d.AbsoluteSize .
AutocompleteEnabled
Apakah untuk mengaktifkan autocomplete untuk bilah input obrolan. Atur ke false untuk menonaktifkan autocomplete.
BackgroundColor3
Warna latar belakang dari bilah input obrolan default. Nilai default adalah Color3.new(25, 27, 29) .
BackgroundTransparency
Transparansi latar belakang dari bilah input obrolan default sebagai angka antara 0 dan 1 .Nilai ini dikalikan dengan transparansi latar belakang efektif pengguna GuiService.PreferredTransparency untuk membuat transparansi latar belakang efektif yang digunakan oleh bilah input obrolan, yang mungkin lebih opak dari nilai yang ditetapkan di sini.Nilai default adalah 0.2 .
Enabled
Apakah akan menampilkan bilah input obrolan default. Atur ke false untuk disembunyikan.
FontFace
Font yang digunakan untuk menampilkan teks di bilah input obrolan default. Nilai default adalah Enum.Font.BuilderSansMedium .
IsFocused
Menunjukkan apakah bilah input obrolan default difokuskan atau tidak.Berguna untuk menembak peristiwa properti yang diubah sehingga Anda dapat menerapkan fungsi panggil balas yang merespon perubahan status fokus bilah masuk.
Contoh Kode
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
Pengguna kunci tambahan dapat menekan untuk memicu fokus pada bilah input obrolan default.Berguna ketika Anda ingin memiliki hotkey ekstra untuk berkonsentrasi selain kunci /.
PlaceholderColor3
Warna teks placeholder teks di bilah masuk obrolan default. Nilai default adalah Color3.new(178, 178, 178) .
TargetTextChannel
Menentukan yang mana TextChannel untuk digunakan saat pengguna mengirim pesan dengan bilah input obrolan default.
TextBox
Referensi ke instance ditentukan TextBox yang mengirim pesan atas nama pengguna.Anda dapat menggunakannya untuk lebih memperintegrasikan bar masuk obrolan khusus Anda ke dalam pengalaman Anda dengan bebas memanipulasi penampilan, lokasi, dan tata letak.Saat memilih untuk mengatur properti ini ke custom TextBox, Anda tidak perlu menulis kode untuk perilaku berikut:
- Ketika pengguna mengetik pesan dan menekan Enum.KeyCode.Return, pesan akan dikirim ke ChatInputBarConfiguration.TargetTextChannel.
- Ketika pesan dikirim, TextBox.Text akan secara otomatis dihapus.
Untuk keamanan, beberapa batasan dikenakan pada TextBox ketika dipromosikan ke ChatInputBarConfiguration.TextBox . Kode Luau tidak akan dapat:
- Ubah properti TextBox.Text .
- Gunakan metode TextBox:CaptureFocus() atau TextBox:ReleaseFocus() .
TextColor3
Warna teks di bilah masuk obrolan default. Nilai default adalah Color3.new(255, 255, 255) .
TextStrokeColor3
Warna garis teks untuk teks di bilah masuk obrolan default. Nilai default adalah Color3.new(0, 0, 0) .
TextStrokeTransparency
Transparansi garis teks untuk teks di bilah masuk obrolan default. Nilai default adalah 0.5 .