Vezérlők (ügyfél API-referencia)

A modellalapú alkalmazásokban a vezérlők az űrlap HTML-elemét jelölik. Egyes vezérlők egy adott oszlophoz vannak kötve, míg mások kötetlen vezérlőket jelölnek, például egy IFRAME-et, egy webes erőforrást vagy az űrlaphoz hozzáadott alhálózatot.

A vezérlőobjektum metódusokat biztosít a vezérlőelemek bemutatójának vagy viselkedésének módosításához és a megfelelő oszlop azonosításához. Hozzáférés-vezérlés az alábbi gyűjtemények egyikével:

  • formContext.ui.controls
  • formContext.ui Section.controls
  • formContext.data.entityAttribute.controls

A formContext. A getControl metódus a formContext.ui.controls.get parancsikonja.

Megjegyzés:

Ha oszlophoz kötött vezérlőkön hajt végre műveleteket, vegye figyelembe, hogy a vezérlő többször is megjelenhet az oldalon. Általában ugyanazokat a műveleteket kell végrehajtania az oszlop minden vezérlője esetében. Végigfuttathatja az oszlopvezérlők gyűjteményét , és végrehajthatja az egyes vezérlők műveleteit.

A vezérlők típus szerint vannak kategorizálva. A vezérlőelem típusának meghatározásához használja a getControlType metódust. Bizonyos vezérlési módszerek csak bizonyos típusú vezérlők esetén érhetők el.

Ez a cikk az egyes vezérlőtípusokhoz elérhető metódusokról nyújt tájékoztatást.

Standard vezérlőtípus

Ezek a metódusok standard vezérlőelemekhez érhetők el.

Method Description
addNotification Hiba- vagy javaslatértesítést jelenít meg opcionális műveletekkel.
clearNotification Eltávolít egy értesítést a vezérlőből.
getAttribute Azt az oszlopot adja vissza, amelyhez a vezérlőelem hozzá van kötve.
getControlType A vezérlő típusát adja vissza.
getDisabled Azt adja vissza, hogy a vezérlő le van-e tiltva.
getLabel A vezérlő címkéjét adja vissza.
getName A vezérlő nevét adja vissza.
getOutputs A vezérlőelem kimeneti tulajdonságainak szótárát adja vissza.
getParent A vezérlőelemet tartalmazó szakaszt adja vissza.
getVisible Azt adja vissza, hogy a vezérlő látható-e.
setDisabled Engedélyezi vagy letiltja a vezérlőt.
setFocus Fókusz áthelyezése a vezérlőre.
setLabel Módosítja a vezérlő címkéjét.
setNotification Hibaüzenetet jelenít meg, amely jelzi, hogy az adatok érvénytelenek.
setVisible Megjeleníti vagy elrejti a vezérlőt.

A Standard vezérlő alábbi módszerei elavultak: addOnKeyPress, fireOnKeyPress és removeOnKeyPress.

IFRAME-vezérlő típusa

Ezek a módszerek IFRAME-vezérlőkhöz érhetők el.

Method Description
getContentWindow Az IFRAME vagy a webes erőforrás tartalomablakát adja vissza.
getControlType A vezérlő típusát adja vissza.
getDisabled Azt adja vissza, hogy a vezérlő le van-e tiltva.
getInitialUrl Az IFRAME-hez konfigurált alapértelmezett URL-címet adja vissza.
getLabel A vezérlő címkéjét adja vissza.
getName A vezérlő nevét adja vissza.
getObjektum Az IFRAME-t vagy a webes erőforrást képviselő űrlapobjektumot adja vissza.
getParent A vezérlőelemet tartalmazó szakaszt adja vissza.
getSrc Az IFRAME-ben vagy a webes erőforrásban jelenleg megjelenített URL-címet adja vissza.
getVisible Azt adja vissza, hogy a vezérlő látható-e.
setDisabled Engedélyezi vagy letiltja a vezérlőt.
setFocus Fókusz áthelyezése a vezérlőre.
setLabel Módosítja a vezérlő címkéjét.
setSrc Beállítja az URL-címet, hogy megjelenjen az IFRAME-ben vagy a webes erőforrásban.
setVisible Megjeleníti vagy elrejti a vezérlőt.

