formContext.getControl (Informazioni di riferimento sulle API client)

Ottiene un controllo nel form.

Annotazioni

getControl funziona solo sui controlli nel corpo e nell'intestazione del modulo. Non è supportato per i controlli altrove nella pagina, anche se fanno riferimento alla stessa colonna.

• Per i controlli all'interno dei flussi dei processi aziendali, fare riferimento a tali controlli con il prefisso header_process_.
• I controlli all'interno di altri controlli, ad esempio sottogride e controlli sequenza temporale , non sono supportati.

Sintassi

formContext.getControl(arg);

Il metodo formContext.getControl(arg) è un metodo di scelta rapida per accedere a formContext.ui.controls.get.

Parametro

arg: facoltativo. È possibile accedere a un controllo in una maschera passando un argomento come nome o il valore di indice del controllo in una maschera. Ad esempio: formContext.getControl("firstname") o formContext.getControl(0). Se il arg nome è digitato in modo errato e non si trova nel form, restituisce un valore Null.

Quando il arg valore non viene specificato, restituisce una matrice di tutti i controlli nel form.

Valore restituito

Tipo: raccolta di oggetti, Oggetto o Null.

Descrizione: raccolta di oggetti se si utilizza il metodo senza parametri. Oggetto o null se si usa il metodo con un parametro . Se si usa il nome come parametro e sono presenti più controlli per la stessa colonna, viene restituito solo il primo controllo.

Suggerimento

Se si desidera modificare tutti i controlli associati a una colonna in una maschera, utilizzare l'insieme controls all'interno del tipo di colonna. Ad esempio, per aggiungere una notifica a ogni controllo associato alla name colonna, è possibile eseguire le operazioni seguenti:

 const notification = {
 messages: ['Sample Notification on Name Controls'],
 notificationLevel: 'RECOMMENDATION',
 uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));

Articoli correlati

formContext