Les variables DialogOptionsRenderingInfo sont utilisez par le système d'options personnalisées de dialogue. Vous ne pouvez pas en créer vous-même, elles seront passées aux fonctions d'option de dialogue de la façon décrite dans la page précitée.

---

int DialogOptionsRenderingInfo.ActiveOptionID;

Retourne/Définit l'option active courante de l'écran d'options du dialogue. Vous l'utilisez dans la fonction dialog_options_get_active pour déclarer à AGS quelle option survole la souris. Cela vous assure d'activer l'option correcte lorsque le joueur clique avec le bouton de la souris.

Vous pouvez lire cette propriété dans la fonction dialog_options_render pour illuminer l'option sélectionnée d'une manière différente des autres.

Cette propriété peut être définie à 0, ce qui signifie qu'aucune option n'est sélectionnée ; sinon, elle vaudra de l'option numéro 1 au nombre total d'options dans le dialogue.

Exemple :

function dialog_options_get_active(DialogOptionsRenderingInfo *info)
{
  info.ActiveOptionID = 1;
}

sélectionne toujours la première option.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : Dialog.GetOptionState

---

Dialog* DialogOptionsRenderingInfo.DialogToRender;

Retourne le dialogue qui doit être affiché. Vous pouvez parcourir toutes les options du dialogue pour décider quoi afficher à l'écran.

Exemple : Pour un exemple, veuillez consulter la page des options de dialogue personnalisées.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : Dialog.GetOptionState, DialogOptionsRenderingInfo.Surface

---

int DialogOptionsRenderingInfo.Height;

Retourne/Définit la hauteur de la zone nécessaire pour afficher les options de dialogue.

Cela peut seulement être défini dans la fonction dialog_options_get_dimensions, mais peut être lu dans toutes les autres fonctions afin d'afficher les options.

Exemple :

function dialog_options_get_dimensions(DialogOptionsRenderingInfo *info)
{
  info.Width = 300;
  info.Height = 150;
}

crée une zone de 300×150 pour y afficher les options du dialogue.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : DialogOptionsRenderingInfo.Width

---

int DialogOptionsRenderingInfo.ParserTextBoxWidth;

Retourne/Définit la largeur de la zone de saisie (textbox) de l'analyseur de texte (parser) pour les options du dialogue. Si l'analyseur de texte n'est pas activé pour ce dialogue, ce réglage sera ignoré.

Cette propriété ne peut être définie que dans la fonction dialog_options_get_dimensions.

Exemple :

function dialog_options_get_dimensions(DialogOptionsRenderingInfo *info)
{
  info.Width = 300;
  info.Height = 150;
  // Place l'analyseur de texte en bas (s'il est activé)
  info.ParserTextBoxX = 10;
  info.ParserTextBoxY = 130;
  info.ParserTextBoxWidth = 180;
}

positionne l'analyseur de texte à (10,130) dans la zone des options du dialogue de dimensions 300×150.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : DialogOptionsRenderingInfo.Width, DialogOptionsRenderingInfo.ParserTextBoxX, DialogOptionsRenderingInfo.ParserTextBoxY

---

int DialogOptionsRenderingInfo.ParserTextBoxX;

Retourne/Définit la position X de la zone de saisie (textbox) de l'analyseur de texte (parser) des options du dialogue. Si l'analyseur de texte n'est pas activé pour ce dialogue, ce réglage sera ignoré.

La position X est relative à la surface des options du dialogue. Ce la signifie qu'un X de 10 le positionnera à 10 pixels du bord gauche du cadre des options du dialogue, et non à 10 pixels du bord gauche de l'écran.

Cette propriété ne peut être définie que dans la fonction dialog_options_get_dimensions.

Exemple :

function dialog_options_get_dimensions(DialogOptionsRenderingInfo *info)
{
  info.Width = 300;
  info.Height = 150;
  // Place l'analyseur de texte en bas (s'il est activé)
  info.ParserTextBoxX = 10;
  info.ParserTextBoxY = 130;
  info.ParserTextBoxWidth = 180;
}

positionne l'analyseur de texte à (10,130) dans la zone des options du dialogue de dimensions 300×150.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : DialogOptionsRenderingInfo.ParserTextBoxWidth, DialogOptionsRenderingInfo.ParserTextBoxY

