Valdikliai (kliento API nuoroda)

Modeliu pagrįstose programose valdiklis nurodo formos HTML elementą. Kai kurie valdikliai susieti su konkrečiu stulpeliu, o kiti nurodo nesusietuosius valdiklius, pvz., IFRAME, žiniatinklio išteklius arba papildomą tinklelį, įtrauktą į formą.

Valdiklio objektas pateikia metodus, kaip pakeisti valdiklio pateiktį arba veikimą ir identifikuoti atitinkamą stulpelį. Prieigos valdikliai naudojant vieną iš šių rinkinių:

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

The formContext. getControl metodas yra spartusis būdas pasiekti formContext.ui.controls.get.

Pastaba.

Kai atliekate veiksmus su valdikliais, susietais su stulpeliu, apsvarstykite, kad valdiklis puslapyje gali būti rodomas daugiau nei vieną kartą. Paprastai turėtumėte atlikti tuos pačius veiksmus su kiekvienu stulpelio valdikliu. Galite peržiūrėti stulpelių valdiklių rinkinį ir atlikti veiksmus su kiekvienu valdikliu.

Valdikliai suskirstyti į kategorijas pagal tipą. Norėdami nustatyti valdiklio tipą, naudokite metodą getControlType . Tam tikri kontrolės metodai galimi tik tam tikriems valdiklių tipams.

Šiame straipsnyje pateikiama informacija apie kiekvieno valdiklio tipo galimus metodus.

Standartinis valdiklio tipas

Šiuos metodus galima naudoti standartiniame valdiklyje.

Metodas	Aprašas
addNotification	Rodo klaidos arba rekomendacijos pranešimą su pasirinktiniais veiksmais.
clearNotification	Pašalina pranešimą iš valdiklio.
getAttribute	Grąžina stulpelį, su kuriuo susietas valdiklis.
getControlType	Grąžina valdiklio tipą.
getDisabled	Grąžina, ar valdiklis išjungtas.
getLabel	Grąžina valdiklio žymą.
getName	Grąžina valdiklio pavadinimą.
getOutputs	Pateikia valdiklio išvesties ypatybių žodyną.
gautiParent	Grąžina sekciją, kurioje yra valdiklis.
getVisible	Grąžina, ar valdiklis matomas.
setDisabled	Įjungia arba išjungia valdiklį.
setFocus	Perkelia įvesties vietą į valdiklį.
setLabel	Keičia valdiklio žymą.
setNotification	Rodo klaidos pranešimą, nurodantį, kad duomenys neleistini.
setVisible	Rodomas arba paslepiamas valdiklis.

Toliau nurodyti standartinio valdiklio metodai yra nebenaudojami: addOnKeyPress, fireOnKeyPress ir removeOnKeyPress.

IFRAME valdiklio tipas

Šie metodai galimi IFRAME valdikliui.

Metodas	Aprašas
getContentWindow	Grąžina IFRAME arba žiniatinklio išteklių turinio langą.
getControlType	Grąžina valdiklio tipą.
getDisabled	Grąžina, ar valdiklis išjungtas.
getInitialUrl	Pateikia numatytąjį IFRAME sukonfigūruotą URL.
getLabel	Grąžina valdiklio žymą.
getName	Grąžina valdiklio pavadinimą.
getObject	Grąžina formos objektą, kuris nurodo IFRAME arba žiniatinklio išteklių.
gautiParent	Grąžina sekciją, kurioje yra valdiklis.
getSrc	Grąžina šiuo metu IFRAME arba žiniatinklio ištekliuje rodomą URL.
getVisible	Grąžina, ar valdiklis matomas.
setDisabled	Įjungia arba išjungia valdiklį.
setFocus	Perkelia įvesties vietą į valdiklį.
setLabel	Keičia valdiklio žymą.
setSrc	Nustato, kad URL būtų rodomas IFRAME arba žiniatinklio ištekliuje.
setVisible	Rodomas arba paslepiamas valdiklis.

Kbsearch (žinių bazės ieškos) valdiklio tipas

