TextButton

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Bir TextButton , görüntüleme konusunda bir TextLabel ek davranışla benzer şekilde davranır, bir GuiButton ek davranışıyla.

Metin görüntülenmesini devre dışı bırakmak için TextTransparency ı 1 olarak ayarlayabilirsiniz. Bu, bir düğme olarak kullanılabilecek basit bir dikdörtgenle sonuçlanacaktır.

Özet

Özellikler

Şuradan alınan Özellikler: GuiButtonŞuradan alınan Özellikler: GuiObjectŞuradan alınan Özellikler: GuiBase2d
Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Yöntemler

Şuradan alınan Yöntemler: GuiObject
Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Etkinlikler

Şuradan alınan Etkinlikler: GuiButtonŞuradan alınan Etkinlikler: GuiObjectŞuradan alınan Etkinlikler: GuiBase2d
Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Özellikler

ContentText

string
Salt Okunur
Çoğaltılmamış
Paralel oku

Bu özellik, Text tarafından kullanılanın aynısını içeren bir kopya sağlar TextButton .Bu, zengin metin işaretleme için kullanılan stil etiketlerinin ortadan kaldırılması için yararlıdır; örneğin, RichText etkinleştirildiğinde, ContentText özelliği kullanıcıya göründüğü gibi metni gösterir.

<th>Tekst</th>



    <th>İçerik Metni</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>sahte</code></td>



    <td><b>Merhaba,<br/> dünya!</b></td>



    <td><b>Merhaba,<br/> dünya!</b></td>

  </tr>



  <tr>

    <td><code>doğru</code></td>



    <td><b>Merhaba,<br/> dünya!</b></td>



    <td>Merhaba, dünya!</td>

  </tr>

</tbody>
ZenginMetin

Font

Enum.Font
Gizli
Çoğaltılmamış
Paralel oku

Bu özellik, TextButton 'nin metnini göstereceği birkaç önceden tanımlanmış yazı tipinden birini seçer.Bazı yazı tipleri bold, italik ve/veya hafif değişiklikler içerir.

Enum.Font.Legacy yazı tipinin istisnası dışında, her yazı tipi TextSize özelliğinin eşit olduğu çizgi yüksekliğiyle metin görüntüleyecektir.

The Enum.Font.Code yazı tipi tek boşluklu yazı tipidir.Her karakterin aynı genişlik ve yükseklik oranına sahip olması gerektiği benzersiz bir özelliğe sahiptir; burada, her karakterin genişliği yaklaşık olarak TextSize özelliğinin yarısıdır.

Bu özellik, FontFace özelliği ile senkronize edilir.

Kod Örnekleri

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
Paralel oku

Bu özellik, Font özelliğine benzer, ancak Enum.Font 'de bulunmayan fontları ayarlamaya izin verir.

Bu özellik, Font özelliği ile senkronize edilir, böylece FontFace ayarlanırken, yazı tipi ilgili Enum.Font değere veya Enum.Font.Unknown yoksa hiçbir eşleşmeye ayarlanır.

LineHeight

number
Paralel oku

Metin çizgilerinin yüksekliğini, yazı tipinin em kare boyutunun bir katı olarak kontrol ederek, TextButton 'deki metin çizgileri arasındaki boşlukları ölçeklendirerek.Geçerli değerler 1.0 ile 3.0 arasında değişir, varsayılan olarak 1.0 .

LocalizedText

string
Gizli
Salt Okunur
Çoğaltılmamış
Paralel oku

Bu özellik, bir TextButton ın GuiBase2d.Localize ya da değil olması gerektiğini belirler.

MaxVisibleGraphemes

number
Paralel oku

Bu özellik, TextButton 'de gösterilen maksimum grafem sayısını (veya metin birimlerini) kontrol eder.Öncelikle, karakterler bir anda göründüğü bir daktilo etkisi oluşturmak için kolay bir yol olarak sağlanır.

Özellik değiştirmek, görünen grafemlerin konumunu veya boyutunu değiştirmez; düzen, tüm grafemler görünebilir gibi hesaplanacaktır.

Özelliği -1 olarak ayarlamak, sınırı devre dışı bırakır ve tümünü Text gösterir.

OpenTypeFeatures

string
Paralel oku

OpenTypeFeaturesError

string
Salt Okunur
Çoğaltılmamış
Paralel oku

RichText

boolean
Paralel oku

Bu özellik, TextButton 'nin metnini bold, italik, özel renkler ve daha fazlası için stil bölümlerine zengin metin işaretleyerek görüntüleyip görüntülemediğini belirler.

Zengin metni kullanmak için, sadece Text dizizengin metin biçimlendirme etiketlerini ekleyin.

Text

string
Paralel oku

Bu özellik, TextButton tarafından sunulan metin içeriğini belirler.Ekrana gösterilen dizeyi görsel özellikleri , , , , > ve tarafından belirlenir.

🔒 ve diğer TextColor3 özelliklerinden etkilenmeyen emoji gibi sembolleri görüntülemek mümkündür.Bunlar Script ve LocalScript nesnelerine yapıştırılabilir ve ayrıca Özellikler penceresinin içindeki alana.

Bu özellik yeni satır karakterleri içerebilir. Aynı şekilde, bu özellik bir sekme karakteri içerebilir, ancak yerine boşluk olarak görünecektir.

Kod Örnekleri

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
Salt Okunur
Çoğaltılmamış
Paralel oku

Bu okuma-sadece özelliği, yerleştirilen metinin mutlak boyutunu yansıtır, yani eğer metni bir dikdörtgen içine sığdırmaya çalışırsanız, bu özellik, metni sığdırmak için ihtiyacınız olan dikdörtgenin minimum boyutunu yansıtacaktır.

