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 predefinito. È parented a TextChatService .
Sommario
Proprietà
Posizione di schermo reale della barra di input della chat predefinita in pixel.
Dimensione di schermo reale della barra di input della chat predefinita in pixel.
Se abilitare l'autocompletamento per la barra di input della chat.
Colore di sfondo della barra di input della chat predefinita.
Trasparenza di sfondo della barra di input della chat predefinita.
Se mostrare la barra di input della chat predefinita.
Carattere utilizzato per rendere il testo nella barra di input di default.
Se la barra di input della chat predefinita è focusata o no.
Gli utenti chiave aggiuntivi possono premere per attivare il focus sull'input di chat predefinito.
Colore del testo del placeholder text nella barra di input di chat predefinita.
Un riferimento al target TextChannel .
Riferimento a un'istanza TextBox designata che invia messaggi in nome dell'utente.
Colore del testo nella barra di input della chat predefinita.
Dimensione del testo nella barra di input di chat predefinita.
Colore del tratto di testo per il testo nella barra di input di chat predefinita.
Trasparenza del tratto di testo per il testo per impostazione predefinita nella barra di input del chat.
Metodi
Proprietà
AbsolutePosition
Proprietà di proprietà che fornisce la posizione di schermo della chat di base in pixel. Si comporta allo stesso modo di GuiBase2d.AbsolutePosition .
AbsoluteSize
Proprietà di proprietà che fornisce la dimensione di schermo della chat di base in pixel. Si comporta allo stesso modo di GuiBase2d.AbsoluteSize .
AutocompleteEnabled
Se abilitare l'autocompletamento per la barra di input della chat. Impostato su false per disabilitare l'autocompletamento.
BackgroundColor3
Colore di sfondo della barra di input della chat predefinita. Il valore predefinito è Color3.new(25, 27, 29) .
BackgroundTransparency
Trasparenza di sfondo della chat di base come numero tra 0 e 1 . Questo valore viene moltiplicato con il GuiService.PreferredTransparency dell'utente per creare la trasparenza di sfondo effettiva utilizzata dalla chat, che può essere più opaca di questo set di valori qui. Il valore predefinito è 1> 0.21>
Enabled
Se mostrare la barra di input della chat predefinita. Impostato 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 della chat predefinita è focusata o no. Utile per attivare gli eventi di proprietà cambiati in modo da poter implementare funzioni di richiamata che rispondono allo stato di focus della barra di input.
Campioni di codice
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 il focus sull'input di chat predefinito. Utile quando si desidera avere un hotkey aggiuntivo per il focus in aggiunta alla chiave / .
PlaceholderColor3
Colore del testo del placeholder text nella barra di input della chat predefinita. Il valore predefinito è Color3.new(178, 178, 178) .
TargetTextChannel
Determina quale TextChannel usare quando l'utente invia un messaggio con l'input di chat predefinito.
TextBox
Riferimento a una istanza TextBox designata che invia messaggi in nome dell'utente. Puoi usarlo per integrare ulteriormente la tua interfaccia utente di ingresso della chat personalizzata nella tua esperienza manipolando liberamente l'aspetto, la posizione e la layout. Quando si ottiene l'opzione di impostare questa proprietà su un'istanza personalizzata TextBox, non è necessario scrivere alcun codice per il seguente comportamento:
- Quando un utente digita un messaggio e premere Enum.KeyCode.Return , il messaggio sarà inviato a ChatInputBarConfiguration.TargetTextChannel .
- Quando un messaggio viene inviato, TextBox.Text verrà automaticamente Eliminare/Pulire.
Per motivi di sicurezza, alcune limitazioni sono impostate sul TextBox quando viene promosso a ChatInputBarConfiguration.TextBox . Il codice Lua 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 della chat di base. Il valore predefinito è Color3.new(255, 255, 255) .
TextSize
Dimensione del testo nella barra di input della chat predefinita. Il valore predefinito è 14 .
TextStrokeColor3
Colore del tratto di testo per il testo nella barra di input di chat predefinita. Il valore predefinito è Color3.new(0, 0, 0) .
TextStrokeTransparency
Trasparenza del tratto di testo per il testo nella barra di input di chat predefinita. Il valore predefinito è 0.5 .