Zone de liste déroulante

Le contrôle Zone de liste déroulante (Combo Box) permet de créer une liste déroulante pouvant générer et exécuter un script R ou Python for Spark propre à l'élément de liste sélectionné. Il est limité à une sélection unique. Le contrôle Zone de liste déroulante possède les propriétés suivantes :

Identificateur. Identificateur unique du contrôle. Identificateur à utiliser pour référencer le contrôle dans le modèle de script.

Titre. Titre facultatif qui apparaît au-dessus du contrôle. Pour les titres comportant plusieurs lignes, utilisez \n pour indiquer les sauts de ligne.

Position du titre. Indique la position du titre du contrôle. Les valeurs sont Top (Haut) et Left (Gauche) (Top est la valeur par défaut).

Infobulle. Texte d'infobulle facultatif qui apparaît lorsque l'utilisateur survole le contrôle.

Eléments de liste. Cliquez sur le bouton des points de suspension (...) pour ouvrir la boîte de dialogue Propriétés des éléments de la liste , qui permet de spécifier les éléments de liste du contrôle. Vous pouvez aussi ouvrir la boîte de dialogue Propriétés des éléments de liste en double-cliquant sur le contrôle Zone de liste déroulante sur le canevas.

Touche mnémonique. Caractère facultatif dans le titre à utiliser comme raccourci clavier pour activer le contrôle. Il est souligné dans le titre. Le raccourci est activé en appuyant sur Alt+[touche mnémonique].

Modifiable. Indique si le contrôle Zone de liste déroulante est modifiable. Lorsque le contrôle est modifiable, une valeur personnalisé peut être entrée au moment de l'exécution.

Script. Spécifie le script R ou Python for Spark généré par ce contrôle lors de l'exécution. Peut être inséré dans le modèle de script.

La valeur %%ThisValue%% spécifie la valeur d'exécution du contrôle. Elle est utilisée par défaut. Si les éléments de liste sont définis manuellement, la valeur d'exécution est la valeur de la propriété Script de l'élément de liste sélectionné. Si les éléments de liste sont basés sur un contrôle de liste cible, la valeur d'exécution est la valeur de l'élément de liste sélectionné. Pour des contrôles de zone de liste à sélection multiple, la valeur d'exécution est une liste séparée par des espaces des éléments sélectionnés. Pour plus d'informations, voir la rubrique Spécification d'éléments de liste pour les zones de liste déroulante et les zones de liste.

Vous pouvez spécifier tout script R ou Python for Spark valide. Pour les scripts multilignes ou les scripts longs, cliquez sur le bouton des points de suspension (...) et entrez votre script dans la boîte de dialogue Propriétés de script.

Gestion des guillemets. Définit la gestion des guillemets dans la valeur d'exécution de %%ThisValue%% lorsque la propriété Script contient %%ThisValue%% dans la chaîne entre guillemets. Dans ce contexte, une chaîne entre guillemets est une chaîne située entre apostrophes ou doubles apostrophes. La gestion des guillemets s'applique uniquement aux apostrophes qui sont identiques aux apostrophes qui entourent %%ThisValue%%. Les types de gestion de guillemets disponibles sont les suivants :

Python: Les apostrophes présentes dans la valeur d'exécution de %%ThisValue%% qui sont similaires aux apostrophes fermantes sont associées au caractère d'échappement barre oblique inversée (\). Par exemple, si la propriété Script est '%%ThisValue%%' et que la valeur d'exécution de la zone de liste déroulante est Valeur d'apostrophe, le script généré est 'Valeur d\'apostrophe'. Notez qu'il n'y a pas de gestion des apostrophes si %%ThisValue%% est placé entre des apostrophes triplées.
R: Les apostrophes présentes dans la valeur d'exécution de %%ThisValue%% qui sont similaires aux apostrophes fermantes sont associées au caractère d'échappement barre oblique inversée (\). Par exemple, si la propriété Script est '%%ThisValue%%' et que la valeur d'exécution de la zone de liste déroulante est Valeur d'apostrophe, le script généré est 'Valeur d\'apostrophe'.
Aucun (None): Les apostrophes présentes dans la valeur d'exécution de %%ThisValue%% qui sont similaires aux apostrophes fermantes sont conservées sans aucune modification.

Règle d'activation. Indique une règle qui détermine le moment auquel le contrôle en cours est activé. Cliquez sur le bouton des points de suspension (...) pour ouvrir la boîte de dialogue Règle d'activation et spécifier la règle. La propriété Règle d'activation n'est visible que si d'autres contrôles qui peuvent être utilisés pour spécifier une règle d'activation existent sur le canevas.