Kbsearch (tudásbázis-keresés) vezérlőtípus

Ezek a módszerek a tudásbázis keresési vezérlőihez érhetők el.

Method Description
addOnPostSearch Hozzáad egy eseménykezelőt, amely a keresés befejezése után fut.
addOnResultOpened Hozzáad egy eseménykezelőt, amely egy keresési eredmény megnyitásakor fut.
addOnSelection Hozzáad egy eseménykezelőt, amely a keresési eredmény kiválasztásakor fut.
getControlType A vezérlő típusát adja vissza.
getDisabled Azt adja vissza, hogy a vezérlő le van-e tiltva.
getLabel A vezérlő címkéjét adja vissza.
getName A vezérlő nevét adja vissza.
getParent A vezérlőelemet tartalmazó szakaszt adja vissza.
getSearchQuery A keresési feltételként használt szöveget adja vissza.
getSelectedResults Az aktuálisan kiválasztott keresési eredményt adja vissza.
getTotalResultCount A keresési eredmények számát adja vissza.
getVisible Azt adja vissza, hogy a vezérlő látható-e.
openSearchResult Megnyitja a megadott keresési eredményt.
removeOnPostSearch Eltávolít egy eseménykezelőt a keresés befejezéséhez.
removeOnResultOpened Eltávolít egy eseménykezelőt a keresési eredmények megnyitásához.
removeOnSelection Eltávolít egy eseménykezelőt a keresési eredmény kiválasztásához.
setFocus Fókusz áthelyezése a vezérlőre.
setLabel Módosítja a vezérlő címkéjét.
setSearchQuery Beállítja a keresési feltételként használt szöveget.
setVisible Megjeleníti vagy elrejti a vezérlőt.

Megjegyzés:

Amikor hozzáadja a tudásbázis keresési vezérlőt a közösségi panelhez, a vezérlő neve .searchwidgetcontrol_notescontrol Ezt a nevet nem lehet megváltoztatni.

Keresési vezérlő típusa

Ezek a metódusok keresési vezérlőkhöz érhetők el.

Method Description
addCustomFilter Szűrőt ad hozzá a keresési eredményekhez, a meglévő szűrőkkel kombinálva az AND használatával.
addCustomView Nézetet ad hozzá a keresési párbeszédpanelhez.
addNotification Hiba- vagy javaslatértesítést jelenít meg opcionális műveletekkel.
addOnLookupTagClick Hozzáad egy eseménykezelőt, amely akkor fut, amikor egy keresési címkére kattint.
addPreSearch Egy keresési keresés előtt futó eseménykezelőt ad hozzá.
clearNotification Eltávolít egy értesítést a vezérlőből.
getAttribute Azt az oszlopot adja vissza, amelyhez a vezérlőelem hozzá van kötve.
getControlType A vezérlő típusát adja vissza.
getDefaultView Az alapértelmezett keresési nézet azonosítóját adja vissza.
getDisabled Azt adja vissza, hogy a vezérlő le van-e tiltva.
getEntityTypes A keresésben engedélyezett táblatípusokat adja vissza.
getLabel A vezérlő címkéjét adja vissza.
getName A vezérlő nevét adja vissza.
getParent A vezérlőelemet tartalmazó szakaszt adja vissza.
getVisible Azt adja vissza, hogy a vezérlő látható-e.
removeOnLookupTagClick Eltávolít egy eseménykezelőt a keresési címkék kattintásaihoz.
removePreSearch Eltávolít egy keresési keresés előtt futó eseménykezelőt.
setDefaultView Beállítja az alapértelmezett nézetet a keresési párbeszédpanelen.
setDisabled Engedélyezi vagy letiltja a vezérlőt.
setEntityTypes Beállítja a keresésben engedélyezett táblázattípusokat.
setFocus Fókusz áthelyezése a vezérlőre.
setLabel Módosítja a vezérlő címkéjét.
setNotification Hibaüzenetet jelenít meg, amely jelzi, hogy az adatok érvénytelenek.
setVisible Megjeleníti vagy elrejti a vezérlőt.

Választási lehetőségek és választási lehetőségek vezérlőtípusai

