ChatInputBarConfiguration
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Configura as propriedades da barra de entrada de bate-papo de texto padrão. Ela é filiada a TextChatService.
Resumo
Propriedades
Posição atual da tela da barra de entrada de chat padrão em pixels.
Tamanho de tela atual da barra de entrada de chat padrão em pixels.
Se habilitar o preenchimento automático para a barra de entrada de chat.
Cor de fundo da barra de entrada de chat padrão.
Transparência de fundo da barra de entrada de chat padrão.
Se mostrar a barra de entrada de chat padrão.
Fonte usada para renderizar texto na barra de entrada de chat padrão.
Se a barra de entrada de chat padrão está focada ou não.
Usuários de chave adicionais podem pressionar para ativar o foco na barra de entrada de chat padrão.
Cor do texto do texto de espaço reservado na barra de entrada de chat padrão.
Uma referência ao alvo TextChannel .
Referência a uma instância designada TextBox que envia mensagens em nome do usuário.
Cor do texto na barra de entrada de chat padrão.
Tamanho do texto na barra de entrada de chat padrão.
Cor do traço de texto para texto na barra de entrada de chat padrão.
Transparência do traço de texto para texto na barra de entrada de chat padrão.
Propriedades
AbsolutePosition
Propriedade apenas de leitura que fornece a posição da tela da barra de entrada de chat padrão em pixels. Comporta-se de forma semelhante a GuiBase2d.AbsolutePosition.
AbsoluteSize
Propriedade apenas de leitura que fornece o tamanho da tela da barra de entrada de chat padrão em pixels. Comporta-se de forma semelhante a GuiBase2d.AbsoluteSize.
AutocompleteEnabled
Se habilitar o preenchimento automático para a barra de entrada de chat. Defina para false para desativar o preenchimento automático.
BackgroundColor3
Cor de fundo da barra de entrada de chat padrão. O valor padrão é Color3.new(25, 27, 29) .
BackgroundTransparency
Transparência de fundo da barra de entrada de chat padrão como um número entre 0 e 1 .Este valor é multiplicado com a transparência de fundo efetiva do usuário GuiService.PreferredTransparency para criar a transparência de fundo efetiva usada pela barra de entrada de chat, que pode ser mais opaca do que este valor definido aqui.O valor padrão é 0.2 .
Enabled
Se mostrar a barra de entrada de chat padrão. Definido como false para esconder / ocultar.
FontFace
Fonte usada para renderizar texto na barra de entrada de chat padrão. O padrão é Enum.Font.BuilderSansMedium .
IsFocused
Indica se a barra de entrada de chat padrão está focada ou não.Útil para disparar eventos de propriedade modificados para que você possa implementar funções de retorno que respondam às mudanças no estado de foco da barra de entrada.
Amostras de código
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
Usuários de chave adicionais podem pressionar para ativar o foco na barra de entrada de chat padrão.Útil quando você quer ter um atalho extra para se concentrar, além da tecla / .
PlaceholderColor3
Cor do texto do texto de espaço reservado na barra de entrada de chat padrão. O valor padrão é Color3.new(178, 178, 178) .
TargetTextChannel
Determina qual TextChannel usar quando o usuário envia uma mensagem com a barra de entrada de chat padrão.
TextBox
Referência a uma instância designada TextBox que envia mensagens em nome do usuário.Você pode usá-lo para integrar ainda mais a barra de entrada de chat personalizada na sua experiência, manipulando livremente a aparência, a localização e o layout.Ao optar por definir essa propriedade para um personalizado TextBox , você não precisa escrever nenhum código para o seguinte comportamento:
- Quando um usuário digita uma mensagem e pressiona Enum.KeyCode.Return, a mensagem será enviada para ChatInputBarConfiguration.TargetTextChannel.
- Quando uma mensagem é enviada, TextBox.Text será automaticamente limpar.
Para segurança, algumas limitações são impostas ao TextBox quando for promovido para ChatInputBarConfiguration.TextBox. O código Luau não será capaz de:
- Altere a propriedade TextBox.Text de mudança.
- Use os métodos ou .
TextColor3
Cor do texto na barra de entrada de chat padrão. O valor padrão é Color3.new(255, 255, 255) .
TextStrokeColor3
Cor do traço de texto para texto na barra de entrada de chat padrão. O valor padrão é Color3.new(0, 0, 0) .
TextStrokeTransparency
Transparência do traço de texto para texto na barra de entrada de chat padrão. O valor padrão é 0.5 .