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...

SubViewportContainer

Eredita: Container < Control < CanvasItem < Node < Object

Un contenitore utilizzato per visualizzare il contenuto di un SubViewport.

Descrizione

Un contenitore che visualizza il contenuto dei nodi SubViewport figlio sottostanti. Utilizza la dimensione combinata dei SubViewport come dimensione minima, a meno che stretch non sia abilitato.

Nota: Modificare il Control.scale di un SubViewportContainer distorcerà visivamente il suo contenuto. Per modificare la sua dimensione visiva senza causare distorsioni, regola invece i margini del nodo (se non è già in un contenitore).

Nota: Il SubViewportContainer inoltra le notifiche di ingresso e uscita del mouse ai suoi viewport secondari.

Proprietà

FocusMode

focus_mode

1 (overrides Control)

bool

mouse_target

false

bool

stretch

false

int

stretch_shrink

1

Metodi

bool

_propagate_input_event(event: InputEvent) virtual const

Descrizioni delle proprietà

bool mouse_target = false 🔗

  • void set_mouse_target(value: bool)

  • bool is_mouse_target_enabled()

Configura se il nodo SubViewportContainer o, in alternativa, i nodi Control dei suoi SubViewport figlio devono essere disponibili come destinazioni di funzionalità che riguardano il mouse, come l'identificazione della destinazione di rilascio nelle operazioni di trascinamento, oppure la forma del cursore del nodo Control su cui si passa sopra.

Se false, i nodi Control all'interno dei suoi SubViewport figlio sono considerati come destinazioni.

Se true, il SubViewportContainer stesso sarà considerato come destinazione.

bool stretch = false 🔗

  • void set_stretch(value: bool)

  • bool is_stretch_enabled()

Se true, la viewport secondaria sarà automaticamente ridimensionata alle dimensioni del controllo.

Nota: Se true, questo proibirà il cambiamento manuale di SubViewport.size dei suoi figli.

int stretch_shrink = 1 🔗

  • void set_stretch_shrink(value: int)

  • int get_stretch_shrink()

Divide la risoluzione effettiva della viewport secondaria per questo valore, preservandone la scala. Può essere utilizzato per velocizzare il rendering.

Ad esempio, una viewport secondaria da 1280×720 con stretch_shrink impostato su 2 sarà renderizzata a 640×360, occupando le stesse dimensioni nel contenitore.

Nota: stretch deve essere true affinché questa proprietà funzioni.

Descrizioni dei metodi

bool _propagate_input_event(event: InputEvent) virtual const 🔗

Sperimentale: Questo metodo potrebbe essere cambiato o rimosso in versioni future.

Metodo virtuale da implementare dall'utente. Se restituisce true, l'evento event viene propagato ai figli SubViewport. La propagazione non avviene se restituisce false. Se la funzione non è implementata, tutti gli eventi vengono propagati ai SubViewport.