Ovládacie prvky (odkaz na rozhranie API klienta)

V modelom riadených aplikáciách predstavuje ovládací prvok vo formulári prvok HTML. Niektoré ovládacie prvky sú viazané na konkrétny stĺpec, zatiaľ čo iné predstavujú neviazané ovládacie prvky, ako napríklad IFRAME, webový prostriedok alebo vedľajšiu mriežku pridanú do formulára.

Objekt ovládacieho prvku poskytuje metódy na zmenu prezentácie alebo správania ovládacieho prvku a identifikáciu príslušného stĺpca. Ovládacie prvky prístupu pomocou niektorej z nasledujúcich kolekcií:

  • ovládacie prvky formContext.ui.controls
  • Ovládacie prvky formContext.ui Section.controls
  • ovládacie prvky formContext.data.entityAttribute.controls

FormContext. metóda getControl je metóda odkazu na prístup k formContext.ui.controls.get.

Poznámka

Keď vykonávate akcie v ovládacích prvkoch, ktoré sú naviazané na stĺpec, zvážte, že ovládací prvok sa môže na strane zobraziť viackrát. Vo všeobecnosti by ste mali vykonávať rovnaké akcie pre každý ovládací prvok v stĺpci. Môžete cyklicky prechádzať kolekciou ovládacích prvkov stĺpcov a vykonávať akcie na každom ovládacom prvku.

Ovládacie prvky sú rozdelené do kategórií podľa typu. Na určenie typu ovládacieho prvku použite metódu getControlType . Určité metódy ovládacieho prvku sú k dispozícii iba pre konkrétne typy ovládacích prvkov.

Tento článok poskytuje informácie o metódach dostupných pre jednotlivé typy ovládacích prvkov.

Štandardný typ ovládacieho prvku

Tieto metódy sú k dispozícii pre štandardný ovládací prvok.

Metóda Description
addNotification (pridanie poznámok) Zobrazí chybu alebo odporúčanie s voliteľnými akciami.
clearNotification Odstráni oznámenie z ovládacieho prvku.
getAttribute Vráti stĺpec, na ktorý je ovládací prvok naviazaný.
getControlType Vráti typ ovládacieho prvku.
getDisabled Vráti, či je ovládací prvok zakázaný.
getLabel Vráti označenie ovládacieho prvku.
getName (názov) Vráti názov ovládacieho prvku.
getOutputs Vráti slovník výstupných vlastností ovládacieho prvku.
getParent (získať používateľa) Vráti sekciu, ktorá obsahuje ovládací prvok.
getVisible Vráti informáciu, či je ovládací prvok viditeľný.
setDisabled Zapína alebo vypína ovládací prvok.
setFocus (nastaviť zameranie) Presunie zameranie na ovládací prvok.
setLabel Zmení označenie ovládacieho prvku.
setNotification Zobrazí chybové hlásenie, ktoré indikuje, že údaje nie sú platné.
setVisible Zobrazí alebo skryje ovládací prvok.

Tieto metódy pre štandardné ovládanie sú zastarané: addOnKeyPress, fireOnKeyPress a removeOnKeyPress.

Typ ovládacieho prvku IFRAME

Tieto metódy sú k dispozícii pre ovládací prvok IFRAME.

Metóda Description
getContentWindow Vráti okno obsahu prvku IFRAME alebo webového zdroja.
getControlType Vráti typ ovládacieho prvku.
getDisabled Vráti, či je ovládací prvok zakázaný.
getInitialUrl Vráti predvolenú URL adresu nakonfigurovanú pre iframe.
getLabel Vráti označenie ovládacieho prvku.
getName (názov) Vráti názov ovládacieho prvku.
získaťObjekt Vráti objekt formulára, ktorý predstavuje objekt IFRAME alebo webový prostriedok.
getParent (získať používateľa) Vráti sekciu, ktorá obsahuje ovládací prvok.
getSrc Vráti URL adresu aktuálne zobrazenú v prvku IFRAME alebo webovom zdroji.
getVisible Vráti informáciu, či je ovládací prvok viditeľný.
setDisabled Zapína alebo vypína ovládací prvok.
setFocus (nastaviť zameranie) Presunie zameranie na ovládací prvok.
setLabel Zmení označenie ovládacieho prvku.
setSrc Nastaví URL adresu na zobrazenie v prvku IFRAME alebo webovom zdroji.
setVisible Zobrazí alebo skryje ovládací prvok.

