> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Croix directionnelle
> Croix directionnelle
# Croix directionnelle
Contrôle de croix directionnelle qui correspond toujours à la croix directionnelle de la manette.
## Propriétés
`type` - *"directionalPad"*. Spécifie le type de contrôle.
`scale` - *nombre*, *facultatif*. La valeur par défaut est 1. Multiplicateur de taille, utile puisque les croix directionnelles sont placées comme des boutons et ne sont pas mises à l'échelle automatiquement comme les manettes de jeu.
`deadzone` - *nombre*, *facultatif*. Valeur comprise entre 0 et 1 qui spécifie la taille de la zone morte en pourcentage du contrôle. Notez que, contrairement à la [zone morte](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone) des manettes de jeu, les zones mortes de la croix directionnelle sont toujours axiales (carrées).
`enabled` - *booléen*, *facultatif*. La valeur par défaut est `true`. Définit l'état visuel du contrôle comme activé/désactivé. Un contrôle désactivé recevra toujours les entrées du joueur, mais ne modifiera PAS son style visuel en fonction de ces entrées.
`visible` - *booléen*, *facultatif*. La valeur par défaut est `true`. Détermine si le contrôle est affiché au joueur pour qu'il puisse interagir avec celui-ci. Pour le modifier pendant le jeu, consultez [Modification des dispositions tactiles à l'aide de l'état du jeu](/fr-CA/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state#change_state).
`styles` - *objet*, *facultatif*. Personnalisation de la représentation visuelle du contrôle. Les styles sont représentés sous forme d'un objet par état pouvant être stylisé.
`interaction` - *objet*, *facultatif*. Définitions de propriétés qui peuvent modifier les mécanismes d'interaction de l'utilisateur avec le contrôle
**Interaction**
`activationType` - *chaîne*, *facultatif*. Définit le type d'activation autorisé pour une direction donnée lors de l'interaction avec la croix directionnelle. La valeur par défaut est `allowNeighboring`. Avec `exclusive`, une seule direction peut être activée à la fois sur la croix directionnelle (c.-à-d. une seule parmi « Haut », « Droite », « Bas » ou « Gauche »). Avec `allowNeighboring`, une direction et l'une ou l'autre de ses directions voisines peuvent être activées simultanément en touchant entre elles (c.-à-d. que l'utilisateur peut activer « Haut+Droite », « Droite+Bas », « Bas+Gauche » ou « Gauche+Haut » en touchant entre chacune d'elles, en plus de pouvoir activer chaque direction individuellement).
**États et propriétés de style**
Les états suivants du contrôle de croix directionnelle peuvent être stylisés :
* `default` - Le style de base.
* `disabled` - Le style lorsque le contrôle est désactivé. S'il n'est pas spécifié, une transformation est appliquée au style par défaut lorsque le contrôle est désactivé afin qu'il paraisse désactivé.
* `idle` - Appliqué lorsque le joueur n'interagit PAS avec le contrôle.
* `activated` - Appliqué lorsque le joueur touche le bouton.
Les propriétés suivantes peuvent être utilisées pour styliser le contrôle de croix directionnelle :
`opacity` - *nombre*, *facultatif*. L'opacité à appliquer au contrôle. La valeur par défaut est 1.0 pour tous les états, sauf `disabled`.
`fill` - *objet*, *facultatif*. Objet comportant une couleur définie pour le dégradé à utiliser lorsque la croix directionnelle est activée.
`gradient` - *objet*, *facultatif*. Objet comportant une couleur définie pour le dégradé à utiliser lorsque la croix directionnelle est activée.
`background` - *objet*, *facultatif*. Peut être soit une [couleur](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-color), soit une [ressource d'image](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-asset).
`stroke` - *objet*, *facultatif*. Couleur à utiliser pour le contour de la croix directionnelle. Doit être un objet [stroke](/fr-CA/reference/system/touchadaptationkit/types/game-streaming-touch-stroke).
**Dimensions des ressources**
Pour chacun des objets de style qui acceptent des ressources d'image, une ressource donnée est fournie à une résolution de base et à des échelles de 1.5x, 2.0x, 3.0x et 4.0x de cette résolution de base. La résolution d'une image donnée doit être inférieure ou égale aux résolutions maximales suivantes :
| Objet | @1.0x | @1.5x | @2.0x | @3.0x | @4.0x |
| :- | :- | :- | :- | :- | :- |
| background | 75x75 | 112x112 | 150x150 | 225x225 | 300x300 |
## Remarques
La croix directionnelle sert à offrir une expérience semblable à celle de la croix directionnelle de la manette physique.
Si elle est utilisée comme principal mécanisme de déplacement du joueur (normalement dans l'emplacement `left` `inner`), il est recommandé d'utiliser une échelle de 2.
**Remarques sur le style**
Si vous utilisez une ressource d'image personnalisée pour `background`, les résolutions maximales indiquées s'appliquent pour scale=1.0. Si vous utilisez une autre échelle, les résolutions maximales seront égales au produit de la résolution et de l'échelle. Par exemple, scale=1.5 implique qu'une image d'arrière-plan à @1.0x PPP peut avoir une résolution maximale de 90x90.
Lors de la diffusion en continu au moyen de la version Windows de Content Test Application, certains styles ne s'affichent pas correctement.
## Exemples
#### Exemple 1 : Croix directionnelle par défaut
**Figure 1. Croix directionnelle**
```
{
"type": "directionalPad",
"scale": 1.0
}
```
#### Exemple 2 : Croix directionnelle plus grande avec des couleurs personnalisées.
**Figure 1. Croix directionnelle personnalisée**
```
{
"type": "directionalPad" ,
"scale": 2.0,
"styles" : {
"default" : {
"fill" : "#0e7a0d10",
"gradient" : {
"color": "#0e7a0d10"
},
"stroke" : {
"type": "solid",
"color" : "#0e7a0dff"
}
}
}
}
```
## Configuration requise
**Version de la disposition :** 1.0+, (prise en charge du style à partir de 3.0+, prise en charge de l'interaction à partir de 3.4+).
## Related topics
- [XR022 Normes de dénomination officielles](/fr/publishing/certification/fma/xr-022.md)
- [XR022 Normes d'appellation officielles](/fr-CA/publishing/certification/fma/xr-022.md)