ImageButton
*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 ImageButton , görüntüleme konusunda bir ImageLabel ile benzer şekilde davranır, bir GuiButton 'in ek davranışlarıyla.
Özet
Özellikler
ImageButton gezdirildiğinde kullanılacak bir doküman ID'si.
ImageButton öğesi tarafından gösterilen görüntü içeriği. Okuyor ve ImageContent yazıyor.
Render edilmiş bir görüntünün nasıl renklendirileceğini belirler.
Arayüz elemanı tarafından gösterilen görüntü içeriği. Varlık URI'lerini ve EditableImage nesnelerini destekler.
Görüntünün alt alanındaki piksellerdeki ofset. Görüntü gösterilecek.
Görüntünün alt alanının piksel boyutunu belirler ve görüntü görüntülenir.
Rendelenen görüntünün transparanlığını belirler.
Resmin Roblox web sitesinden yüklenmesi bitip bitmediğini gösterir.
Bir ImageButton
Buton için görüntü yeniden boyutlandırma modunu seçer.
Bir görüntünün kaynağından farklı bir boyuta sahip bir UI öğesinde görüntülenmesi durumunda ölçekleneceğini belirler.
9 dilimli bir görüntünün dilim sınırlarını ayarlar.
9 dilim kenarlarını belirtilen oranla ölçeklendirir.
ImageButton'un kare ölçeğini ayarlar.
Butonun, fare üzerinde gezinirken veya üzerine tıklarken otomatik olarak renk değiştirip değiştirmediğini belirler.
Bir HapticEffect örneği, GuiButton üzerinde gezinti yapıldığında oynayacak.
GUI öğesi görülebilirken true , sağ fare düğmesi aşağı olmadığı sürece fare kilitlenmeyecektir.
Bir HapticEffect örneği, GuiButton basıldığında oynayacak.
Nesnenin seçildiğini gösteren bir boolean özellik.
Önceden belirlenmiş stillerden oluşan bir listeye dayanarak GuiButton stilini ayarlar.
Bu UI öğesinin girişi alıp almadığını belirler.
Bir GuiObject 'in mutlak boyutuna göre kaynağı noktasını belirler, mutlak boyutuna göre.
Yeniden boyutlandırmanın çocuk içeriğine dayalı olup olmadığını belirler.
GuiObject arka plan rengini belirler.
GuiObject arka planının ve sınırının saydamlığını belirler.
GuiObject sınırının rengini belirler.
GuiObject sınırının boyutlarına göre nasıl düzenleneceğini belirler.
GuiObject sınırının piksel genişliğini belirler.
Ebeveyn bir GUI öğesinin sınırlarının dışında olup olmadığına bakarak altının GuiObjects renderlanması gereip geremediğini belirler.
oyuncumouse'unun GuiObject üzerinde aktif olarak basılıp basılmadığını belirler.
GuiButton ile etkileşime girilebilir olup olmadığını veya GuiState 'nin değişip değişmediğini belirler, ya da GuiObject 'nin değişip değişmediği.
Bir GuiObject ile kullanıldığında UIGridStyleLayout sıralama düzenini kontrol eder.
Oyun kolu seçicisi aşağıya kaydırıldığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisinin sola taşındığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisinin sağa taşındığında seçilecek GuiObject ayarını ayarlar
Oyun kolu seçicisi yukarı taşındığında seçilecek GuiObject ayarını ayarlar
GuiObject 'nin piksel ve skalar konumunu belirler.
GuiObject döndürüldüğünde döndürülen derece sayısını belirler.
GuiObject bir oyun kolu tarafından seçilebilir olup olmadığını belirleyin.
Oyun konsolları için kullanılan varsayılan seçim aksesuarlarını değiştirir.
Oyun kumanda UI seçimi tarafından seçilen GuiObjects sırası.
GuiObject 'nin piksel ve skalar büyüklüğünü belirler.
Size eksenlerini ayarlar, üzerinde ebeveynin boyutuna göre yapılacak GuiObject , ebeveynin boyutuna göre yapılacak
BackgroundTransparency ve TextTransparency 'in karışık bir özelliği.
GuiObject ve onun soyundakilerin render edilecek olup olmadığını belirler.
Bir GuiObject'nin diğerlerine göre hangi sırayla görüntüleneceğini belirler.
Bir GuiBase2d öğesinin gerçek ekran konumunu, piksel olarak tanımlar.
Bir GuiBase2d öğesinin gerçek ekran dönüşünü derecelerle tanımlar.
Bir GuiBase2d öğesinin gerçek ekran boyutunu, piksel olarak tanımlar.
true olarak ayarlanırsa, yerelleştirme bu GuiBase2d ve onun soyundakilere uygulanacaktır.
Bu GuiBase2d ve onun soyundakilere otomatik yerelleştirme uygulamak için kullanılacak bir LocalizationTable.
Aşağı yönünde oyun kolu seçim davranışını özelleştirir.
Oyun kolu seçim davranışını sol yönde özelleştirir.
Oyun kolu seçim davranışını doğru yönde özelleştirir.
Oyun kolu seçim davranışını yukarı yönünde özelleştirir.
Oyun kolu seçim hareketinin özelleştirilmesine izin verir.
Yöntemler
Şuradan alınan Yöntemler: GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GUI'yi yumuşakça yeni bir UDim2 'ye taşır.
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GuiObject 'yi yumuşak bir şekilde yeni bir UDim2 'ye yeniden boyutlandırır.
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Bir GUI'yi yumuşakça yeni bir boyuta ve konuma taşır.
Etkinlikler
Şuradan alınan Etkinlikler: GuiButtonButon etkinleştirildiğinde ateş eder.
Kullanıcının fare tamamen GuiButton üzerine tıkladığında ateş eder.
Kullanıcı, GuiButton üzerinde sol fare düğmesine basınca ateş eder.
Kullanıcı sol fare düğmesini GuiButton 'den kaldırdığında ateş eder.
Kullanıcının fare tamamen sağ tıkladığında GuiButton 'ye ateş eder.
Kullanıcı sağ fare düğmesini aşağı bastırdığında GuiButton üzerinde ateş eder.
Kullanıcı sağ fare düğmesini GuiButton 'den kaldırdığında ateş eder.
Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşime başladığında ateş edilir (Fare düğmesi aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla nasıl etkileşime girdiğini değiştirdiğinde ateş edilir (Fare düğmesü aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcı, İnsan-Bilgisayar Arayüzü cihazı aracılığıyla etkileşime son verdiğinde ateş edilir (Mouse düğmes aşağı, dokunma başlar, klavye düğmesi aşağı, vb.).
Bir kullanıcının fareini bir GUI öğesine taşıdığında ateş eder.
Bir kullanıcı GUI öğesinden fareni taşıdığında ateş eder.
Bir kullanıcı bir GUI öğesinin içindeyken fareyi hareket ettirdiğinde herhangi bir zamanda ateş eder.
Bir kullanıcı, fare bir GUI öğesinin üzerinde olduğunda fare tekerleğini geri sürüklediğinde ateş eder.
Bir kullanıcı, fare işaretçisi bir GUI öğesinin üzerinde olduğunda fare tekerleğini ileriye doğru kaydırdığında ateş eder.
GuiObject, Gamepad seçicisi ile odaklanırken ateş edildi.
Oyun Konsolu seçicisi GuiObject'e odaklanmayı bıraktığında ateş edilir.
Oyuncu başladığında, devam ettiğinde ve uzun süre UI öğesine basmayı bıraktığında ateş eder.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Oyuncu UI öğesine parmağını hareket ettirdiğinde ateş eder.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu, UI öğesinde iki parmağı kullanarak bir kıskaç veya çekme hareketi gerçekleştirdiğinde ateş eder.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Oyuncu, UI öğesinde iki parmağı kullanarak bir dönüş hareketi gerçekleştirdiğinde ateş eder.
Oyuncu UI öğesine kaydırma hareketi yaptığında ateş eder.
Oyuncu UI öğesine dokunma hareketi yaptığında ateş eder.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Oyun kolu seçimi, hareket eder, değişir veya bağlantılı GuiBase2d veya herhangi bir altın içinde değişir, bağlantılı GuiObjects .
Özellikler
HoverImageContent
Image
Bu özellik, Roblox'a yüklenen bir rozet veya görüntünün ID'sini tutan bir içerik türü özelliğidir.Roblox'tan görüntü yükleme konusunda aynı şekilde çalışır Decal.Texture .Kararlı görüntü, ImageColor3 kullanarak renklendirilecektir.
Görüntünün kare hale getirilmesinin, ölçeklendirilmesinin veya ScaleType.
Kod Örnekleri
This code sample causes an ImageLabel/ImageButton to display a red padlock. When the mouse is hovered, it changes to a green unlocked padlock.
local imageLabel = script.Parent
-- The images in this example are 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Unlocked padlock (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Dark green
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Locked padlock (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Dark red
end
-- Connect events; our default state is locked
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()
ImageColor3
Bu özellik, bir görüntünün nasıl renklendirileceğini belirler.Beyaz olarak ayarlanırsa, renklendirme gerçekleşmez.Bu özellik, görüntü varlıklarını yeniden kullanmak için çok yararlıdır: Kaynak görüntü transparanlıkla tamamen beyazsa, tüm görüntünün rengini bu özellikle bir kerede ayarlayabilirsiniz.
Kod Örnekleri
This code sample causes an ImageLabel/ImageButton to display a red padlock. When the mouse is hovered, it changes to a green unlocked padlock.
local imageLabel = script.Parent
-- The images in this example are 64x64
imageLabel.Size = UDim2.new(0, 64, 0, 64)
local function unlock()
imageLabel.Image = "rbxassetid://284402785" -- Unlocked padlock (64x64)
imageLabel.ImageColor3 = Color3.new(0, 0.5, 0) -- Dark green
end
local function lock()
imageLabel.Image = "rbxassetid://284402752" -- Locked padlock (64x64)
imageLabel.ImageColor3 = Color3.new(0.5, 0, 0) -- Dark red
end
-- Connect events; our default state is locked
imageLabel.MouseEnter:Connect(unlock)
imageLabel.MouseLeave:Connect(lock)
lock()
ImageContent
Bu özellik bir varlık URI'si veya bir EditableImage referans tutmalıdır.Varlık URI'si, Roblox'a yüklenen bir rozet veya görüntü referans edebilir.Görüntü yükleme konusunda aynı şekilde çalışır Decal.Texture .
Kararlı görüntü, ImageColor3 kullanarak renklendirilecektir.Resmin kare hale getirilmesi, ölçeklendirilmesi veya ScaleType özelliğini ayarlayarak 9 parçaya bölünmesi mümkündür.
ImageRectOffset
Bu özellik, görüntü alanının görüntülenmesi gereken piksel ofsetini (üst soldan) belirler, böylece bir görüntünün kısmi görüntülenmesine izin verir ImageRectSize .
Kod Örnekleri
This code sample uses ImageRectOffset/ImageRectSize in order to play an animation of a man throwing a punch
-- Place this in an ImageLabel/ImageButton with size 256x256
local imageLabel = script.Parent
-- The following image is 1024x1024 with 12 frames (256x256)
-- The frames play an animation of a man throwing a punch
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- The order of the frames to be displayed (left-to-right, then top-to-bottom)
local frames = {
Vector2.new(0, 0),
Vector2.new(1, 0),
Vector2.new(2, 0),
Vector2.new(3, 0),
Vector2.new(0, 1),
Vector2.new(1, 1),
Vector2.new(2, 1),
Vector2.new(3, 1),
Vector2.new(0, 2),
Vector2.new(1, 2),
Vector2.new(2, 2),
Vector2.new(3, 2),
}
-- Animate the frames one at a time in a loop
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end
ImageRectSize
Bu özellik, görüntü alanında görüntülenmesi gereken piksel boyutunu belirler, böylece bir görüntünün kısmi görüntülenmesine izin verir ImageRectOffset .Her iki boyut da 0 olarak ayarlanırsa, tüm görüntü yerine gösterilir.
Kod Örnekleri
This code sample uses ImageRectOffset/ImageRectSize in order to play an animation of a man throwing a punch
-- Place this in an ImageLabel/ImageButton with size 256x256
local imageLabel = script.Parent
-- The following image is 1024x1024 with 12 frames (256x256)
-- The frames play an animation of a man throwing a punch
imageLabel.Image = "rbxassetid://848623155"
imageLabel.ImageRectSize = Vector2.new(256, 256)
-- The order of the frames to be displayed (left-to-right, then top-to-bottom)
local frames = {
Vector2.new(0, 0),
Vector2.new(1, 0),
Vector2.new(2, 0),
Vector2.new(3, 0),
Vector2.new(0, 1),
Vector2.new(1, 1),
Vector2.new(2, 1),
Vector2.new(3, 1),
Vector2.new(0, 2),
Vector2.new(1, 2),
Vector2.new(2, 2),
Vector2.new(3, 2),
}
-- Animate the frames one at a time in a loop
while true do
for _, frame in ipairs(frames) do
imageLabel.ImageRectOffset = frame * imageLabel.ImageRectSize
task.wait(0.1)
end
end
ImageTransparency
Bu özellik, elemanın görüntülenen görüntüsünün alfa değerini belirler.Bir değer 0 bütünüyle opaktır ve bir değer 1 bütünüyle şeffaftır (görünmez).Bu özellik GuiObject.BackgroundTransparency veya BasePart.Transparency ile benzer şekilde davranır.
Resim görüntülemeyi devre dışı bırakmak için ImageTransparency ı 1 olarak ayarlarsanız, bir düğme olarak kullanılabilecek basit bir dikdörtgen elde edilir.Ancak, boş bir TextButton yerine kullanmak daha iyi olabilir.
IsLoaded
Bu özellik, Image özelliğinin Roblox'tan yüklenmesinin bitip bitmediğini gösterir. Moderasyon tarafından reddedilen görüntüler asla yüklenmez.
Kod Örnekleri
This code sample measures how long an ImageLabel or ImageButton takes to load an image. If the image was already loaded, this will be 0.
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))
PressedImage
Bir ImageButton özellik olarak ayarlanabilen bir doküman kimliği. Düğme basıldığında, bu görüntüyü renderlayacaktır.
PressedImageContent
ResampleMode
Resmin ölçeklendirildiğinde nasıl göründüğünü belirler.Varsayılan olarak, görüntü, dokunma hafızasındaki boyutundan daha büyük veya daha küçük gösterildiğinde dokuyu düzleştirir.Buna karşılık, Enum.ResamplerMode.Pixelated görüntü pikselerinin keskin kenarlarını korur.
ScaleType
Bu özellik, UI öğesinin mutlak boyutu kaynağın görüntü boyutundan farklı olduğunda Image özelliğinin nasıl görüntüleneceğini belirler.
Varsayılan olarak, bu özellik Enum.ScaleType.Stretch dir, ki bu sadece görüntü boyutlarını genişletir/kompaktlaştırır ve böylece UI öğesinin alanına uyar.Transparan pikseller Roblox'a yüklendiğinde siyaha ayarlandığından, transparan görüntüler ölçekli görüntülerin etrafında koyu bir çizgi önlemek için alfa karışımı uygulamalıdır.
For Enum.ScaleType.Slice , yükseltirken, köşeler kaynak görüntü boyutu olarak kalacaktır.Görüntünün kenarları görüntünün genişliğine/yüksekliğine uzanacaktır.Son olarak, görüntünün merkezi, görüntünün merkezi alanını doldurmak için genişleyecektir.9 dilimli görüntüler hakkında daha fazla bilgi edinmek için, UI 9‑Slice Tasarımı'a bakın.
For Enum.ScaleType.Tile için, her görüntü aracının boyutu TileSize özelliği tarafından belirlenir.
SliceCenter
Bu özellik, Class.ImageButton.ScaleType|ScaleType``Enum.ScaleType.Slice|Enum.ScaleType.Slice >.
9 dilimli görüntüler hakkında daha fazla bilgi edinmek için, UI 9-Dilim Tasarımı'a bakın.
SliceScale
9 dilim kenarlarını belirtilen oranla ölçeklendirir.Bu, 9 dilimin kenarlarının, yüksek çözünürlüklü dokunun yeni bir versiyonunu yüklemiş gibi büyüyeceği anlamına gelir.Varsayılan değeri 1.0 dir.
Bir 9 dilimin sınırları için çarpan olarak, çoklu yayınlar için bir kenar kare görüntüsünü yeniden kullanmak için yararlıdır.
Ayrıca bakın ScaleType , bir görüntünün kaynağından farklı bir boyuta sahip bir UI öğesinde görüntülenirse nasıl ölçeceğini belirleyen.
TileSize
Resmin üst sol köşesinden başlayarak ImageButton döşeme boyutunu ayarlar.Varsayılan değerleri ; ölçek bileşenleri boyutuna göre kaydırırken, ofset bileşenleri ham piksellerde olacaktır.Örneğin, 0.5 ölçeği, karelin eşdeğer eksendeki ImageButton büyüklüğünün yarısı olacağını gösterir.
Bu özellik yalnızca ScaleType özelliği Enum.ScaleType.Tile olarak ayarlanırsa aktiftir.