Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

EditorResourceTooltipPlugin

Eredita: RefCounted < Object

Un plugin che fornisce tooltip avanzati per il tipo di risorsa gestita.

Descrizione

Le estensioni tooltip delle risorse sono usati dal FileSystemDock per generare tooltip personalizzati per risorse specifiche. Ad esempio, il tooltip per una Texture2D visualizza un'anteprima più grande e le dimensioni della texture.

Un'estensione deve essere prima registrata con FileSystemDock.add_resource_tooltip_plugin(). Quando l'utente passa il mouse su una risorsa nel pannello del filesystem che è gestita dall'estensione, viene chiamato _make_tooltip_for_path() per creare il tooltip. Funziona in modo simile a Control._make_custom_tooltip().

Metodi

bool

_handles(type: String) virtual const

Control

_make_tooltip_for_path(path: String, metadata: Dictionary, base: Control) virtual const

void

request_thumbnail(path: String, control: TextureRect) const

Descrizioni dei metodi

bool _handles(type: String) virtual const 🔗

Restituisce true se il plugin gestirà il tipo type di Resource specificato.

Control _make_tooltip_for_path(path: String, metadata: Dictionary, base: Control) virtual const 🔗

Crea e restituisce un tooltip che verrà visualizzato quando l'utente passa il mouse su una risorsa al percorso path specificato nel pannello del filesystem.

Il dizionario metadata è fornito dal generatore di anteprime (vedi EditorResourcePreviewGenerator._generate()).

base è il tooltip predefinito base, che è un VBoxContainer con un nome file, un tipo e delle etichette di dimensioni. Se un altra estensione ha gestito lo stesso tipo di file, base verrà prodotto dall'estensione precedente. Per ottenere il miglior risultato, assicurati che il tooltip base faccia parte del Control restituito.

Nota: È sconsigliato usare ResourceLoader.load(), specialmente con risorse pesanti come modelli o texture, perché renderà l'editor non rispondente durante la creazione del tooltip. È possibile usare request_thumbnail() se si desidera visualizzare un'anteprima nel tuo tooltip.

Nota: Se si desidera scartare base, assicurarsi di chiamare Node.queue_free(), poiché non viene liberato automaticamente.

func _make_tooltip_for_path(path, metadata, base):
    var t_rect = TextureRect.new()
    request_thumbnail(path, t_rect)
    base.add_child(t_rect) # Il TextureRect apparirà in fondo al tooltip.
    return base

void request_thumbnail(path: String, control: TextureRect) const 🔗

Richiede una miniatura per il TextureRect fornito. La miniatura viene creata in modo asincrono dall'EditorResourcePreview e impostata automaticamente quando disponibile.