Šie metodai prieinami žinių bazės ieškos valdikliui.

Metodas	Aprašas
addOnPostSearch	Įtraukia įvykių apdorojimo programą, kuri vykdoma baigus iešką.
addOnResultOpened	Įtraukia įvykio apdorojimo programą, kuri paleidžiama, kai atidaromas ieškos rezultatas.
addOnSelection	Įtraukia įvykio apdorojimo programą, kuri paleidžiama pasirinkus ieškos rezultatą.
getControlType	Grąžina valdiklio tipą.
getDisabled	Grąžina, ar valdiklis išjungtas.
getLabel	Grąžina valdiklio žymą.
getName	Grąžina valdiklio pavadinimą.
gautiParent	Grąžina sekciją, kurioje yra valdiklis.
getSearchQuery	Grąžina tekstą, naudojamą kaip ieškos kriterijus.
getSelectedResults	Grąžina šiuo metu pasirinktą ieškos rezultatą.
getTotalResultCount	Grąžina ieškos rezultatų skaičių.
getVisible	Grąžina, ar valdiklis matomas.
openSearchResult	Atidaro nurodytą ieškos rezultatą.
removeOnPostSearch	Pašalina įvykio apdorojimo programą ieškai užbaigti.
removeOnResultOpened	Pašalina įvykio apdorojimo programą ieškos rezultatui atidaryti.
removeOnSelection	Pašalina įvykio apdorojimo programą ieškos rezultatui pasirinkti.
setFocus	Perkelia įvesties vietą į valdiklį.
setLabel	Keičia valdiklio žymą.
setSearchQuery	Nustato tekstą, naudojamą kaip ieškos kriterijus.
setVisible	Rodomas arba paslepiamas valdiklis.

Pastaba.

Kai įtraukiate žinių bazės ieškos valdiklį į socialinę sritį, valdiklio pavadinimas yra searchwidgetcontrol_notescontrol. Šio pavadinimo keisti negalite.

Peržvalgos valdiklio tipas

Šie metodai galimi peržvalgos valdikliui.

Metodas	Aprašas
addCustomFilter	Įtraukia filtrą į peržvalgos rezultatus, kartu su esamais filtrais, naudojant FUNKCIJĄ AND.
addCustomView	Įtraukia rodinį į peržvalgos dialogo langą.
addNotification	Rodo klaidos arba rekomendacijos pranešimą su pasirinktiniais veiksmais.
addOnLookupTagClick	Įtraukia įvykio apdorojimo programą, kuri paleidžiama spustelėjus peržvalgos žymę.
addPreSearch	Įtraukia įvykių apdorojimo programą, kuri paleidžiama prieš peržvalgos iešką.
clearNotification	Pašalina pranešimą iš valdiklio.
getAttribute	Grąžina stulpelį, su kuriuo susietas valdiklis.
getControlType	Grąžina valdiklio tipą.
getDefaultView	Grąžina numatytojo peržvalgos rodinio ID.
getDisabled	Grąžina, ar valdiklis išjungtas.
getEntityTypes	Grąžina peržvalgoje leidžiamus lentelių tipus.
getLabel	Grąžina valdiklio žymą.
getName	Grąžina valdiklio pavadinimą.
gautiParent	Grąžina sekciją, kurioje yra valdiklis.
getVisible	Grąžina, ar valdiklis matomas.
removeOnLookupTagClick	Pašalina peržvalgos žymių paspaudimų įvykio apdorojimo programą.
removePreSearch	Pašalina įvykių apdorojimo programą, kuri paleidžiama prieš peržvalgos iešką.
setDefaultView	Nustato numatytąjį rodinį peržvalgos dialogo lange.
setDisabled	Įjungia arba išjungia valdiklį.
setEntityTypes	Nustato peržvalgoje leidžiamus lentelių tipus.
setFocus	Perkelia įvesties vietą į valdiklį.
setLabel	Keičia valdiklio žymą.
setNotification	Rodo klaidos pranešimą, nurodantį, kad duomenys neleistini.
setVisible	Rodomas arba paslepiamas valdiklis.