Typ ovládacieho prvku Kbsearch (vyhľadávanie vedomostnej databázy)

Tieto metódy sú k dispozícii pre kontrolu vyhľadávania vedomostnej databázy.

Metóda Description
addOnPostSearch Pridá obsluhu udalosti, ktorá sa spustí po dokončení vyhľadávania.
addOnResultOpened Pridá obsluhu udalosti, ktorá sa spustí pri otvorení výsledku vyhľadávania.
pridanie výberu začiarknutie políčka Pridá obsluhu udalosti, ktorá sa spustí pri výbere výsledku vyhľadávania.
getControlType Vráti typ ovládacieho prvku.
getDisabled Vráti, či je ovládací prvok zakázaný.
getLabel Vráti označenie ovládacieho prvku.
getName (názov) Vráti názov ovládacieho prvku.
getParent (získať používateľa) Vráti sekciu, ktorá obsahuje ovládací prvok.
getSearchQuery Vráti text použitý ako kritériá vyhľadávania.
getSelectedResults Vráti aktuálne vybratý výsledok vyhľadávania.
getTotalResultCount Vráti počet výsledkov vyhľadávania.
getVisible Vráti informáciu, či je ovládací prvok viditeľný.
openSearchResult Otvorí zadaný výsledok vyhľadávania.
removeOnPostSearch Odstráni obsluhu udalostí na dokončenie vyhľadávania.
removeOnResultOpened Odstráni obsluhu udalosti na otvorenie výsledku vyhľadávania.
removeOnSelection Odstráni obsluhu udalostí na výber výsledku vyhľadávania.
setFocus (nastaviť zameranie) Presunie zameranie na ovládací prvok.
setLabel Zmení označenie ovládacieho prvku.
setSearchQuery Nastaví text použitý ako kritériá vyhľadávania.
setVisible Zobrazí alebo skryje ovládací prvok.

Poznámka

Keď pridáte ovládací prvok vyhľadávania vedomostnej databázy do sociálnej tably, názov ovládacieho prvku je searchwidgetcontrol_notescontrol. Tento názov nie je možné zmeniť.

Typ ovládacieho prvku vyhľadávania

Tieto metódy sú k dispozícii pre ovládací prvok vyhľadávania.

Metóda Description
addCustomFilter Pridá filter do výsledkov vyhľadávania v kombinácii s existujúcimi filtrami pomocou OPERÁTORA.
addCustomView Pridá zobrazenie do dialógového okna vyhľadávania.
addNotification (pridanie poznámok) Zobrazí chybu alebo odporúčanie s voliteľnými akciami.
pridanie položkyOnLookupTagClick Pridá obsluhu udalosti, ktorá sa spustí po kliknutí na značku vyhľadávania.
addPreSearch Pridá obsluhu udalosti, ktorá sa spustí pred vyhľadávaním vyhľadávania.
clearNotification Odstráni oznámenie z ovládacieho prvku.
getAttribute Vráti stĺpec, na ktorý je ovládací prvok naviazaný.
getControlType Vráti typ ovládacieho prvku.
getDefaultView Vráti ID predvoleného zobrazenia vyhľadávania.
getDisabled Vráti, či je ovládací prvok zakázaný.
getEntityTypes Vráti typy tabuľky povolené vo vyhľadávaní.
getLabel Vráti označenie ovládacieho prvku.
getName (názov) Vráti názov ovládacieho prvku.
getParent (získať používateľa) Vráti sekciu, ktorá obsahuje ovládací prvok.
getVisible Vráti informáciu, či je ovládací prvok viditeľný.
removeOnLookupTagClick Odstráni obsluhu udalostí na kliknutia so značkou vyhľadávania.
removePreSearch Odstráni obsluhu udalosti, ktorá sa spustí pred vyhľadávaním vyhľadávania.
setDefaultView Nastaví predvolené zobrazenie v dialógovom okne vyhľadávania.
setDisabled Zapína alebo vypína ovládací prvok.
setEntityTypes Nastaví typy tabuliek povolené vo vyhľadávaní.
setFocus (nastaviť zameranie) Presunie zameranie na ovládací prvok.
setLabel Zmení označenie ovládacieho prvku.
setNotification Zobrazí chybové hlásenie, ktoré indikuje, že údaje nie sú platné.
setVisible Zobrazí alebo skryje ovládací prvok.

