TextLabel

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Um TextLabel renderiza um retângulo, como um Frame , com texto estilizado.O retângulo pode ser usado para definir limites de texto, escalonamento de texto ( TextScaled ), embalagem ( TextWrapped ) e alinhamento ( TextXAlignment e/ou TextYAlignment ).

Esta classe contém propriedades que controlam a exibição do texto, como Font e TextColor3.Para exibir apenas texto e ocultar o retângulo de fundo, defina BackgroundTransparency para 1.

Um objeto UITextSizeConstraint pode ser usado para restringir o tamanho do texto com TextScaled ativado.Recomenda-se que o tamanho do texto não seja inferior a 9, caso contrário, pode não ser visível para muitos usuários.

Resumo

Propriedades

Propriedades herdados de GuiObjectPropriedades herdados de GuiBase2d
Ver todos os herdados de Instance
Ver todos os herdados de Object

Métodos

Métodos herdados de GuiObject
Ver todos os herdados de Instance
Ver todos os herdados de Object

Eventos

Eventos herdados de GuiObjectEventos herdados de GuiBase2d
Ver todos os herdados de Instance
Ver todos os herdados de Object

Propriedades

ContentText

string
Somente leitura
Não replicado
Ler Parallel

Essa propriedade fornece uma cópia de Text que contém exatamente o que está sendo renderizado pelo TextLabel.Isso é útil para eliminar tags de estilo usadas para marcar texto rico; por exemplo, quando RichText está habilitado, a propriedade ContentText mostra o texto como aparece ao usuário.

<th>Texto</th>



    <th>Texto do Conteúdo</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>falso</code></td>



    <td><b>Olá, mundo!</b></td>



    <td><b>Olá, mundo!</b></td>

  </tr>



  <tr>

    <td><code>verdadeiro</code></td>



    <td><b>Olá, mundo!</b></td>



    <td>Olá, mundo!</td>

  </tr>

</tbody>
Texto Rico

Font

Enum.Font
Oculto
Não replicado
Ler Parallel

Essa propriedade seleciona uma das várias fontes pré-definidas com as quais o TextLabel renderizará seu texto.Algumas fontes têm variantes bold, italic e/ou light.

Com a exceção da fonte Enum.Font.Legacy , cada fonte renderizará texto com a altura da linha igual à propriedade TextSize.

A fonte Enum.Font.Code é a única fonte monoespacial.Ela tem a propriedade única que cada personagem tem a mesma largura e proporção de altura de 1:2, onde a largura de cada personagem é aproximadamente metade da propriedade TextSize .

Essa propriedade é mantida em sincronia com a propriedade FontFace.

Amostras de código

This code sample renders a list of all the available fonts.

Show All Fonts
local frame = script.Parent



-- Create a TextLabel displaying each font

for _, font in pairs(Enum.Font:GetEnumItems()) do

	local textLabel = Instance.new("TextLabel")

	textLabel.Name = font.Name

	-- Set the text properties

	textLabel.Text = font.Name

	textLabel.Font = font

	-- Some rendering properties

	textLabel.TextSize = 24

	textLabel.TextXAlignment = Enum.TextXAlignment.Left

	-- Size the frame equal to the height of the text

	textLabel.Size = UDim2.new(1, 0, 0, textLabel.TextSize)

	-- Add to the parent frame

	textLabel.Parent = frame

end