A választási lehetőségek és a választási lehetőségek vezérlői ugyanazokat a módszereket használhatják.

Method Description
addNotification Hiba- vagy javaslatértesítést jelenít meg opcionális műveletekkel.
addOption Hozzáad egy lehetőséget a vezérlőhöz.
clearNotification Eltávolít egy értesítést a vezérlőből.
clearOptions Eltávolítja az összes beállítást a vezérlőből.
getAttribute Azt az oszlopot adja vissza, amelyhez a vezérlőelem hozzá van kötve.
getControlType A vezérlő típusát adja vissza.
getDisabled Azt adja vissza, hogy a vezérlő le van-e tiltva.
getLabel A vezérlő címkéjét adja vissza.
getName A vezérlő nevét adja vissza.
getOptions Az elérhető beállításokat adja vissza, beleértve az üres beállítást, és kizárja az eltávolított beállításokat.
getParent A vezérlőelemet tartalmazó szakaszt adja vissza.
getVisible Azt adja vissza, hogy a vezérlő látható-e.
removeOption Eltávolít egy lehetőséget a vezérlőből.
setDisabled Engedélyezi vagy letiltja a vezérlőt.
setFocus Fókusz áthelyezése a vezérlőre.
setLabel Módosítja a vezérlő címkéjét.
setNotification Hibaüzenetet jelenít meg, amely jelzi, hogy az adatok érvénytelenek.
setVisible Megjeleníti vagy elrejti a vezérlőt.

Gyors űrlapvezérlő típusa

Az ehhez a vezérlőtípushoz támogatott metódusokról a formContext.ui.quickForms című témakörben olvashat.

Alhálózati vezérlő típusa

Az ehhez a vezérlőtípushoz támogatott módszerekről további információt a Rácsok és alhálózatok című témakörben talál.

Ütemterv falvezérlő típusa

Az ütemterv vezérlőelem egységes nézetben jeleníti meg a bejegyzéseket, tevékenységeket és jegyzeteket. Ezek a metódusok ehhez a vezérlőtípushoz érhetők el.

Method Description
getControlType A vezérlő típusát adja vissza.
getDisabled Azt adja vissza, hogy a vezérlő le van-e tiltva.
getLabel A vezérlő címkéjét adja vissza.
getName A vezérlő nevét adja vissza.
getParent A vezérlőelemet tartalmazó szakaszt adja vissza.
getVisible Azt adja vissza, hogy a vezérlő látható-e.
felfrissít Frissíti az ütemtervben megjelenített adatokat.
setDisabled Engedélyezi vagy letiltja a vezérlőt.
setFocus Fókusz áthelyezése a vezérlőre.
setLabel Módosítja a vezérlő címkéjét.
setVisible Megjeleníti vagy elrejti a vezérlőt.

Időzítő vezérlőelem típusa

Ezek a metódusok az időzítő vezérlőelemhez érhetők el.

Method Description
getControlType A vezérlő típusát adja vissza.
getDisabled Azt adja vissza, hogy a vezérlő le van-e tiltva.
getLabel A vezérlő címkéjét adja vissza.
getName A vezérlő nevét adja vissza.
getParent A vezérlőelemet tartalmazó szakaszt adja vissza.
getState Az időzítő aktuális állapotát adja vissza.
getVisible Azt adja vissza, hogy a vezérlő látható-e.
felfrissít Frissíti az időzítőben megjelenített adatokat.
setDisabled Engedélyezi vagy letiltja a vezérlőt.
setFocus Fókusz áthelyezése a vezérlőre.
setLabel Módosítja a vezérlő címkéjét.
setVisible Megjeleníti vagy elrejti a vezérlőt.

Webes erőforrás-vezérlés típusa

A webes erőforrás-vezérlők ugyanazokkal a metódusokkal rendelkezik, mint az iframe-vezérlő. Lásd az iframe vezérlő típusát.

Űrlapösszetevő vezérlőtípusa

Az űrlapösszetevő-vezérlők típusa ugyanazokkal a metódusokkal rendelkezik, mint a főűrlap űrlapkontextje . Lásd : Űrlapösszetevő viselkedésének > ügyfél API-ja.

Oszlopok