Typy ovládacích prvkov v možnostiach a voľbe

Ovládacie prvky volieb a výberu majú k dispozícii rovnakú množinu metód.

Metóda Description
addNotification (pridanie poznámok) Zobrazí chybu alebo odporúčanie s voliteľnými akciami.
addOption (pridať možnosti) Pridá do ovládacieho prvku možnosť .
clearNotification Odstráni oznámenie z ovládacieho prvku.
clearOptions (vymazať možnosti) Odstráni všetky možnosti z ovládacieho prvku.
getAttribute Vráti stĺpec, na ktorý je ovládací prvok naviazaný.
getControlType Vráti typ ovládacieho prvku.
getDisabled Vráti, či je ovládací prvok zakázaný.
getLabel Vráti označenie ovládacieho prvku.
getName (názov) Vráti názov ovládacieho prvku.
získaťMožnosti Vráti dostupné možnosti vrátane prázdnej možnosti a vylúčenia odstránených možností.
getParent (získať používateľa) Vráti sekciu, ktorá obsahuje ovládací prvok.
getVisible Vráti informáciu, či je ovládací prvok viditeľný.
removeOption (OdstrániťMožnosť) Odstráni možnosť z ovládacieho prvku.
setDisabled Zapína alebo vypína ovládací prvok.
setFocus (nastaviť zameranie) Presunie zameranie na ovládací prvok.
setLabel Zmení označenie ovládacieho prvku.
setNotification Zobrazí chybové hlásenie, ktoré indikuje, že údaje nie sú platné.
setVisible Zobrazí alebo skryje ovládací prvok.

Typ ovládacieho prvku Rýchly formulár

Informácie o metódach podporovaných pre tento typ ovládacieho prvku nájdete v téme formContext.ui.quickForms .

Typ ovládacieho prvku Vedľajšia mriežka

Informácie o metódach podporovaných pre tento typ ovládacieho prvku nájdete v téme Mriežky a vedľajšie mriežky .

Typ ovládania nástenky časovej osi

Ovládací prvok časovej osi zobrazuje príspevky, aktivity a poznámky v jednotnom zobrazení. Tieto metódy sú k dispozícii pre tento typ ovládacieho prvku.

Metóda Description
getControlType Vráti typ ovládacieho prvku.
getDisabled Vráti, či je ovládací prvok zakázaný.
getLabel Vráti označenie ovládacieho prvku.
getName (názov) Vráti názov ovládacieho prvku.
getParent (získať používateľa) Vráti sekciu, ktorá obsahuje ovládací prvok.
getVisible Vráti informáciu, či je ovládací prvok viditeľný.
občerstviť Obnoví údaje zobrazené na časovej osi.
setDisabled Zapína alebo vypína ovládací prvok.
setFocus (nastaviť zameranie) Presunie zameranie na ovládací prvok.
setLabel Zmení označenie ovládacieho prvku.
setVisible Zobrazí alebo skryje ovládací prvok.

Typ ovládacieho prvku Časovač

Tieto metódy sú k dispozícii pre ovládací prvok časovača.

Metóda Description
getControlType Vráti typ ovládacieho prvku.
getDisabled Vráti, či je ovládací prvok zakázaný.
getLabel Vráti označenie ovládacieho prvku.
getName (názov) Vráti názov ovládacieho prvku.
getParent (získať používateľa) Vráti sekciu, ktorá obsahuje ovládací prvok.
getState (stav získať) Vráti aktuálny stav časovača.
getVisible Vráti informáciu, či je ovládací prvok viditeľný.
občerstviť Obnoví údaje zobrazené v časovači.
setDisabled Zapína alebo vypína ovládací prvok.
setFocus (nastaviť zameranie) Presunie zameranie na ovládací prvok.
setLabel Zmení označenie ovládacieho prvku.
setVisible Zobrazí alebo skryje ovládací prvok.

Typ ovládacieho prvku webového zdroja

Ovládací prvok webového zdroja má rovnakú množinu metód, ktoré sú k dispozícii ako ovládací prvok prvku iframe. Pozrite si typ ovládacieho prvku iframe.

Typ ovládacieho prvku súčasti formulára

Typ ovládacieho prvku súčasti formulára má rovnakú množinu metód, ktoré sú k dispozícii ako formContext v hlavnom formulári. Pozrite si tému Rozhranie API súčasti > formulára.

Stĺpce