ChatInputBarConfiguration
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Configura las propiedades de la barra de entrada de chat de texto predeterminada. Se le asigna a TextChatService .
Resumen
Propiedades
Posición actual de la pantalla de la barra de entrada de chat predeterminada en píxeles.
Tamaño de la pantalla actual de la barra de entrada de chat predeterminada en píxeles.
Si habilitar el autocompletado para la barra de entrada de chat.
Color de fondo de la barra de chat predeterminada.
Transparencia de fondo de la barra de entrada de chat predeterminada.
Si mostrar la barra de entrada de chat predeterminada.
Fuente utilizada para renderizar texto en la barra de entrada de chat predeterminada.
Si la barra de chat predeterminada está enfocada o no.
Los usuarios de clave adicionales pueden presionar para activar el enfoque en la barra de entrada de chat predeterminada.
Color del texto del texto de reemplazo en la barra de entrada de chat predeterminada.
Una referencia al objetivo TextChannel .
Referencia a una instancia designada TextBox que envía mensajes en nombre del usuario.
Color del texto en la barra de entrada de chat por defecto.
Tamaño del texto en la barra de entrada de chat por defecto.
Color del trazo de texto para el texto en la barra de entrada de chat predeterminada.
Transparencia del trazado del texto para el texto en la barra de entrada de chat predeterminada.
Propiedades
AbsolutePosition
Propiedad solo de lectura que proporciona la posición de la barra de entrada de chat predeterminada en píxeles. Se comporta de manera similar a GuiBase2d.AbsolutePosition .
AbsoluteSize
Propiedad solo de lectura que proporciona el tamaño de la pantalla de la barra de entrada de chat predeterminada en píxeles. Se comporta de manera similar a GuiBase2d.AbsoluteSize .
AutocompleteEnabled
Si se debe habilitar el autocompletado para la barra de entrada de chat. Establecer en false para deshabilitar el autocompletado.
BackgroundColor3
Color de fondo de la barra de entrada de chat predeterminada. El valor predeterminado es Color3.new(25, 27, 29) .
BackgroundTransparency
Transparencia de fondo de la barra de entrada de chat predeterminada como un número entre 0 y 1 .Este valor se multiplica con la transparencia de fondo efectiva del usuario GuiService.PreferredTransparency para crear la transparencia de fondo efectiva utilizada por la barra de entrada de chat, que puede ser más opaca que este valor establecido aquí.El valor predeterminado es 0.2 .
Enabled
Si mostrar la barra de entrada de chat predeterminada. Establecer en false para ocultar.
FontFace
Fuente utilizada para renderizar texto en la barra de entrada de chat predeterminada. La predeterminada es Enum.Font.BuilderSansMedium .
IsFocused
Indica si la barra de chat predeterminada está enfocada o no.Útil para disparar eventos cambiados de propiedad para que puedas implementar funciones de llamada que respondan a cambios en el estado de enfoque de la barra de entrada.
Muestras 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
Los usuarios de clave adicionales pueden presionar para activar el enfoque en la barra de entrada de chat predeterminada.Útil cuando quieres tener una tecla de acceso rápido adicional para enfocarte además de la tecla / .
PlaceholderColor3
Color del texto del texto de marcador de posición en la barra de entrada de chat predeterminada. El valor predeterminado es Color3.new(178, 178, 178) .
TargetTextChannel
Determina qué TextChannel usar cuando el usuario envía un mensaje con la barra de entrada de chat predeterminada.
TextBox
Referencia a una instancia designada TextBox que envía mensajes en nombre del usuario.Puedes usarlo para integrar aún más tu barra de entrada de chat personalizada en tu experiencia al manipular libremente la aspecto, look, la ubicación y el diseño.Al optar por establecer esta propiedad a un personalizado TextBox, no necesitas escribir ningún código para el siguiente comportamiento:
- Cuando un usuario escribe un mensaje y presiona Enum.KeyCode.Return, el mensaje se enviará a ChatInputBarConfiguration.TargetTextChannel.
- Cuando se envía un mensaje, TextBox.Text se borrarautomáticamente.
Para la seguridad, se imponen algunas limitaciones al TextBox cuando se promociona a ChatInputBarConfiguration.TextBox . El código de Luau no podrá:
- Cambie la propiedad TextBox.Text .
- Usa los métodos TextBox:CaptureFocus() o TextBox:ReleaseFocus().
TextColor3
Color del texto en la barra de entrada de chat predeterminada. El valor predeterminado es Color3.new(255, 255, 255) .
TextSize
Tamaño del texto en la barra de entrada de chat predeterminada. El valor predeterminado es 14 .
TextStrokeColor3
Color del trazo de texto para el texto en la barra de entrada de chat predeterminada. El valor predeterminado es Color3.new(0, 0, 0) .
TextStrokeTransparency
Transparencia del trazado del texto para el texto en la barra de entrada de chat predeterminada. El valor predeterminado es 0.5 .