-- Layout the frames in a list (if they aren't already)

if not frame:FindFirstChildOfClass("UIListLayout") then

	local uiListLayout = Instance.new("UIListLayout")

	uiListLayout.Parent = frame

end

FontFace

Enum.Font
Ler Parallel

Essa propriedade é semelhante à propriedade Font mas permite definir fontes que não existem em Enum.Font .

Essa propriedade é mantida em sincronia com a propriedade Font, de modo que, ao definir FontFace, a fonte seja definida para o valor correspondente Enum.Font ou para Enum.Font.Unknown se não houver correspondências.

LineHeight

number
Ler Parallel

Controla a altura das linhas como um múltiplo do tamanho do quadrado da fonte por escalonamento do espaçamento entre linhas de texto no .Os valores válidos variam de 1.0 a 3.0, padrão para 1.0 .

LocalizedText

string
Oculto
Somente leitura
Não replicado
Ler Parallel

Essa propriedade define se um TextLabel deve considerar GuiBase2d.Localize ou não.

MaxVisibleGraphemes

number
Ler Parallel

Essa propriedade controla o número máximo de grafemas (ou unidades de texto) que são mostrados no TextLabel.É fornecido principalmente como uma maneira fácil de criar um efeito de máquina de digitação onde os caracteres aparecem um por vez.

Mudar a propriedade não altera a posição ou o tamanho dos gráficos visíveis; o layout será calculado como se todos os gráficos fossem visíveis.

Definir a propriedade para -1 desabilita o limite e mostra a totalidade do Text .

OpenTypeFeatures

string
Ler Parallel

OpenTypeFeaturesError

string
Somente leitura
Não replicado
Ler Parallel

RichText

boolean
Ler Parallel

Essa propriedade determina se o TextLabel renderiza seu texto usando o marcado de texto rico para seções de texto em negrito, itálico, cores específicas e muito mais.

Para usar texto rico, simplesmente inclua tags de formatação de texto rico na string / cadeia / textoText.

Text

string
Ler Parallel

Essa propriedade determina o conteúdo de texto renderizado pelo TextLabel.As propriedades visuais da string renderizada na tela são determinadas por TextColor3 , TextTransparency , TextSize , Font , TextScaled , TextWrapped , TextXAlignment e TextYAlignment.

É possível renderizar emojis como 🔒 e outros símbolos que não são afetados pela propriedade TextColor3.Elas podem ser coladas em Script e LocalScript objetos, bem como no campo dentro da janela Propriedades.

Essa propriedade pode conter caracteres de nova linha. Da mesma forma, essa propriedade pode conter um caractere de aba, mas renderizará como um espaço em vez disso.

Amostras de código

This code sample creates a fading banner for a TextLabel. It fades text out, chooses a random string (avoiding repetition), and fades back in.

Fading Banner
local TweenService = game:GetService("TweenService")



local textLabel = script.Parent



local content = {

	"Welcome to my game!",

	"Be sure to have fun!",

	"Please give suggestions!",

	"Be nice to other players!",

	"Don't grief other players!",

	"Check out the shop!",

	"Tip: Don't die!",

}



local tweenInfo = TweenInfo.new(1, Enum.EasingStyle.Sine, Enum.EasingDirection.InOut)



local RNG = Random.new()



local fadeIn = TweenService:Create(textLabel, tweenInfo, {

	TextTransparency = 0,

})



local fadeOut = TweenService:Create(textLabel, tweenInfo, {

	TextTransparency = 1,

})



local lastIndex

while true do

	-- Step 0: Fade out before doing anything

	fadeOut:Play()

	task.wait(tweenInfo.Time)



	-- Step 1: pick content that wasn't the last displayed

	local index

	repeat

		index = RNG:NextInteger(1, #content)

	until lastIndex ~= index

	-- Make sure we don't show the same thing next time

	lastIndex = index



	-- Step 2: show the content

	textLabel.Text = content[index]

	fadeIn:Play()

	task.wait(tweenInfo.Time + 1)

end

This code sample demonstrates emoji rendering using the Text property.

Emoji in Text
local textLabel = script.Parent



local moods = {

	["happy"] = "😃",

	["sad"] = "😢",

	["neutral"] = "😐",

	["tired"] = "😫",

}



while true do

	for mood, face in pairs(moods) do

		textLabel.Text = "I am feeling " .. mood .. "! " .. face

		task.wait(1)

	end

end

TextBounds

Vector2
Somente leitura
Não replicado
Ler Parallel

Essa propriedade de leitura só reflete o tamanho absoluto do texto renderizado em deslocamentos, o que significa que se você tentar encaixar o texto em um retângulo, essa propriedade refletiria as dimensões mínimas do retângulo que você precisaria para encaixar o texto.

Usando TextService:GetTextSize() , você pode prever o que TextBounds será dado uma string / cadeia / texto, Font , TextSize e tamanho do quadro.

TextColor3

Color3
Ler Parallel

Essa propriedade determina a cor de todo o texto renderizado pelo elemento TextLabel.

Amostras de código

This code sample makes a TextLabel or TextButton count backwards from 10, setting the text color as it does so.

Countdown Text
-- Place this code in a LocalScript within a TextLabel/TextButton

local textLabel = script.Parent



-- Some colors we'll use with TextColor3

local colorNormal = Color3.new(0, 0, 0) -- black

local colorSoon = Color3.new(1, 0.5, 0.5) -- red

local colorDone = Color3.new(0.5, 1, 0.5) -- green



-- Loop infinitely

while true do

	-- Count backwards from 10 to 1

	for i = 10, 1, -1 do

		-- Set the text

		textLabel.Text = "Time: " .. i

		-- Set the color based on how much time is left

		if i > 3 then

			textLabel.TextColor3 = colorNormal

		else

			textLabel.TextColor3 = colorSoon

		end

		task.wait(1)

	end

	textLabel.Text = "GO!"

	textLabel.TextColor3 = colorDone

	task.wait(2)

end

TextDirection

Enum.TextDirection
Ler Parallel

Enum.TextDirection em que o texto é renderizado.

TextFits

boolean
Somente leitura
Não replicado
Ler Parallel

Uma representação binária de se o texto da etiqueta / rótulose encaixa dentro do tamanho dela.

TextScaled

boolean
Ler Parallel

Essa propriedade determina se o texto é escalado para preencher todo o espaço da etiqueta / rótulo.Quando ativado, TextSize é ignorado e TextWrapped é automaticamente ativado.Essa propriedade é útil para renderizar elementos de texto dentro de BillboardGuis .Quando esta propriedade é usada para interface de usuário na tela, pode ser útil usar um UITextSizeConstraint para restringir o alcance de tamanhos de texto possíveis.

Tamanho Automático

Recomenda-se que você evite o uso de TextScaled e ajuste a interface para aproveitar a propriedade AutomaticSize em vez disso.Aqui estão as diferenças principais entre as duas propriedades:

  • TextScaled escalona o conteúdo (texto) para acomodar a interface de usuário. Sem uma consideração cuidadosa, algum texto pode se tornar ilegível se for escalado muito pequeno.

  • AutomaticSize redimensiona a UI para acomodar o conteúdo enquanto mantém um tamanho de fonte consistente. Para mais informações, veja aqui .

Além disso, é recomendado que você evite aplicar tanto AutomaticSize e TextScaled e ao mesmo TextLabel. AutomaticSize determina a quantidade máxima de espaço disponível que um GuiObject pode usar (neste caso, texto), enquanto TextScaled usa o espaço disponível determinado por AutomaticSize para aumentar o tamanho da fonte até o tamanho máximo da fonte (100) se não houver restrições de tamanho.

TextSize

number
Ler Parallel

Essa propriedade determina a altura de uma linha de texto renderizado.A unidade está em deslocamentos, não em pontos (que são usados na maioria dos programas de edição de documentos).A fonte Enum.Font.Legacy não possui essa propriedade.

TextStrokeColor3

Color3
Ler Parallel

Essa propriedade define a cor do traço, ou contorno, do texto renderizado.Junto com TextStrokeTransparency, determina a aparência visual final do traço de texto.

Como uma alternativa poderosa que suporta gradientes de cores, veja UIStroke .

TextStrokeTransparency

number
Ler Parallel

Essa propriedade define a transparência do traço, ou contorno, do texto renderizado.Junto com TextStrokeColor3, determina a aparência visual final do traço de texto.

Observe que o traço de texto é várias representações da mesma transparência, então essa propriedade é essencialmente multiplicativa em si mesma quatro vezes.Portanto, é recomendado definir TextStrokeTransparency para um valor na faixa de 0.75 a 1 para um efeito mais sutil.

Como uma alternativa poderosa que suporta gradientes de cores, veja UIStroke .

TextTransparency

number
Ler Parallel

Essa propriedade determina a transparência de todo o texto renderizado pelo TextLabel.

TextTruncate

Enum.TextTruncate
Ler Parallel

Controla a truncagem do texto exibido no TextLabel .

TextWrapped

boolean
Ler Parallel

Quando ativado, esta propriedade renderizará texto em várias linhas dentro do espaço de um elemento TextLabel para que TextBounds nunca exceda o GuiBase2d.AbsoluteSize do elemento.Isso é alcançado ao quebrar longas linhas de texto em várias linhas.

Quebras de linha preferirão espaço em branco; se uma palavra longa não quebrada exceder a largura do elemento, essa palavra será dividida em várias linhas.

Se mais quebras de linha causassem o excesso da altura vertical do texto (o componente Y do TextBounds) de exceder a altura vertical do elemento (o componente Y do GuiBase2d.AbsoluteSize), então essa linha não será renderizada de todas / todos.

TextXAlignment

Enum.TextXAlignment
Ler Parallel

Essa propriedade determina o alinhamento horizontal do texto renderizado dentro do espaço do Objeto.É usado em conjunto com TextYAlignment para determinar completamente o alinhamento do texto em ambos os eixos.

Observe que essa propriedade não afetará as propriedades somente de leitura TextBounds e TextFits.

TextYAlignment

Enum.TextYAlignment
Ler Parallel

Essa propriedade determina o alinhamento vertical do texto renderizado dentro do espaço do Objeto.É usado em conjunto com TextXAlignment para determinar completamente o alinhamento do texto em ambos os eixos.

Observe que essa propriedade não afetará as propriedades somente de leitura TextBounds e TextFits.

Ver todos os herdados de Instance
Ver todos os herdados de Object

Métodos

Ver todos os herdados de Instance
Ver todos os herdados de Object

Eventos

Ver todos os herdados de Instance
Ver todos os herdados de Object