TextService:GetTextSize() kullanarak, TextBounds bir dizi, Font , TextSize ve çerçeve boyutu verileceğini tahmin edebilirsiniz.

TextColor3

Color3
Paralel oku

Bu özellik, TextButton öğesi tarafından görüntülenen tüm metinin rengini belirler.

Kod Örnekleri

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
Paralel oku

Enum.TextDirection metin görüntülenen yerde.

TextFits

boolean
Salt Okunur
Çoğaltılmamış
Paralel oku

Butonun metninin boyutuna uyup uymadığına ilişkin bir mantıksel temsil.

TextScaled

boolean
Paralel oku

Bu özellik, metnin butonun tüm alanını dolduracak şekilde ölçeklendirilip ölçeklendirilmediğini belirler.Aktifleştirildiğinde, TextSize göz ardı edilir ve TextWrapped otomatik olarak etkinleştirilir.Bu özellik, BillboardGuis içinde metin elemanlarını göstermek için yararlıdır.Bu özellik ekran üzeri arayüz için kullanıldığında, olası metin boyutu aralığını sınırlandırmak için bir kullanmak yararlı olabilir.

Otomatik Boyutlandırma

Kullanımdan kaçınmanız ve TextScaled yerine AutomaticSize özelliğinden yararlanmak için UI'yi ayarlamanız önerilir.İki özellik arasındaki temel farklar aşağıdadır:

  • TextScaled içeriği (metin) UI'ye uyacak şekilde ölçeklendirir. Dikkatli bir şekilde düşünülmeden, bazı metinler çok küçük ölçeklendirildiğinde okunaksız hale gelebilir.

  • AutomaticSize arayüzü, tutarlı bir font boyutu koruyarak içeriği barındırmak üzere yeniden boyutlandırır. Daha fazla bilgi için, buraya bakın.

Ayrıca, her ikisini de AutomaticSize ve TextScaled ve aynı TextButton 'ye uygulamaktan kaçınmanız önerilir.AutomaticSize bir GuiObject'un kullanabileceği maksimum alanı (bu durumda, metin) belirlerken TextScaled mevcut alanı kullanır AutomaticSize font boyutunu maksimum font boyutuna (100) yükseltmek için kullanılabilir alan sınırı yoksa.

TextSize

number
Paralel oku

Bu özellik, görüntülenen bir metin satırının yüksekliğini belirler.Birim ofsetlerde, noktalarda değil (çoğu belge düzenleme programında kullanılır).The Enum.Font.Legacy yazı tipi bu özelliği tutmuyor.

TextStrokeColor3

Color3
Paralel oku

Bu özellik, görüntülenen metnin çizgisinin veya hatlarının rengini ayarlar. This property sets the color of the stroke, or outline, of rendered text.TextStrokeTransparency ile birlikte, metin çizginin son görsel görünümünü belirler.

Renkgradientlerini destekleyen güçlü bir alternatif olarak, bakın UIStroke .

TextStrokeTransparency

number
Paralel oku

Bu özellik, görüntülenen metnin çizgisinin veya hatlarının transparanlığını ayarlar.TextStrokeColor3 ile birlikte, metin çizginin son görsel görünümünü belirler.

Metin çizgisinin aynı saydamlığın çoklu görüntülemeleri olduğunu unutmayın, bu nedenle bu özellik temelde kendi üzerinde dört kez çarpan olur.Bu nedenle, daha ince bir etki için TextStrokeTransparency ile 0.75 ile 1 arasındaki bir değere ayarlanması önerilir, daha karmaşık bir etki için.

Renkgradientlerini destekleyen güçlü bir alternatif olarak, bakın UIStroke .

TextTransparency

number
Paralel oku

Bu özellik, TextButton tarafından kullanılan tüm metinlerin transparanlığını belirler.

TextTruncate

Enum.TextTruncate
Paralel oku

TextButton 'de gösterilen metin kısaltmasını kontrol eder.

TextWrapped

boolean
Paralel oku

Aktifleştirildiğinde, bu özellik bir TextButton elemanının alanında çoklu satırlarda metin görüntüleyecek, böylece TextBounds asla elemanın GuiBase2d.AbsoluteSize sınırını aşmayacak.Bu, uzun metin parçalarını birden fazla satıra ayırarak elde edilir.

Satır bozuklukları boşluk tercih edecektir; uzun kesilmemiş bir kelime elemanın genişliğini aşarsa, bu kelime birden fazla satıra bölünecektir.

Daha fazla satır kırılması, metnin (Y bileşeninin > ) dikey yüksekliğinin, elemanın dikey yüksekliğini aşmasına neden olursa, o satır hiç tümü.

TextXAlignment

Enum.TextXAlignment
Paralel oku

Bu özellik, nesnenin alanı içinde görüntülenen metnin yatay hizalanmasını belirler.Her iki eksende de metin yerleşimini tamamen belirlemek için TextYAlignment ile birlikte kullanılır.

Bu özellik okuma-sadece özelliklerini etkilemeyeceğini unutmayın TextBounds ve TextFits .

TextYAlignment

Enum.TextYAlignment
Paralel oku

Bu özellik, nesnenin alanı içinde görüntülenen metnin yatay hizalanmasını belirler.Her iki eksende de metin yerleşimini tamamen belirlemek için TextXAlignment ile birlikte kullanılır.

Bu özellik okuma-sadece özelliklerini etkilemeyeceğini unutmayın TextBounds ve TextFits .

Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Yöntemler

Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Etkinlikler

Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object