---

int DialogOptionsRenderingInfo.ParserTextBoxY;

Retourne/Définit la position Y de la zone de saisie (textbox) de l'analyseur de texte (parser) des options du dialogue. Si l'analyseur de texte n'est pas activé pour ce dialogue, ce réglage sera ignoré.

La position Y est relative à la surface des options du dialogue. Ce la signifie qu'un Y de 10 le positionnera à 10 pixels du bord supérieur du cadre des options du dialogue, et non à 10 pixels du bord supérieur de l'écran.

Cette propriété ne peut être définie que dans la fonction dialog_options_get_dimensions.

Exemple :

function dialog_options_get_dimensions(DialogOptionsRenderingInfo *info)
{
  info.Width = 300;
  info.Height = 150;
  // Place l'analyseur de texte en bas (s'il est activé)
  info.ParserTextBoxX = 10;
  info.ParserTextBoxY = 130;
  info.ParserTextBoxWidth = 180;
}

positionne l'analyseur de texte à (10,130) dans la zone des options du dialogue de dimensions 300×150.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : DialogOptionsRenderingInfo.ParserTextBoxX

---

DrawingSurface* DialogOptionsRenderingInfo.Surface;

Retourne la surface de dessin (drawing surface) qui peut être utilisée pour dessiner les options du dialogue.

Cela ne peut être utilisé que dans la fonction dialog_options_render ; retournera null dans toutes les autres fonctions.

Contrairement à la plupart des utilisations des DrawingSurface, vous ne devez PAS rafraîchir (Release) celle-ci. AGS le fera automatiquement pour vous une fois que la fonction dialog_options_render aura fini d'être exécutée.

La taille de la surface devrait correspondre aux paramètres Largeur (Width) et Hauteur (Height) requis dans la fonction dialog_options_get_dimensions.

Exemple :

function dialog_options_render(DialogOptionsRenderingInfo *info)
{
  info.Surface.Clear(14);
}

rend la zone d'options du dialogue entièrement jaune.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : DrawingSurfaces (surfaces de dessin) : fonctions et propriétés

---

int DialogOptionsRenderingInfo.Width;

Retourne/Définit la largeur de la surface nécessaire pour dessiner les options du dialogue.

Cette propriété ne peut être définie que dans la fonction dialog_options_get_dimensions, mais peut être consultée dans toutes les autres fonctions afin d'afficher les options.

Exemple :

function dialog_options_get_dimensions(DialogOptionsRenderingInfo *info)
{
  info.Width = 300;
  info.Height = 150;
}

crée une zone de 300×150 pour y afficher les options de dialogue.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : DialogOptionsRenderingInfo.Height

---

int DialogOptionsRenderingInfo.X;

Retourne/Définit la coordonnée horizontale du coin supérieur gauche de la zone d'options du dialogue.

Cette propriété ne peut être définie que dans la fonction dialog_options_get_dimensions, mais peut être consultée dans toutes les autres fonctions afin d'afficher les options.

Exemple :

function dialog_options_get_dimensions(DialogOptionsRenderingInfo *info)
{
  info.X = 50;
  info.Y = 20;
  info.Width = 200;
  info.Height = 150;
}

crée une surface de dimensions 200×150 à (50,20) pour y afficher les options du dialogue.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : DialogOptionsRenderingInfo.Y

---

int DialogOptionsRenderingInfo.Y;

Retourne/Définit la coordonnée verticale du coin supérieur gauche de la zone d'options du dialogue.

Cette propriété ne peut être définie que dans la fonction dialog_options_get_dimensions, mais peut être consultée dans toutes les autres fonctions afin d'afficher les options.

Exemple :

function dialog_options_get_dimensions(DialogOptionsRenderingInfo *info)
{
  info.X = 50;
  info.Y = 20;
  info.Width = 200;
  info.Height = 150;
}

crée une surface de dimensions 200×150 à (50,20) pour y afficher les options du dialogue.

Compatibilité : Supporté par AGS 3.1.0 et les versions plus récentes.

Voir aussi : DialogOptionsRenderingInfo.X