Ajoute dynamiquement un item de menu à l'objet Menu. Le code L4G lié à l'activation (par un clic souris) de cet item doit être mis dans le pavé de l'événement ONCLICKDYNITEM. La propriété NOM_ITEM_DYN donne le nom de l'item activé.
Remarque : il n'est pas possible d'ajouter d'autres événements Javascript (ONXXX) autres que ONCLICK à un item ajouté dynamiquement.
Syntaxe | ||
APPELER_METHODE NomObjetMenu AJOUTER_ITEM_MENU NomObjetItemParent NomItem TypeItem LibelleItem TypeLibelle PositionAjout CodeRetour |
||
Paramètres | ||
ALPHA(128) NomObjetItemParent |
Nom de l'item père de l'item à ajouter. Pour l'ajouter au premier niveau, mettre la valeur *BLANK (paramètre en entrée). |
|
ALPHA(128) NomItem |
Nom de l'item de menu à ajouter (paramètre en entrée). Cette valeur doit être unique dans un objet Menu. |
|
NUM_BIN_2 TypeItem |
Type de l'item de menu (paramètre en entrée). Les valeurs possibles sont : 0 : Item, 1 : Séparateur ligne, 2 : Séparateur texte. |
|
ALPHA(128) LibelleItem |
Texte de l'item (paramètre en entrée). Cette valeur n'est pas prise en compte si TypeItem vaut 1 (séparateur ligne). |
|
NUM_BIN_2 TypeLibelle |
Type du libellé de l'item de menu (paramètre en entrée). Les valeurs possibles sont : 0 : Libellé texte, 1 : Libellé HTML 2 : Identification de balise. Dans ce cas, LibelleItem doit avoir la même valeur que l'attribut ID de la balise dont on veut insérer le contenu. Remarque : si TypeItem vaut 2, alors TypeLibelle doit avoir la valeur 0. |
|
NUM_BIN_2 PositionAjout |
Position de l'item à ajouter (paramètre en entrée). Les valeurs possibles pour la position sont : -1 : Ajout en fin, Un chiffre supérieur ou égal à 1 : Ajout en énième position. |
|
NUM_BIN_2 CodeRetour |
Code retour de l'opération (paramètre en sortie). Les valeurs possibles pour le code retour sont : 0 : L'opération s'est déroulée correctement, 1 : Une erreur interne s'est produite, 2 : La valeur du paramètre NomObjItemParent est incorrecte : il ne correspond à aucun item de menu ou à un item séparateur, 3 : Un item de même nom existe déjà dans l'objet Menu, 4 : La valeur du paramètre TypeItem est incorrecte, 5 : La valeur du paramètre PositionAjout est incorrecte, 6 : Le nombre de paramètres est incorrect (dans le cas d'un appel en dynamique de cette méthode), 7 : La valeur du paramètre TypeLibelle est incorrecte. |
|
Conditions d'utilisation | Aucune. |
Fixe la valeur d'une propriété graphique d'un item ajouté dynamiquement via la méthode AJOUTER_ITEM_MENU.
Remarque : Pour fixer une propriété graphique d'un item défini au maquettage d'un objet Menu , il est préférable d'utiliser la notation :
NOM_MENU[NOM_ITEM]:NOM_PROPRIETE = VALEUR
Syntaxe | ||
APPELER_METHODE NomObjetMenu FIXER_PROP_ITEM_MENU NomItem NomProp ValeurProp CodeRetour |
||
Paramètres | ||
ALPHA(128) NomItem |
Nom de l'item de menu dont on veut fixer la propriété (paramètre en entrée). |
|
ALPHA(128) NomProp |
Nom de la propriété dont on veut fixer la valeur (paramètre en entrée). Ces propriétés sont celles de l'objet ITEM MENU. |
|
NUM_BIN_2 | ALPHA(256) | BOOL ValeurProp |
Valeur de la propriété de nom NomProp (paramètre en entrée). |
|
NUM_BIN_2 CodeRetour |
Code retour de l'opération (paramètre en sortie). Les valeurs possibles pour le code retour sont : 0 : L'opération s'est déroulée correctement, 1 : Une erreur interne s'est produite, 2 : L'item de nom NomItem n'existe pas, 3 : La propriété de nom NomProp n'existe pas ou n'est pas accessible en écriture, 4 : La valeur ValeurProp n'est pas du bon type Adélia, 5 : Le nombre de paramètres est incorrect (dans le cas d'un appel en dynamique de cette méthode). |
|
Conditions d'utilisation | Aucune. |
Récupère la valeur d'une propriété graphique d'un item ajouté dynamiquement par la méthode AJOUTER_ITEM_MENU.
Remarque : Pour récupérer la valeur d'une propriété graphique d'un item défini au maquettage d'un objet Menu, il est préférable d'utiliser la notation :
VARIABLE = NOM_MENU[NOM_ITEM]:NOM_PROPRIETE
Syntaxe | ||
APPELER_METHODE NomObjetMenu RECUPERER_PROP_ITEM_MENU NomItem NomProp ValeurProp CodeRetour |
||
Paramètres | ||
ALPHA(128) NomItem |
Nom de l'item de menu dont on veut récupérer la propriété (paramètre en entrée). |
|
ALPHA(128) NomProp |
Nom de la propriété dont on veut récupérer la valeur (paramètre en entrée). Ces propriétés sont celles de l'objet ITEM MENU. |
|
NUM_BIN_2 | ALPHA(256) | BOOL ValeurProp |
Valeur de la propriété de nom NomProp (paramètre en sortie). |
|
NUM_BIN_2 CodeRetour |
Code retour de l'opération (paramètre en sortie). Les valeurs possibles pour le code retour sont : 0 : L'opération s'est déroulée correctement, 1 : Une erreur interne s'est produite. 2 : L'item de nom NomItem n'existe pas, 3 : La propriété de nom NomProp n'existe pas, 4 : La valeur ValeurProp n'est pas du bon type Adélia, 5 : Le nombre de paramètres est incorrect (dans le cas d'un appel en dynamique de cette méthode). |
|
Conditions d'utilisation | Aucune. |
Supprime un item de menu (et toute sa descendance) de l'objet Menu.
Syntaxe | ||
APPELER_METHODE NomObjetMenu SUPPRIMER_ITEM_MENU NomItem CodeRetour |
||
Paramètres | ||
ALPHA(128) NomItem |
Nom de l'item de menu à supprimer (paramètre en entrée). |
|
NUM_BIN_2 CodeRetour |
Code retour de l'opération (paramètre en sortie). Les valeurs possibles pour le code retour sont : 0 : L'opération s'est déroulée correctement, 1 : Une erreur interne s'est produite, 2 : L'item de nom NomItem n'existe pas, 3 : Le nombre de paramètres est incorrect (dans le cas d'un appel en dynamique de cette méthode). |
|
Conditions d'utilisation | Aucune. |