ChatInputBarConfiguration
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Configura le proprietà della barra di input del chat di testo predefinita. È parented to TextChatService .
Sommario
Proprietà
Posizione effettiva dello schermo della barra di input chat predefinita in pixel.
Dimensione effettiva dello schermo della barra di input di chat predefinita in pixel.
Se abilitare l'autocompletamento per la barra di input della chat.
Colore di sfondo della barra di input di chat predefinita.
Trasparenza di sfondo della barra di input di chat predefinita.
Se mostrare la barra di input di chat predefinita.
Carattere utilizzato per rendere il testo nella barra di input di chat predefinita.
Se la barra di input di chat predefinita è focalizzata o meno.
Gli utenti chiave aggiuntivi possono premere per attivare la messa a fuoco sull'area di input di chat predefinita.
Colore del testo del testo di riempimento nella barra di input di chat predefinita.
Un riferimento al bersaglio TextChannel .
Riferimento a un'istanza designata TextBox che invia messaggi a nome dell'utente.
Colore del testo nella barra di input di chat predefinita.
Dimensione del testo nella barra di input di chat predefinita.
Colore del tratto del testo per il testo nella barra di input chat predefinita.
Trasparenza dello stroke del testo per il testo nella barra di input chat predefinita.
Metodi
Proprietà
AbsolutePosition
Proprietà read-only che fornisce la posizione dello schermo della barra di input di chat predefinita in pixel. Si comporta in modo simile a GuiBase2d.AbsolutePosition .
AbsoluteSize
Proprietà read-only che fornisce la dimensione dello schermo della barra di input di chat predefinita in pixel. Si comporta in modo simile a GuiBase2d.AbsoluteSize .
AutocompleteEnabled
Se abilitare l'autocompletamento per la barra di input della chat. Impostare su false per disabilitare l'autocompletamento.
BackgroundColor3
Colore di sfondo della barra di input di chat predefinita. Il valore predefinito è Color3.new(25, 27, 29) .
BackgroundTransparency
Trasparenza di fondo della barra di input di chat predefinita come numero tra 0 e 1 .Questo valore viene moltiplicato con la transparenza di sfondo effettiva dell'utente GuiService.PreferredTransparency per creare l'efficace trasparenza di sfondo utilizzata dalla barra di input della chat, che può essere più opaca di questo valore impostato qui.Il valore predefinito è 0.2 .
Enabled
Se mostrare la barra di input di chat predefinita. Impostare su false per Nascondere, Occultare.
FontFace
Font utilizzato per rendere il testo nella barra di input di chat predefinita. Il predefinito è Enum.Font.BuilderSansMedium .
IsFocused
Indica se la barra di input di chat predefinita è focalizzata o meno.Utile per l'attivazione di eventi modificati di proprietà in modo da poter implementare funzioni di richiamo che rispondono alle modifiche nello stato di focus della barra di input.
Campioni di codice
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
Gli utenti chiave aggiuntivi possono premere per attivare la messa a fuoco sull'area di input di chat predefinita.Utile quando vuoi avere un tastino extra per concentrarti oltre alla chiave / .
PlaceholderColor3
Colore del testo del testo di riferimento nel bar di input chat predefinito. Il valore predefinito è Color3.new(178, 178, 178) .
TargetTextChannel
Determina quale TextChannel utilizzare quando l'utente invia un messaggio con la barra di input di chat predefinita.
TextBox
Riferimento a un'istanza designata TextBox che invia messaggi a nome dell'utente.Puoi usarlo per integrare ulteriormente la barra di input della chat personalizzata nella tua esperienza manipolando liberamente l'aspetto, la posizione e il layout.Quando si sceglie di impostare questa proprietà a un personalizzato TextBox , non è necessario scrivere alcun codice per il seguente comportamento:
- Quando un utente digita un messaggio e premere Enum.KeyCode.Return , il messaggio verrà inviato a ChatInputBarConfiguration.TargetTextChannel .
- Quando viene inviato un messaggio, TextBox.Text verrà Eliminare/Pulireautomaticamente.
Per motivi di sicurezza, alcune limitazioni vengono imposte sul TextBox quando viene promosso a ChatInputBarConfiguration.TextBox . Il codice Luau non sarà in grado di:
- Cambia la ProprietàTextBox.Text .
- Usa i metodi TextBox:CaptureFocus() o TextBox:ReleaseFocus().
TextColor3
Colore del testo nella barra di input di chat predefinita. Il valore predefinito è Color3.new(255, 255, 255) .
TextSize
Dimensione del testo nella barra di input di chat predefinita. Il valore predefinito è 14 .
TextStrokeColor3
Colore del tratto del testo per il testo nella barra di input di chat predefinita. Il valore predefinito è Color3.new(0, 0, 0) .
TextStrokeTransparency
Trasparenza dello stroke del testo per il testo nella barra di input chat predefinita. Il valore predefinito è 0.5 .