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

TouchScreenButton

Hérite de : Node2D < CanvasItem < Node < Object

Bouton pour écran tactile pour utilisation durant le gameplay.

Description

TouchScreenButton vous permet de créer des boutons à l'écran pour les appareils tactiles. Il est destiné à l'utilisation durant le gameplay, comme avec une unité que vous devez toucher pour la bouger. Contrairement à Button, TouchScreenButton supporte directement le multi-toucher. Plusieurs TouchScreenButtons peuvent être appuyés en même temps avec l'entrée tactile.

Ce nœud hérite de Node2D. Contrairement aux nœuds Control, vous ne pouvez pas définir des ancres dessus. Si vous voulez créer des menus ou des interfaces utilisateur, vous pourriez vouloir utiliser des nœuds Button à la place. Pour que les nœuds de bouton réagissent aux événements tactiles, vous pouvez activer ProjectSettings.input_devices/pointing/emulate_mouse_from_touch dans les paramètres du projet.

Vous pouvez configurer TouchScreenButton pour être visible uniquement sur les appareils tactiles, vous aidant ainsi à développer votre jeu à la fois pour les appareils de bureau et mobiles.

Propriétés

String	action	`""`
BitMap	bitmask
bool	passby_press	`false`
Shape2D	shape
bool	shape_centered	`true`
bool	shape_visible	`true`
Texture2D	texture_normal
Texture2D	texture_pressed
VisibilityMode	visibility_mode	`0`

Méthodes

bool	is_pressed() const

Signaux

pressed() 🔗

Émis quand le bouton est pressé.

released() 🔗

Émis quand le bouton est relâché.

Énumérations

enum VisibilityMode: 🔗

VisibilityMode VISIBILITY_ALWAYS = 0

Toujours visible.

VisibilityMode VISIBILITY_TOUCHSCREEN_ONLY = 1

Visible que sur les écrans tactiles.

Descriptions des propriétés

String action = "" 🔗

void set_action(value: String)
String get_action()

L'action du bouton. Les actions peuvent être interceptées avec InputEventAction.

BitMap bitmask 🔗

void set_bitmask(value: BitMap)
BitMap get_bitmask()

Le masque binaire du bouton.

bool passby_press = false 🔗

void set_passby_press(value: bool)
bool is_passby_press_enabled()

Si true, les signaux pressed et released sont émis lorsqu'un doigt appuyé entre et sort du bouton, même si la pression a commencé à l'extérieur de la zone active du bouton.

Note : Il s'agit d'un mode d'appui "pass-by" (et non "bypass").

Shape2D shape 🔗

void set_shape(value: Shape2D)
Shape2D get_shape()

La forme du bouton.

bool shape_centered = true 🔗

void set_shape_centered(value: bool)
bool is_shape_centered()

Si true, la forme du bouton est centrée dans la texture fournie. Si aucune texture n'est utilisée, cette propriété n'a aucun effet.

bool shape_visible = true 🔗

void set_shape_visible(value: bool)
bool is_shape_visible()

Si true, la forme du bouton est visible dans l'éditeur.

Texture2D texture_normal 🔗

void set_texture_normal(value: Texture2D)
Texture2D get_texture_normal()

La texture du bouton pour l'état normal.

Texture2D texture_pressed 🔗

void set_texture_pressed(value: Texture2D)
Texture2D get_texture_pressed()

La texture du bouton pour l'état appuyé.

VisibilityMode visibility_mode = 0 🔗

void set_visibility_mode(value: VisibilityMode)
VisibilityMode get_visibility_mode()

Le mode de visibilité du bouton.

Descriptions des méthodes

bool is_pressed() const 🔗

Renvoie true si le bouton est actuellement appuyé.