ChatInputBarConfiguration
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Konfiguriert die Eigenschaften der Standard-Textchat-Eingabeleiste. Sie ist an TextChatService gebunden.
Zusammenfassung
Eigenschaften
Tatsächliche Bildschirmposition des Standard-Chat-Eingabefelds in Pixeln.
Tatsächliche Bildschirmgröße der Standard-Chat-Eingabeleiste in Pixeln.
Ob die automatische Vervollständigung für die Chat-Eingabeleiste aktiviert werden soll.
Hintergrundfarbe der Standard-Chat-Eingabeleiste.
Hintergrundtransparenz der Standard-Chat-Eingabeleiste.
Ob die Standard-Chat-Eingabeleiste angezeigt werden soll.
Schriftart, die verwendet wird, um Text in der Standard-Chat-Eingabeleiste zu rendern.
Ob die Standard-Chat-Eingabeleiste fokussiert ist oder nicht.
Zusätzliche Schlüsselbenutzer können drücken, um das Fokussieren auf die Standard-Chat-Eingabeleiste zu aktivieren.
Farbe des Textes des Platzhaltertextes in der Standard-Chat-Eingabeleiste.
Eine Referenz auf das Ziel TextChannel.
Verweis auf eine bestimmte TextBox Instanz, die Nachrichten im Namen des Benutzers sendet.
Farbe des Textes in der Standard-Chat-Eingabeleiste.
Größe des Textes in der Standard-Chat-Eingabeleiste.
Farbe des Textstrichs für Text in der Standard-Chat-Eingabeleiste.
Transparenz des Textstrichs für Text in der Standard-Chat-Eingabeleiste.
Eigenschaften
AbsolutePosition
Lesbare Eigenschaft, die die Bildschirmposition der Standard-Chat-Eingabeleiste in Pixeln bereitstellt. Verhält sich ähnlich wie GuiBase2d.AbsolutePosition.
AbsoluteSize
Lesbare Eigenschaft, die die Bildschirmgröße der Standard-Chat-Eingabeleiste in Pixeln bereitstellt. Verhält sich ähnlich wie GuiBase2d.AbsoluteSize.
AutocompleteEnabled
Ob die automatische Vervollständigung für die Chat-Eingabeleiste aktiviert werden soll. Setze es auf false, um die automatische Vervollständigung zu deaktivieren.
BackgroundColor3
Hintergrundfarbe der Standard-Chat-Eingabeleiste. Der Standardwert ist Color3.new(25, 27, 29) .
BackgroundTransparency
Hintergrundtransparenz der Standard-Chat-Eingabeleiste als Zahl zwischen 0 und 1.Dieser Wert wird mit der GuiService.PreferredTransparency des Benutzers multipliziert, um die effektive Hintergrundtransparenz zu erstellen, die von der Chat-Eingabeleiste verwendet wird, die möglicherweise undurchsichtiger ist als dieser Wert hier festgelegt.Der Standardwert ist 0.2.
Enabled
Ob die Standard-Chat-Eingabeleiste angezeigt werden soll. Auf false festlegen, um sie verbergen.
FontFace
Schriftart, mit der Text im Standard-Chat-Eingabefeld gerendert wird. Standard ist Enum.Font.BuilderSansMedium .
IsFocused
Zeigt an, ob die Standard-Chat-Eingabeleiste fokussiert ist oder nicht.Nützlich für das Auslösen von Ereignissen, die Eigenschaften geändert wurden, damit du Rückruffunktionen implementieren kannst, die auf Änderungen im Fokuszustand der Eingabeleiste reagieren.
Code-Beispiele
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
Zusätzliche Schlüsselbenutzer können drücken, um das Fokussieren auf die Standard-Chat-Eingabeleiste zu aktivieren.Nützlich, wenn du eine zusätzliche Hotkey für das Fokussieren neben der /-Taste haben möchtest.
PlaceholderColor3
Farbe des Textes des Platzhaltertextes in der Standard-Chat-Eingabeleiste. Der Standardwert ist Color3.new(178, 178, 178) .
TargetTextChannel
Bestimmt, welche TextChannel verwendet werden, wenn der Benutzer eine Nachricht mit der Standard-Chat-Eingabeleiste sendet.
TextBox
Verweis auf eine bestimmte TextBox Instanz, die Nachrichten im Namen des Benutzers sendet.Du kannst es verwenden, um deine benutzerdefinierte Chat-Eingabefeld-UI weiter in deine Erfahrung zu integrieren, indem du die Aussehen, den Standort und das Layout frei manipulierst.Wenn Sie sich dafür entscheiden, diese Eigenschaft auf ein benutzerdefiniertes TextBox zu setzen, müssen Sie keinen Code für das folgende Verhalten schreiben:
- Wenn ein Benutzer eine Nachricht eingibt und Enum.KeyCode.Return drückt, wird die Nachricht an ChatInputBarConfiguration.TargetTextChannel gesendet.
- Wenn eine Nachricht gesendet wird, TextBox.Text wird automatisch löschen.
Zum Schutz werden einige Einschränkungen auf die TextBox auferlegt, wenn sie auf ChatInputBarConfiguration.TextBox gefördert wird. Luau-Code wird nicht in der Lage sein:
- Ändere die TextBox.Text Eigenschaften.
- Verwende die Methoden TextBox:CaptureFocus() oder TextBox:ReleaseFocus().
TextColor3
Farbe des Textes in der Standard-Chat-Eingabeleiste. Der Standardwert ist Color3.new(255, 255, 255) .
TextStrokeColor3
Farbe des Textstrichs für Text in der Standard-Chat-Eingabeleiste. Der Standardwert ist Color3.new(0, 0, 0) .
TextStrokeTransparency
Transparenz des Textstrichs für Text in der Standard-Chat-Eingabeleiste. Der Standardwert ist 0.5 .