ImageButton
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Un ImageButton si comporta in modo simile a un ImageLabel in termini di rendering, con i comportamenti aggiuntivi di un GuiButton .
Sommario
Proprietà
Un ID della texture che verrà utilizzato quando il ImageButton viene passato.
Il contenuto dell'immagine visualizzato dall'elemento ImageButton. Legge e scrive a ImageContent.
Determina come verrà colorata un'immagine rendere.
Il contenuto dell'immagine visualizzato dall'elemento UI. Supporta le risorse URI e gli oggetti EditableImage .
Lo spostamento in pixel della sottocarea di un'immagine da mostrare.
Determina la dimensione in pixel della sott area di un'immagine da mostrare.
Determina la trasparenza dell'immagine renderta.
Indica se l'immagine è stata caricata completamente dal sito Web di Roblox.
Un ID della texture che verrà utilizzato quando viene premuto un ImageButton .
Seleziona la modalità di ridimensionamento dell'immagine per il pulsante.
Determina come verrà ridimensionata un'immagine se viene visualizzata in un elemento UI il cui dimensionamento differisce dall'immagine di origine.
Imposta i confini di taglio di un'immagine a 9 strati.
Aumenta le dimensioni degli angoli a 9 fette secondo la percentuale specificata.
Imposta la scala di riempimento del pulsante immagine.
Determina se il pulsante cambia colore automaticamente quando il mouse passa sopra o clicca su di esso.
Un'istanza HapticEffect che verrà riprodotta quando il GuiButton viene sovrapposto.
Se true mentre l'elemento GUI è visibile, il mouse non verrà bloccato a meno che il pulsante destro del mouse non sia giù.
Un'istanza HapticEffect che verrà riprodotta quando viene premuto il GuiButton .
Una proprietà booleana che indica se l'oggetto è stato selezionato.
Imposta lo stile del GuiButton in base a una lista di stili predefiniti.
Determina se questo elemento UI riceve l'input.
Determina il punto di origine di un GuiObject , rispetto alla sua dimensione assoluta.
Determina se la ridimensionamento avvenga in base al contenuto del figlio.
Determina il colore di sfondo GuiObject .
Determina la trasparenza del GuiObject.
Determina il colore del bordo GuiObject .
Determina in che modo il bordo GuiObject viene disposto rispetto alle sue dimensioni.
Determina la larghezza dei pixel del bordo GuiObject .
Determina se il discendente GuiObjects al di fuori dei confini di un elemento GUI padre deve Renderizzare.
Determina se il mouse del Giocatoreviene attivamente premuto su GuiObject o no.
Determina se il GuiButton può essere interagito o meno, o se il GuiState del GuiObject sta cambiando o meno.
Controlla l'ordine di selezione del GuiObject quando viene utilizzato con un UIGridStyleLayout .
Imposta il GuiObject che verrà selezionato quando il selettore del gamepad viene spostato verso il basso.
Imposta il GuiObject che verrà selezionato quando il selettore del gamepad viene spostato a sinistra.
Imposta il GuiObject che verrà selezionato quando il selettore del gamepad viene spostato a destra.
Imposta il GuiObject che verrà selezionato quando il selettore del gamepad viene spostato verso l'alto.
Determina la posizione pixelare e scalare del GuiObject .
Determina il numero di gradi con cui il GuiObject viene ruotato.
Determina se il GuiObject può essere selezionato da un gamepad.
Sovrascrive l'abbellimento di selezione predefinito utilizzato per i gamepad.
L'ordine di GuiObjects selezionato dall'interfaccia utente del gamepad.
Determina la dimensione pixelare e scalare del GuiObject .
Imposta gli assi Size su cui si baserà il GuiObject , rispetto alla dimensione del suo parent.
Una proprietà mista di BackgroundTransparency e TextTransparency.
Determina se verranno resi i GuiObject e i suoi discendenti.
Determina l'ordine in cui un GuiObject rende relativamente agli altri.
Descrive la posizione effettiva dello schermo di un elemento GuiBase2d in pixel.
Descrive la rotazione effettiva dello schermo di un elemento GuiBase2d in gradi.
Descrive la dimensione effettiva dello schermo di un elemento GuiBase2d , in pixel.
Quando è impostato su true , la localizzazione verrà applicata a questo GuiBase2d e ai suoi discendenti.
Un riferimento a un LocalizationTable da utilizzare per applicare la localizzazione automatizzata a questo GuiBase2d e ai suoi discendenti.
Personalizza il comportamento di selezione del gamepad nella direzione down.
Personalizza il comportamento di selezione del gamepad nella direzione sinistra.
Personalizza il comportamento di selezione del gamepad nella direzione giusta.
Personalizza il comportamento di selezione del gamepad nella direzione up.
Consente la personalizzazione del movimento di selezione del gamepad.
Metodi
Metodi provenienti da GuiObject- TweenPosition(endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Sposta lisciamente una GUI a una nuova UDim2 .
- TweenSize(endSize : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
- TweenSizeAndPosition(endSize : UDim2,endPosition : UDim2,easingDirection : Enum.EasingDirection,easingStyle : Enum.EasingStyle,time : number,override : boolean,callback : function):boolean
Sposta senza problemi una GUI a una nuova dimensione e posizione.
Eventi
Eventi provenienti da GuiButtonSi attiva quando il pulsante è attivato.
Si accende quando il mouse dell'utente fa clic completo sul GuiButton .
Si accende quando l'utente premere il pulsante sinistro del mouse su GuiButton .
Si accende quando l'utente rilascia il pulsante sinistro del mouse fuori dal GuiButton .
Si accende quando il mouse dell'utente fa clic con il pulsante destro completo su GuiButton .
Si accende quando l'utente premere il pulsante destro del mouse verso il basso sul GuiButton .
Si accende quando l'utente rilascia il pulsante destro del mouse off del GuiButton .
Spedito quando un utente inizia a interagire tramite un dispositivo Interfaccia Uomo-Computer (tasto del mouse giù, tocco di inizio, pulsante della tastiera giù, ecc.).
Spedito quando un utente cambia il modo in cui interagisce tramite un dispositivo Interfaccia Uomo-Computer (tasto del mouse verso il basso, tocco di inizio, pulsante della tastiera verso il basso, ecc.).
Spedito quando un utente smette di interagire tramite un dispositivo Interfaccia Uomo-Computer (tasto del mouse giù, tocco di inizio, pulsante della tastiera giù, ecc.).
Si attiva quando un utente muove il mouse su un elemento GUI.
Si attiva quando un utente muove il mouse fuori da un elemento GUI.
Si attiva ogni volta che un utente muove il mouse mentre è all'interno di un elemento GUI.
Si accende quando un utente fa scorrere la ruota del mouse indietro quando il mouse è sopra un elemento GUI.
Si accende quando un utente scorre la ruota del mouse in avanti quando il mouse è sopra un elemento GUI.
Spedito quando l'oggetto Gui viene focalizzato con il selettore Gamepad.
Spedito quando il selettore del Gamepad smette di concentrarsi sull'GuiObject.
Si accende quando il giocatore inizia, continua e smette di premere a lungo l'elemento UI.
- TouchPan(touchPositions : Array,totalTranslation : Vector2,velocity : Vector2,state : Enum.UserInputState):RBXScriptSignal
Si accende quando il giocatore muove il dito sull'elemento UI.
- TouchPinch(touchPositions : Array,scale : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Si accende quando il giocatore esegue una pinza o una trazione utilizzando due dita sull'elemento UI.
- TouchRotate(touchPositions : Array,rotation : number,velocity : number,state : Enum.UserInputState):RBXScriptSignal
Si accende quando il giocatore esegue un gesto di rotazione utilizzando due dita sull'elemento UI.
Si attiva quando il giocatore esegue una gesture di scorrimento sull'elemento UI.
Si attiva quando il giocatore esegue una gesture tap sull'elemento UI.
- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Si accende quando la selezione del gamepad si sposta, lascia o cambia all'interno del connesso GuiBase2d o di qualsiasi discendente GuiObjects .
Proprietà
HoverImageContent
Image
Questa proprietà è una proprietà di tipo contenuto che dovrebbe contenere l'ID risorsa di un decal o di un'immagine caricata su Roblox.Funziona identicamente a Decal.Texture con riguardo al caricamento dell'immagine da Roblox.L'immagine rendere sarà colorata utilizzando ImageColor3 .
Nota che è possibile rendere l'immagine a griglia, ridimensionata per adattarsi o a 9 fette tagliando la ProprietàScaleType.
Campioni di codice
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
Questa proprietà determina come viene colorata un'immagine.Quando è impostato su bianco, non si verifica alcuna colorazione.Questa proprietà è molto utile per riutilizzare le risorse dell'immagine: se l'immagine di origine è completamente bianca con trasparenza, puoi impostare l'intero colore dell'immagine in una volta con questa Proprietà.
Campioni di codice
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
Questa proprietà dovrebbe contenere un URI risorsa o un riferimento a un oggetto EditableImage.L' URI delle risorse può fare riferimento a un decal o immagine caricata su Roblox.Funziona identicamente a Decal.Texture con riguardo al caricamento dell'immagine.
L'immagine rendere sarà colorata utilizzando ImageColor3 .È possibile rendere l'immagine a griglia, ridimensionata per adattarsi o a 9 fette tagliando la ProprietàScaleType.
ImageRectOffset
Questa proprietà determina lo spostamento pixelare (da sinistra in alto) dell'area dell'immagine da visualizzare, consentendo il parziale visualizzazione di un'immagine in combinazione con ImageRectSize .
Campioni di codice
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
endImageRectSize
Questa proprietà determina la dimensione dei pixel dell'area dell'immagine da visualizzare, consentendo il display parziale di un'immagine in combinazione con ImageRectOffset .Se una delle dimensioni è impostata su 0, viene visualizzata l'intera immagine invece.
Campioni di codice
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
endImageTransparency
Questa proprietà determina l'alfa dell'immagine renderta dell'elemento.Un valore di 0 è completamente opaco e un valore di 1 è completamente trasparente (invisibile).Questa proprietà si comporta in modo simile a GuiObject.BackgroundTransparency o BasePart.Transparency .
Se disabiliti il rendering delle immagini impostando ImageTransparency a 1, otterrai un semplice rettangolo che può essere utilizzato come pulsante.Tuttavia, potrebbe essere meglio utilizzare un vuoto TextButton invece.
IsLoaded
Questa proprietà indica se la proprietà Image ha finito di caricare da Roblox. Le immagini rifiutate dalla moderazione non verranno mai Caricare.
Campioni di codice
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
Un ID della texture che può essere impostato come ProprietàImageButton. Quando viene premuto il pulsante, renderizza questa immagine.
PressedImageContent
ResampleMode
Determina come appare l'immagine quando viene ridimensionata.Per impostazione predefinita, l'immagine leviga la texture quando viene visualizzata più grande o più piccola della sua dimensione nella memoria della texture.In contrasto, Enum.ResamplerMode.Pixelated preserva i bordi acuti dei pixel dell'immagine.
ScaleType
Questa proprietà determina in che modo la proprietà Image viene visualizzata quando la dimensione assoluta dell'elemento UI differisce dalla dimensione dell'immagine di origine.
Per impostazione predefinita, questa proprietà è Enum.ScaleType.Stretch che semplicemente allungherà/compatterà le dimensioni dell'immagine in modo che si adatti esattamente allo spazio dell'elemento UI.Poiché i pixel trasparenti sono impostati su nero durante l'upload su Roblox, le immagini trasparenti dovrebbero applicare la fusione alfa per evitare un contorno nero attorno alle immagini ridimensionate.
Per Enum.ScaleType.Slice , quando si aumenta la scala, i bordi rimarranno la dimensione dell'immagine di origine.I bordi dell'immagine si allungheranno fino alla larghezza/altezza dell'immagine.Infine, il centro dell'immagine si estenderà per riempire l'area centrale dell'immagine.Per saperne di più sulle immagini a 9 strati, vedi Interfaccia utente a 9 strati.
Per Enum.ScaleType.Tile , la dimensione di ogni tile di immagine è determinata dalla ProprietàTileSize.
SliceCenter
Questa proprietà imposta i confini di taglio di un'immagine a 9 strati quando ScaleType è impostato su Enum.ScaleType.Slice .
Per saperne di più sulle immagini a 9 strati, vedi Interfaccia utente a 9 strati.
SliceScale
Aumenta le dimensioni degli angoli a 9 fette secondo la percentuale specificata.Questo significa che i bordi intorno alla 9‑slice cresceranno come se tu avessi caricato una nuova versione della texture upscalata.Predefinito a 1.0 .
Come moltiplicatore per i confini di una fetta 9, è utile per riutilizzare un'immagine angolare arrotondata per più raggi.
Vedi anche ScaleType che determina come verrà ridimensionata un'immagine se visualizzata in un elemento UI la cui dimensione differisce dall'immagine di origine.
TileSize
Imposta la dimensione di riempimento del ImageButton a partire dall'angolo superiore sinistro dell'immagine.I valori predefiniti UDim2 sono
Questa proprietà è attiva solo se la proprietà ScaleType è impostata su Enum.ScaleType.Tile.