sm_cmd_opt (option de commande SMIT dialog/selector), classe d'objets

Editer en ligne

Chaque objet d'une boîte de dialogue, à l'exception de l'objet d'en-tête de boîte de dialogue, correspond normalement à un indicateur, une option ou un attribut de la commande exécutée par la boîte de dialogue.

Un ou plusieurs de ces objets sont créés pour chaque boîte de dialogue SMIT ; une boîte de dialogue fantôme peut ne pas être associée à des objets d'option de commande de boîte de dialogue. Chaque écran de sélection est composé d'un objet d'en-tête de sélecteur et d'un objet d'option de commande de sélecteur.

Remarque: lors du codage d'un objet dans cette classe d'objets, définissez les chaînes vides inutilisées sur""(guillemets) et les zones d'entier non utilisées pour0.

L'objet d'option de commande de boîte de dialogue et l'objet d'option de commande de sélecteur sont tous deux des objets sm_cmd_opt . Les descripteurs de la classe d'objets sm_cmd_opt et de leurs fonctions sont les suivants:

Descripteur	Fonction
id	ID ou nom de l'objet. L' ID de l'objet d'en-tête de boîte de dialogue ou de sélecteur associé peut être utilisé comme chemin d'accès rapide à cet objet de boîte de dialogue et à d'autres objets de boîte de dialogue dans la boîte de dialogue. La valeur de id est une chaîne d'une longueur maximale de 64 caractères. Tous les objets de boîte de dialogue qui apparaissent dans une boîte de dialogue doivent avoir le même ID. En outre, les ID doivent être uniques pour votre application et uniques dans la base de données SMIT particulière utilisée.
num_seq_id	Position de cet élément par rapport à d'autres éléments de la boîte de dialogue ; les objets sm_cmd_opt d'une boîte de dialogue sont triés sur cette zone de chaîne. La valeur de id_seq_num est une chaîne d'une longueur maximale de 16 caractères. Lorsque cet objet fait partie d'un écran de boîte de dialogue, la chaîne`"0"`n'est pas une valeur valide pour cette zone. Lorsque cet objet fait partie d'un écran de sélecteur, le descripteur id_seq_num doit être défini sur 0.
nom_zone_disc	Chaîne qui doit correspondre à l'une des zones de nom dans la sortie de la commande cmd_to_discover dans l'en-tête de boîte de dialogue associée. La valeur de disc_field_name est une chaîne d'une longueur maximale de 64 caractères. La valeur du descripteur disc_field_name peut être définie à l'aide du nom brut ou cuit d'un sélecteur précédent au lieu de la commande cmd_to_discover dans l'objet d'en-tête associé. Si le descripteur est défini avec l'entrée d'un sélecteur précédent, il doit être défini sur l'une des valeurs suivantes:`"_rawname"`ou`"_cookedname"`, ou à la`sm_name_hdr.cooked_field_name`valeur ou`sm_name_hdr.raw_field_name`valeur si elle a été utilisée pour redéfinir le nom par défaut.
nom	Chaîne qui apparaît sur la boîte de dialogue ou sur l'écran de sélection comme nom de zone. Il s'agit de l'interrogation visuelle ou de la partie d'invite de l'objet, d'une description en langage naturel d'un indicateur, d'une option ou d'un paramètre de la commande indiquée dans le`cmd_to_exec`de l'objet d'en-tête de boîte de dialogue associé. La valeur de name est une chaîne d'une longueur maximale de 1024 caractères.
fichier_msg_nom	Le nom de fichier (et non le nom de chemin d'accès complet) qui est le catalogue de la fonction de messagerie pour la chaîne, name. La valeur de name_msg_file est une chaîne d'une longueur maximale de 1024 caractères. Les catalogues de messages requis par un programme d'application peuvent être développés avec la fonction de messagerie. Définir sur`""`(chaîne vide) s'il n'est pas utilisé.
nom_msg_set	ID d'ensemble de la fonction de messagerie pour la chaîne name. La valeur de name_msg_set est un entier. Définir sur`0`s'il n'est pas utilisé.
id_msg_nom	ID message de la fonction de message pour la chaîne, name. La valeur de name_msg_id est un entier. Définir sur`0`s'il n'est pas utilisé.
type_opération	Type d'opération auxiliaire pris en charge pour cette zone. La valeur de op_type est une chaîne. Les valeurs valides sont : "" ou "n" -C'est le cas par défaut. Aucune opération auxiliaire (sélection de liste ou d'anneau) n'est prise en charge pour cette zone. "l" -Opération de sélection de liste fournie. Une fenêtre en incrustation affiche la liste des éléments générés par l'exécution de la commande dans la`cmd_to_list`zone de cet objet lorsque l'utilisateur sélectionne la fonction F4=List de l'interface SMIT. "r" -Opération de sélection de l'anneau fournie. La chaîne dans le`disp_values`ou`aix_values`est interprété comme un ensemble délimité par des virgules d'entrées valides. L'utilisateur peut tabulation ou tabulation arrière à travers ces valeurs pour effectuer une sélection. En outre, la fonction d'interface F4=List peut être utilisée dans ce cas, car SMIT transforme l'anneau en liste selon les besoins. Les valeurs`"N"`,`"L"`et`"R"`peuvent être utilisées comme valeurs op_type tout comme les valeurs en minuscules`"n"`,`"l"`et`"r"`. Toutefois, avec les valeurs en majuscules, si la commande cmd_to_exec est exécutée et est renvoyée avec la valeur de sortie suivante:`0`, puis la zone d'entrée correspondante sera effacée pour devenir une chaîne vide.
type_entrée	Type de valeur requis par la zone de saisie. La valeur de entry_type est une chaîne. Les valeurs valides sont : "" ou "n" -Aucune entrée ; la valeur en cours ne peut pas être modifiée via le type-in direct. La zone est fournie à titre d'information uniquement. "t" -Entrée de texte ; une entrée alphanumérique peut être entrée. " #" -Entrée numérique ; seuls les caractères numériques`0`,`1`,`2`,`3`,`4`,`5`,`6`,`7`,`8`ou`9`peuvent être entrés. A`-`(signe moins) ou`+`(signe plus) peut être entré comme premier caractère. "x" -Entrée hexadécimale ; seule l'entrée hexadécimale peut être entrée. "f" -Entrée de fichier ; un nom de fichier doit être saisi. "r" -Entrée de texte brut ; une entrée alphanumérique peut être entrée. Les espaces de début et de fin sont considérés comme significatifs et ne sont pas supprimés de la zone.
taille_entrée	Limite le nombre de caractères que l'utilisateur peut entrer dans la zone de saisie. La valeur de entry_size est un entier. Une valeur de`0`La valeur par défaut est la taille maximale autorisée.
requis	Définit si une zone de commande doit être envoyée à la commande cmd_to_exec définie dans l'objet d'en-tête de boîte de dialogue associé. La valeur de required est une chaîne. Si l'objet fait partie d'un écran de sélection, le`required`la zone doit normalement être définie sur`""`(chaîne vide). Si l'objet fait partie d'un écran de boîte de dialogue, les valeurs valides sont les suivantes: "" ou "n" -Non ; l'option est ajoutée à la chaîne de commande dans la commande cmd_to_exec uniquement si l'utilisateur modifie la valeur initialement affichée. Il s'agit du cas par défaut. "y" -Oui ; la valeur de`prefix`et la valeur de la zone d'entrée sont toujours envoyées à la commande cmd_to_exec . "+" -Valeur de la`prefix`et la valeur de la zone d'entrée sont toujours envoyées à la commande cmd_to_exec . La zone de saisie doit contenir au moins un caractère non blanc. SMIT n'autorise pas l'utilisateur à exécuter la tâche tant que cette condition n'est pas remplie. "?" -Sauf lorsqu'il est vide ; la valeur de`prefix`et la valeur de la zone d'entrée est envoyée à la`cmd_to_exec`à moins que la zone d'entrée ne soit vide.
préfixe	Dans le cas le plus simple, définit l'indicateur à envoyer avec la valeur de la zone d'entrée à la commande cmd_to_exec définie dans l'objet d'en-tête de boîte de dialogue associé. La valeur de prefix est une chaîne d'une longueur maximale de 1024 caractères. L'utilisation de cette zone dépend de la valeur de la`required`, le contenu de la zone`prefix`et le contenu de la zone associée`entry`:NONE. Remarque: Si le`prefix`La zone est définie sur`—`(tiret tiret), le contenu de la zone d'entrée associée est ajouté à la fin de la commande cmd_to_exec . Si la commande`prefix`La zone est définie sur`—'`(tiret guillemet simple), le contenu de la zone d'entrée associée est ajouté à la fin de la commande cmd_to_exec entre guillemets simples.
cmd_to_list_mode	Définit la quantité d'un élément d'une liste à utiliser. La liste est générée par la commande indiquée dans l'objet`cmd_to_list`:NONE. La valeur de cmd_to_list_mode est une chaîne d'une longueur maximale de 1 caractère. Les valeurs valides sont : "" ou "a" -Permet d'obtenir toutes les zones. Il s'agit du cas par défaut. "1" -Obtient la première zone. "2" -Obtient la deuxième zone. "r" -Plage ; exécution de la chaîne de commande dans la`cmd_to_list`renvoie une plage (telle que 1..99) au lieu d'une liste. Les plages sont fournies à titre d'information uniquement ; elles sont affichées dans une liste en incrustation, mais ne modifient pas la zone d'entrée associée.
cmd_à_liste	Chaîne de commande utilisée pour obtenir une liste de valeurs valides pour la zone de valeur. La valeur de cmd_to_list est une chaîne d'une longueur maximale de 1024 caractères. Cette commande doit générer des valeurs séparées par`\n`(nouvelle ligne).
cmd_to_list_postfix	Suffixe à interpréter et à ajouter à la chaîne de commande spécifiée dans le`cmd_to_list`de l'objet de boîte de dialogue. La valeur de cmd_to_list_postfix est une chaîne d'une longueur maximale de 1024 caractères. Si la première ligne commence par`#`(signe dièse) après un espace, cette entrée sera rendue non sélectionnable. Cela est utile pour les en-têtes de colonne. Lignes suivantes commençant par un`#`, éventuellement précédés d'espaces, sont traités comme un commentaire et comme une continuation de l'entrée précédente.
sélection multiple	Définit si l'utilisateur peut effectuer plusieurs sélections à partir d'une liste de valeurs valides produites par la commande dans le`cmd_to_list`de l'objet de boîte de dialogue. La valeur de multi_select est une chaîne. Les valeurs valides sont : "" -Non ; un utilisateur ne peut sélectionner qu'une seule valeur dans une liste. Il s'agit du cas par défaut. "," -Oui ; un utilisateur peut sélectionner plusieurs éléments dans la liste. Lorsque la commande est générée, une virgule est insérée entre chaque élément. "y" -Oui ; un utilisateur peut sélectionner plusieurs valeurs dans la liste. Lorsque la commande est générée, le préfixe d'option est inséré une fois avant la chaîne des éléments sélectionnés. "m" -Oui ; un utilisateur peut sélectionner plusieurs éléments dans la liste. Lorsque la commande est générée, le préfixe d'option est inséré avant chaque élément sélectionné.
index_valeur	Pour un anneau d'option, l'indice d'origine zéro dans le tableau de`disp_value`zones. Le nombre value_index indique la valeur affichée par défaut dans la zone d'entrée pour l'utilisateur. La valeur de entry_size est un entier.
valeurs-disp	Tableau de valeurs valides dans un anneau d'option à présenter à l'utilisateur. La valeur de la`disp_values`est une chaîne d'une longueur maximale de 1024 caractères. Les valeurs de zone sont séparées par des , (virgules) sans espaces avant ou après les virgules.
fichier_msg_valeurs	Le nom de fichier (et non le nom de chemin d'accès complet) qui est le catalogue de la fonction de messagerie pour les valeurs de la`disp_values`si les valeurs sont initialisées au moment du développement. La valeur de la`values_msg_file`est une chaîne d'une longueur maximale de 1024 caractères. Les catalogues de messages requis par un programme d'application peuvent être développés avec la fonction de messagerie.
valeurs_msg_set	ID d'ensemble de la fonction de messagerie pour les valeurs de la`disp_values`zones. Définissez la valeur sur 0 s'il n'est pas utilisé.
id_msg_valeurs	ID message de la fonction de messagerie pour les valeurs de la`disp_values`zones. Définissez la valeur sur 0 s'il n'est pas utilisé.
Valeurs d'aix	Pour un anneau d'options, un tableau de valeurs spécifié de sorte que chaque élément corresponde à l'élément du tableau disp_values à la même position ; à utiliser si les valeurs en langage naturel dans disp_values ne sont pas les options réelles à utiliser pour la commande. La valeur de la`aix_values`est une chaîne d'une longueur maximale de 1024 caractères.
id_msg_aide	Indique un numéro d'ensemble de messages Message Facility et un numéro d'ID message avec une virgule comme séparateur ou une chaîne numérique égale à une balise d'identificateur SMIT.
help_msg_loc	Nom de fichier envoyé en tant que paramètre à la commande man pour l'extraction du texte d'aide ou nom de fichier d'un fichier contenant du texte d'aide. La valeur de help_msg_loc est une chaîne d'une longueur maximale de 1024 caractères.
help_msg_base	Nom de chemin qualifié complet d'une bibliothèque que SMIT lit pour les noms de fichier associés au livre correct.
livre_aide	Contient la chaîne avec la valeur du fichier de nom contenu dans la bibliothèque de fichiers indiquée par help_msg_base.