ChatInputBarConfiguration
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
Konfiguruje właściwości domyślnej barwy czatu tekstowego. Jest powiązany z TextChatService.
Podsumowanie
Właściwości
Rzeczywista pozycja ekranu paska wejściowego czatu domyślnego w pikselach.
Rzeczywista wielkość ekranu paska wejściowego czatu domyślnego w pikselach.
Czy włączyć automatyczne uzupełnianie dla paska wpisu czatu.
Kolor tła z paska wpisu czatu domyślnego.
Przezroczystość tła z domyślną listą wpisów czatu.
Czy wyświetlać domyślną barę wprowadzania czatu.
Czcionka używana do renderowania tekstu w domyślnej pasku wprowadzenia czatu.
Czy domyślna pasek wpisu czatu jest skupiony czy nie.
Dodatkowi użytkownicy klucza mogą nacisnąć, aby uruchomić skupienie na domyślnej pasku wprowadzenia czatu.
Kolor tekstu zastępczego tekstu w pasku wpisu czatu domyślnego.
Odwołanie do celu TextChannel .
Odwołanie do wyznaczonej instancji TextBox, która wysyła wiadomości w imieniu użytkownika.
Kolor tekstu w domyślnej pasku wprowadzenia czatu.
Rozmiar tekstu w domyślnej barze wprowadzenia czatu.
Kolor oczek tekstowych dla tekstu w domyślnej pasku wprowadzenia czatu.
Przezroczystość pisma dla tekstu w domyślnej pasku wprowadzenia czatu.
Właściwości
AbsolutePosition
Właściwość tylko do odczytu, która zapewnia pozycję ekranu paska wejściowego czatu domyślnego w pikselach. Zachowuje się podobnie do GuiBase2d.AbsolutePosition .
AbsoluteSize
Właściwość tylko do odczytu, która zapewnia rozmiar ekranu paska wejściowego czatu domyślnego w pikselach. Zachowuje się podobnie do GuiBase2d.AbsoluteSize .
AutocompleteEnabled
Czy włączyć autouzupełnianie dla paska wpisu czatu. Ustaw na false, aby wyłączyć autouzupełnianie.
BackgroundColor3
Kolor tła z domyślną listą wpisów czatu. Domyślna wartość to Color3.new(25, 27, 29) .
BackgroundTransparency
Przezroczystość tła dla domyślnej pasku wprowadzania czatu jako liczba pomiędzy 0 i 1.Wartość ta jest mnożona przez wartość GuiService.PreferredTransparency użytkownika, aby stworzyć skuteczną przejrzystość tła używaną przez pasek wpisu czatu, który może być bardziej niejasny niż ta wartość ustawiona tutaj.Domyślna wartość to 0.2 .
FontFace
Czcionka używana do renderowania tekstu w domyślnej pasku wprowadzenia czatu. Domyślnie jest to Enum.Font.BuilderSansMedium .
IsFocused
Wskazuje, czy domyślna pasek wprowadzania czatu jest skupiony czy nie.Przydatne do wystrzelania zmienionych zdarzeń właściwości, abyś mógł implementować funkcje powrotne, które reagują na zmiany w stanie skupienia paska wejściowego.
Przykłady kodu
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
Dodatkowi użytkownicy klucza mogą nacisnąć, aby uruchomić skupienie na domyślnej pasku wprowadzenia czatu.Przydatne, gdy chcesz mieć dodatkowy skrót klawiszowy do skupiania się oprócz klawisza /.
PlaceholderColor3
Kolor tekstu zamiennika tekstu w domyślnej pasku wprowadzenia czatu. Domyślna wartość to Color3.new(178, 178, 178) .
TargetTextChannel
Określa, które TextChannel należy używać, gdy użytkownik wysyła wiadomość za pomocą domyślnej pasku wprowadzania czatu.
TextBox
Odwołanie do wyznaczonej instancji TextBox, która wysyła wiadomości w imieniu użytkownika.Możesz użyć go do dalszej integracji niestandardowej barwy wejściowej czatu z interfejsem użytkownika w swoim doświadczeniu, manipulując swobodnie wyglądem, lokalizacją i układem.Kiedy wybierzesz ustawienie tej właściwości na niestandardową TextBox, nie musisz pisać żadnego kodu dla następującego zachowania:
- Kiedy użytkownik wpisze wiadomość i naciśnie Enum.KeyCode.Return, wiadomość zostanie wysłana do ChatInputBarConfiguration.TargetTextChannel.
- Gdy wiadomość zostanie wysłana, TextBox.Text automatycznie się oczyści.
Ze względów bezpieczeństwa niektóre ograniczenia są narzucone na TextBox gdy zostanie promowany do ChatInputBarConfiguration.TextBox. Kod Luau nie będzie mógł:
- Zmień właściwość TextBox.Text .
- Użyj metod TextBox:CaptureFocus() lub TextBox:ReleaseFocus().
TextColor3
Kolor tekstu w domyślnej pasku wprowadzenia czatu. Domyślna wartość to Color3.new(255, 255, 255) .
TextStrokeColor3
Kolor pisma dla tekstu w pasku wpisu czatu domyślnego. Domyślna wartość to Color3.new(0, 0, 0) .
TextStrokeTransparency
Przezroczystość pisma dla tekstu w domyślnej pasku wprowadzenia czatu. Domyślna wartość to 0.5 .