ImageLabel
*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 ImageLabel bir kareyi, Frame gibi, bir image öğesiyle gösterir. Görüntünün gösterilebilirliğini ImageColor3 ve
Gelişmiş ImageLabel kullanımı içerir:
Geri sayılan görüntüler oluşturmak için ScaleType ile Enum.ScaleType.Tile ile, sonra TileSize ile çizimlenen görüntülerin boyutuna ayarlanır.
9 katlı görüntüler oluşturmak için ScaleType ile Enum.ScaleType.Slice , sonra SliceCenter 9 katlı görüntünün merkez alanına ayarlanır.
Sprite sayfaları ImageRectOffset ve ImageRectSize kullanılarak uygulanabilir. Paketlenmiş birkaç görüntüyu birine yükleme ve bu özelliği kullanmak, GUI'lerinizdeki birkaç küçük ikonların yüklenmesini çok daha hızlı hale get
Özet
Özellikler
Ekran elemanı tarafından gösterilen görüntü içeriği. ImageContent 'e okur ve yazar.
Gerçekleştirilen bir görüntünün renklenmesini belirler.
Ekran içeriğini gösteren UI öğesi. varlık URIs ve EditableImage nesneleri destekler.
Görüntülenmesi gereken bir görüntünün alt alanındaki ofset.
Görüntülenen bir alanın piksel boyutunu belirler.
Görüntülenen görüntünün görünürlüğünü belirler.
Görüntünün Roblox'tan yüklenmesini bitirdiğini gösterir.
Etiket için görüntü yeniden düzenleme modunu seçer.
Bir görüntünün kaynağından farklı olan UI öğesiinde gösterilmesinin nasıl bir ölçeği belirler.
9 dilimli bir görüntünün kesme sınırlarını ayarlar.
9 dilimli kenarları belirli oranla büyütür.
Ekran Görüntüsü Etiketinin kare boyutunu ayarlar.
Bu UI öğesi girişi batırır mı belirler.
GuiObject 'nin mutlak büyüklüğüne göre kaynağını belirler.
Çocuk içeriğine dayalı olarak yeniden boyutlandırma olup olmadığını belirler.
Class.GuiObject arka plan rengini belirler.
Class.GuiObject arka planı ve sınırının transparansını belirler.
GuiObject sınırının rengini belirler.
Class.GuiObject sınırının boyutlarına göre ne şekilde çizildiğini belirler.
GuiObject sınırının piksel genişliğini belirler.
Bir ebeveyn GUI öğesi dışındaki çizgi şu şekilde olmalıdır: GuiObjects
oyuncumouse'unun aktif olarak GuiObject üzerine basılı olup olmadığını belirler.
Class.GuiButton ile etkileşime geçilebilir mi yoksa değil, GuiState ile GuiObject arasındaki şekli değiştirilebilir mi yoksa değil.
Class.UIGridStyleLayout ile kullanıldığında UIGridStyleLayout 'in sıralama düzenini kontrol eder.
Oyun aracı seçici aşağıya hareket ettirildiğinde seçilecek GuiObject ı ayarlar.
Oyun aracı seçici sola hareket ettirildiğinde seçilecek GuiObject ayarlarını ayarlar.
Oyun aracı seçici sağa hareket ettirildiğinde seçilecek GuiObject ayarlarını ayarlar.
Oyun aracı seçici yukarı hareket ettirildiğinde seçilecek GuiObject ayarlarını ayarlar.
Class.GuiObject 'in piksel ve skalar pozisyonunu belirler.
Class.GuiObject döndürülmesinin oluğunu belirler.
Oyunpad tarafından seçilebilir GUI ile seçilebilir olup olmadığını belirleyin.
Oyunpadlar için kullanılan varsayılan seçim süslemesini geçersiz kılar.
Oyunpad seçiminin seçtiği GuiObjects sırası.
GuiObject 'in piksel ve skalar boyutlarını belirler.
Class.GuiObject ebeveyninin boyutuna göre GuiObject üzerine inşa edilecek Class.GuiObject.Size|Size eksenlerini ayarlar.
Class.GuiObject.BackgroundTransparency|BackgroundTransparency ile TextTransparency arasındaki karışık bir özellik.
Class.GuiObject ve onun çıplaklarının renderlenmesine izin verir.
Class.GuiObject ile ilgili diğerlerine göre şekillendirilen sırayı belirler.
Bir UI öğesinin gerçek ekran pozisyonunu, piksel olarak açıklar.
Bir UI öğesinin asıl ekran dönüşümünü, dereceler olarak açıklar.
Bir UI öğesi'nin aslındaki ekran büyüklüğünü,像 olarak tanımlar.
Açık olarak ayarlandığında, yerelleştirme bu GuiBase2d ve onun aşağıdaki soyundaki tüm benzerlerine uygulanacaktır.
Bu GuiBase2d ve onun aşağıdaki soyundaki otomatik yerelleştirmeyi uygulamak için kullanılan bir referans.
Aşağı yönlü gamepad seçimi davranışını özelleştirir.
Sol yönlü gamepad seçimi davranışını özelleştirir.
Oyun direği seçim davranışını özelleştirir.
Yukarı yönlendirme içinde oyun aracı seçim davranışını özelleştirir.
Oyun başlantısı seçimi hareketinin özelleştirilmesini sağlar.
Yöntemler
Şuradan alınan Yöntemler: GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Bir GUI'yu yeni bir UDim2 'a düzgün bir şekilde hareket ettirir.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Bir GUI'yu yeni bir UDim2 ile otomatik olarak yeniden boyutlandırır.
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : bool,callback : function):bool
Bir GUI'yu yeni bir boyuta ve konuma hızlıca hareket ettirir.
Etkinlikler
Şuradan alınan Etkinlikler: GuiObjectBir kullanıcı, Bir insan-bilgisayar arayüzü cihazı (Farenin aşağısına basma, dokunma başlangıcı, klavye düğmesine aşağı, vb) ile etkileşime geçmeye başladığında oluşturuldu.
Bir kullanıcı, bir Human-Computer Interface cihazı (Mouse button down, touch begin, keyboard button down, etc) aracılığıyla etkileşim kurarken ateşlenir.
Bir kullanıcı, Bir İnsan-Bilgisayar Arayüzü cihazı (Farenin aşağısına gitmesi, dokunma başlangıcı, klavye düğmesi vb.) kullanımını bıraktığında başlatıldı.
Bir kullanıcının mouse'ını bir GUI öğesine hareket ettirince ateş eder.
Bir kullanıcı, farelerini bir GUI öğesinden çıkarırsa ateş eder.
Bir kullanıcının fareini GUI elemanının içinde hareket ettirirken herhangi bir zaman ateş eder.
Bir kullanıcı, fare yüzdesi aştığında, fareyi GUI öğesi üzerinde olduğunda geri çevirir.
Bir kullanıcı, fareyi bir GUI öğesi üzerinde olduğunda ileriye çektiğinde ateş eder.
Gamepad seçici ile GuiObject'e odaklanıldığında yanıyor.
Gamepad seçici Gameui'yu odaklanmaktan vazgeçtiğinde yanıyor.
Oyuncu başladığında, devam ettiğinde ve UI öğesi üzerinde uzun basılı tutulduğunda ateşlenir.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Oyuncu parmaklarını UI elemanında hareket ettirirken ateş eder.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu iki parmak kullanarak bir çıkarma veya çekme hareketini yaptığında ateş eder.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu iki parmak kullanarak döndürme hareketi yaptığında ateş eder.
Oyuncu UI elementinde bir swipe hareketi yaptığında ateş eder.
Oyuncu UI elementinde bir dokunma hareketi yaptığında ateş eder.
- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Gamepad seçimi hareket ettiğinde, ayrıldığında veya bağlı GuiBase2d'de veya ilgili herhangi bir GuiObjeleri değiştirdiğinde ateş eder.
Özellikler
Image
Bu öğün, bir çıkartma veya görüntü yüklenmiş olan Roblox'a ait varlık kimliğini içeren bir içerik türü öğüdür. İçerik türü, Roblox'a ait varlık kimliğiyle ilgili olarak Decal.Texture ile aynıdır. İçer
ImageColor3
ImageColor3 özelliği, bir görünümün nasıl renklenebileceğini belirler. Beyaz olarak ayarlanırsa renklenme olmaz. Bu özellik, görünüm kaynaklarını yeniden kullanmak için çok kullanışlıdır; kaynağınızın bütün rengini bu özellikle ayarlayabilirsiniz.
ImageContent
Bu özellik bir varsayılan veya bir EditableImage nesneyi içeriyor olmalıdır.
Varlık kaynağı, bir çıkartma veya görüntü yüklenmiş olabilir Roblox'a. Aynı şekilde işlev görür Decal.Texture ile ilgili olarak görüntü yüklenmesi konusunda.
Oluşturulan görüntü renkli olacak şekilde boyanacak. ImageButton.ImageColor3 kullanılarak görüntü renkli olarak yapılandırılabilir. ImageButton.ScaleType özelliğine göre 9-sliced olarak yapılandırılabilir.
ImageRectOffset
Bir görünümün parçalı gösterilmesini ImageRectSize ile birleştirir. Bu özellik, görünüm alanının gösterileceği yerin üst kısmını belirler.
ImageRectSize
Bir görüntünün parçalı gösterimini ImageRectOffset ile birleştirir. Bu özellik, görüntünün gösterim boyutunu belirler. Eğer herhangi bir boyut 0 olarak ayarlanırsa, tüm görüntü gösterilir.
ImageTransparency
ImageTransparency UI öğesi render edilen görüntünün alfa'sını belirler. Bir değer 0 bir değeri 1 görüntüsünün tamamen opake ve bir değer 0> ImageTransparency1> görüntüsünün tamamen透明 (görünmez).
Kod Örnekleri
local RunService = game:GetService("RunService")
local imageLabel = script.Parent
local function onRenderStep()
-- Oscillate ImageTransparency from 0 to 1 using a sine wave
imageLabel.ImageTransparency = math.sin(workspace.DistributedGameTime * math.pi) * 0.5 + 0.5
end
RunService.RenderStepped:Connect(onRenderStep)
IsLoaded
The IsLoaded property indicates if the ImageLabel.Image property has finished loading from Roblox. Images declined by moderation will never yükle.
Kod Örnekleri
local imageLabel = script.Parent
local startTime = workspace.DistributedGameTime
-- Wait for the image to load
while not imageLabel.IsLoaded do
task.wait()
end
-- Measure and display how long it took to load
local deltaTime = workspace.DistributedGameTime - startTime
print(("Image loaded in %.3f seconds"):format(deltaTime))
ResampleMode
Ekranda büyüklüğünden daha küçük ekranda görünümünü belirler.Varsayılan olarak, ekranda büyüklüğünden daha küçük ekranda görünümünüzü yumuşatır. Enum.ResamplerMode.Pixelated olarak ayarlandığında, görünümünüzün keskin kenarlarını korur.
ScaleType
ScaleType özelliği, UI öğesi'nin kaynağının boyutundan farklı olduğunda bir ImageLabel.Image ın nasıl görüntülenacağını belirler.
Varsayılan olarak, bu özellik Enum.ScaleType.Stretch olarak belirlenmiştir, bu da görüntü boyutlarını genişletir/kompakt hale getirir, böylece UI öğesi alanına aynen uyar. Roblox'a yüklenirken transparan piksel siyah olarak ayarlanır, bu da kaynaklardaki siyah çizgi çevirimi ile şeffaf görüntüleri uygulay
For Enum.ScaleType.Slice , the SliceCenter property will be revealed in the Özellikler window. This is for nine-slice UI: when scaling up, the corners will remain the source image size. The边ler of the image will stretch to the width/height of the image. Son olarak, image'nin merkez alanını doldurmak için h
Son olarak, Enum.ScaleType.Tile için, TileSize penceresindeki Class.ImageLabel.TileSize|TileSize özelliği gösterilecek. Bu, çizimli görüntüler için, her bir görüntü çerçevesi ile boyutlandırmanın 1> Class.ImageLabel.TileSize|TileSize öz
SliceCenter
The SliceCenter özelliği, ScaleType ile ayarlanmışken 9-sliced bir görüntünün kesme sınırlarını ayarlar when Enum.ScaleType.Slice setlenmiştir. Lütfen bu özelliğin bu koşul altındaki 1>Özell
9-Slice görüntüleri hakkında daha fazla bilgi için, Kullanıcı Arayüzü 9 Slice Design bakın.
SliceScale
9-bölme kenarlarını belirli oranla ölçekler. Bu, 9-bölme kenarlarının yükseltilmiş versiyonunu yüklediğinizde büyüyeceğini gösterir.Varsayılan şu ki 1.0 .
Ayrıca bakınız ScaleType , SliceCenter ve SliceScale .
TileSize
TileSize``ImageLabel ile ortak boyutu belirler. Turing, Datatype.UDim2.new(1, 0, 1, 0) ile başlar. Bu özellik sadece <
Kod Örnekleri
local imageLabel = script.Parent
-- Set the source image to be a 64x64 padlock
imageLabel.Image = "rbxassetid://284402752"
imageLabel.BackgroundTransparency = 0
imageLabel.BackgroundColor3 = Color3.new(1, 1, 1) -- White
imageLabel.ImageColor3 = Color3.new(0, 0, 0) -- Black
local function resizeInACircle()
for theta = 0, 2, 0.02 do
imageLabel.Size = UDim2.new(
0,
100 + math.cos(theta * 2 * math.pi) * 50,
0,
100 + math.sin(theta * 2 * math.pi) * 50
)
task.wait()
end
end
while true do
-- Stretch simply stretches the source image to fit
-- the UI element's space
imageLabel.ScaleType = Enum.ScaleType.Stretch
resizeInACircle()
-- Tile will render the source image multiple times
-- enough to fill the UI element's space
imageLabel.ScaleType = Enum.ScaleType.Tile
imageLabel.TileSize = UDim2.new(0, 64, 0, 64)
resizeInACircle()
-- Slice will turn the image into a nine-slice UI.
imageLabel.ScaleType = Enum.ScaleType.Slice
imageLabel.SliceCenter = Rect.new(30, 30, 34, 34)
resizeInACircle()
end