Pasirinkimai ir pasirinkimo valdiklių tipai

Pasirinkimai ir pasirinkimo valdikliai turi tą patį galimų metodų rinkinį.

Metodas	Aprašas
addNotification	Rodo klaidos arba rekomendacijos pranešimą su pasirinktiniais veiksmais.
addOption	Įtraukia parinktį į valdiklį.
clearNotification	Pašalina pranešimą iš valdiklio.
clearOptions	Pašalina visas valdiklio parinktis.
getAttribute	Grąžina stulpelį, su kuriuo susietas valdiklis.
getControlType	Grąžina valdiklio tipą.
getDisabled	Grąžina, ar valdiklis išjungtas.
getLabel	Grąžina valdiklio žymą.
getName	Grąžina valdiklio pavadinimą.
getOptions	Pateikia galimas parinktis, įskaitant tuščią parinktį ir neįtraukiant pašalintų parinkčių.
gautiParent	Grąžina sekciją, kurioje yra valdiklis.
getVisible	Grąžina, ar valdiklis matomas.
removeOption	Pašalina parinktį iš valdiklio.
setDisabled	Įjungia arba išjungia valdiklį.
setFocus	Perkelia įvesties vietą į valdiklį.
setLabel	Keičia valdiklio žymą.
setNotification	Rodo klaidos pranešimą, nurodantį, kad duomenys neleistini.
setVisible	Rodomas arba paslepiamas valdiklis.

Sparčiosios formos valdiklio tipas

Informacijos apie šio tipo valdiklių palaikomus metodus ieškokite formContext.ui.quickForms .

Papildomo tinklelio valdiklio tipas

Informacijos apie šio tipo valdiklių palaikomus metodus žr. Tinkleliai ir papildomi tinkleliai .

Laiko planavimo juostos sienos valdiklio tipas

Laiko planavimo juostos valdiklis pateikia įrašus, veiklas ir pastabas bendrame rodinyje. Šie metodai galimi šiam valdiklio tipui.

Metodas	Aprašas
getControlType	Grąžina valdiklio tipą.
getDisabled	Grąžina, ar valdiklis išjungtas.
getLabel	Grąžina valdiklio žymą.
getName	Grąžina valdiklio pavadinimą.
gautiParent	Grąžina sekciją, kurioje yra valdiklis.
getVisible	Grąžina, ar valdiklis matomas.
Atnaujinti	Atnaujina laiko planavimo juostoje rodomus duomenis.
setDisabled	Įjungia arba išjungia valdiklį.
setFocus	Perkelia įvesties vietą į valdiklį.
setLabel	Keičia valdiklio žymą.
setVisible	Rodomas arba paslepiamas valdiklis.

Laikmačio valdiklio tipas

Šie būdai galimi laikmačio valdikliui.

Metodas	Aprašas
getControlType	Grąžina valdiklio tipą.
getDisabled	Grąžina, ar valdiklis išjungtas.
getLabel	Grąžina valdiklio žymą.
getName	Grąžina valdiklio pavadinimą.
gautiParent	Grąžina sekciją, kurioje yra valdiklis.
getState	Grąžina dabartinę laikmačio būseną.
getVisible	Grąžina, ar valdiklis matomas.
Atnaujinti	Atnaujina laikmačio rodomus duomenis.
setDisabled	Įjungia arba išjungia valdiklį.
setFocus	Perkelia įvesties vietą į valdiklį.
setLabel	Keičia valdiklio žymą.
setVisible	Rodomas arba paslepiamas valdiklis.

Žiniatinklio išteklių valdymo tipas

Žiniatinklio išteklių valdiklis turi tą patį metodų rinkinį, kurį galima naudoti kaip "iframe" valdiklis. Žr . "iframe" valdiklio tipą.

Formos komponento valdiklio tipas

Formos komponento valdiklio tipas turi tokį patį metodų rinkinį, kurį galima naudoti pagrindinės formos formContext . Žr . Formos komponento veikimas > Kliento API.

Susiję straipsniai

Stulpelius