Partager via


quickViewControl.getControl (référence de l’API client)

Obtient le contrôle dans un formulaire.

Syntaxe

quickViewControl.getControl(arg);

Paramètre

arg  : Facultatif. Vous pouvez accéder à un contrôle unique dans la collection de contrôles constitutifs en transmettant un argument comme étant le nom ou la valeur d’index du contrôle constitutif dans un contrôle d’aperçu. Par exemple : quickViewControl.getControl("firstname") ou quickViewControl.getControl(0)

Valeur renvoyée

Type : Objet ou collection d’objets.

Description : Objet si vous utilisez la méthode avec paramètre ; collection d’objets si vous utilisez la méthode sans paramètre.

Remarques

Après avoir récupéré un contrôle constitutif dans un contrôle d’aperçu, vous pouvez utiliser l’une des méthodes prises en charge pour un contrôle des applications basées sur un modèle sur le contrôle constitutif qui ne change pas les paramètres du contrôle constitutif. Cela découle du fait que les contrôles constitutifs dans un formulaire d’aperçu sont en lecture seule. Par exemple, vous pouvez utiliser :

quickViewControl.getControl(0).getAttribute()

Pour plus d’informations sur les méthodes prises en charge pour un contrôle, voir Contrôles.

Important

La méthode getAttribute ou n’importe quelle méthode associée aux données sur un contrôle constitutif peut ne pas fonctionner dans l’événement OnLoad du formulaire principal parce que le formulaire d’aperçu auquel il est lié peut ne pas s’être chargé complètement lorsque le formulaire principal s’est chargé. Vous devez utiliser la méthode isLoaded pour l’instance de contrôle d’aperçu pour déterminer si le formulaire d’aperçu s’est chargé complètement.

En outre, la façon de récupérer les contrôles constitutifs dans un contrôle d’aperçu sur des formulaires avec le nouveau moteur de rendu de formulaire est différente de celle des formulaires hérités. Ainsi, si vous utilisez les formulaires hérités et que vous avez du code qui cible des contrôles constitutifs dans un contrôle d’aperçu, vous devez mettre votre code à jour lorsque vous décidez d’utiliser le nouveau moteur de rendu de formulaire.

formContext.ui.quickForms

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).