Besturingselementen (client-API-verwijzing)

In modelgestuurde apps vertegenwoordigt een besturingselement een HTML-element in het formulier. Sommige besturingselementen zijn gebonden aan een specifieke kolom, terwijl andere niet-afhankelijke besturingselementen, zoals een IFRAME, webresource of subraster die aan het formulier zijn toegevoegd, vertegenwoordigen.

Het besturingsobject biedt methoden om de presentatie of het gedrag van een besturingselement te wijzigen en de bijbehorende kolom te identificeren. Toegangsbeheer met behulp van een van de volgende verzamelingen:

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

De formContext. de methode getControl is een snelkoppelingsmethode voor toegang tot formContext.ui.controls.get.

Opmerking

Wanneer u acties uitvoert op besturingselementen die zijn gekoppeld aan een kolom, moet u er rekening mee houden dat het besturingselement meerdere keren op de pagina kan worden weergegeven. Over het algemeen moet u dezelfde acties uitvoeren voor elk besturingselement voor de kolom. U kunt de verzameling kolombesturingselementen doorlopen en de acties op elk besturingselement uitvoeren.

Besturingselementen worden gecategoriseerd op type. Gebruik de methode getControlType om het type besturingselement te bepalen. Bepaalde besturingsmethoden zijn alleen beschikbaar voor specifieke typen besturingselementen.

Dit artikel bevat informatie over de methoden die beschikbaar zijn voor elk type besturingselement.

Standaard besturingselementtype

Deze methoden zijn beschikbaar voor een standaard besturingselement.

Method Description
addNotification Geeft een fout- of aanbevelingsmelding weer met optionele acties.
clearNotification Hiermee verwijdert u een melding uit het besturingselement.
getAttribute Retourneert de kolom waaraan het besturingselement is gebonden.
getControlType Retourneert het type besturingselement.
getDisabled Retourneert of het besturingselement is uitgeschakeld.
getLabel Retourneert het label van het besturingselement.
getName Retourneert de naam van het besturingselement.
getOutputs Retourneert een woordenlijst van de uitvoereigenschappen van het besturingselement.
getParent Retourneert de sectie die het besturingselement bevat.
getVisible Retourneert of het besturingselement zichtbaar is.
setDisabled Hiermee schakelt u het besturingselement in of uit.
setFocus Hiermee verplaatst u de focus naar het besturingselement.
setLabel Hiermee wijzigt u het label van het besturingselement.
setNotification Geeft een foutbericht weer om aan te geven dat gegevens niet geldig zijn.
setVisible Hiermee wordt het besturingselement weergegeven of verborgen.

De volgende methoden voor het standaardbesturingselement zijn afgeschaft: addOnKeyPress, fireOnKeyPress en removeOnKeyPress.

Type IFRAME-besturingselement

Deze methoden zijn beschikbaar voor een IFRAME-besturingselement.

Method Description
getContentWindow Retourneert het inhoudsvenster van het IFRAME of de webresource.
getControlType Retourneert het type besturingselement.
getDisabled Retourneert of het besturingselement is uitgeschakeld.
getInitialUrl Retourneert de standaard-URL die is geconfigureerd voor het IFRAME.
getLabel Retourneert het label van het besturingselement.
getName Retourneert de naam van het besturingselement.
getObject Retourneert het formulierobject dat het IFRAME of de webresource vertegenwoordigt.
getParent Retourneert de sectie die het besturingselement bevat.
getSrc Retourneert de URL die momenteel wordt weergegeven in het IFRAME of de webresource.
getVisible Retourneert of het besturingselement zichtbaar is.
setDisabled Hiermee schakelt u het besturingselement in of uit.
setFocus Hiermee verplaatst u de focus naar het besturingselement.
setLabel Hiermee wijzigt u het label van het besturingselement.
setSrc Hiermee stelt u de URL in die moet worden weergegeven in het IFRAME of de webresource.
setVisible Hiermee wordt het besturingselement weergegeven of verborgen.

Besturingselementtype Kbsearch (Knowledge Base Search)

Deze methoden zijn beschikbaar voor het zoekbeheer van de Knowledge Base.

Method Description
addOnPostSearch Voegt een gebeurtenis-handler toe die wordt uitgevoerd nadat een zoekopdracht is voltooid.
addOnResultOpened Hiermee voegt u een gebeurtenis-handler toe die wordt uitgevoerd wanneer een zoekresultaat wordt geopend.
addOnSelection Hiermee voegt u een gebeurtenis-handler toe die wordt uitgevoerd wanneer een zoekresultaat wordt geselecteerd.
getControlType Retourneert het type besturingselement.
getDisabled Retourneert of het besturingselement is uitgeschakeld.
getLabel Retourneert het label van het besturingselement.
getName Retourneert de naam van het besturingselement.
getParent Retourneert de sectie die het besturingselement bevat.
getSearchQuery Retourneert de tekst die wordt gebruikt als zoekcriteria.
getSelectedResults Retourneert het geselecteerde zoekresultaat.
getTotalResultCount Retourneert het aantal zoekresultaten.
getVisible Retourneert of het besturingselement zichtbaar is.
openSearchResult Hiermee opent u een opgegeven zoekresultaat.
removeOnPostSearch Hiermee verwijdert u een gebeurtenis-handler voor zoekvoltooiing.
removeOnResultOpened Hiermee verwijdert u een gebeurtenis-handler voor het openen van een zoekresultaat.
removeOnSelection Hiermee verwijdert u een gebeurtenis-handler voor het selecteren van een zoekresultaat.
setFocus Hiermee verplaatst u de focus naar het besturingselement.
setLabel Hiermee wijzigt u het label van het besturingselement.
setSearchQuery Hiermee stelt u de tekst in die wordt gebruikt als zoekcriteria.
setVisible Hiermee wordt het besturingselement weergegeven of verborgen.

Opmerking

Wanneer u het besturingselement voor zoeken in de Knowledge Base toevoegt aan het sociale deelvenster, is searchwidgetcontrol_notescontrolde naam van het besturingselement. Je kunt deze naam niet veranderen.

Type opzoekbesturing

Deze methoden zijn beschikbaar voor een opzoek besturingselement.

Method Description
addCustomFilter Voegt een filter toe aan de opzoekresultaten, gecombineerd met bestaande filters met behulp van AND.
addCustomView Hiermee voegt u een weergave toe aan het opzoekdialoogvenster.
addNotification Geeft een fout- of aanbevelingsmelding weer met optionele acties.
addOnLookupTagClick Hiermee wordt een gebeurtenis-handler toegevoegd die wordt uitgevoerd wanneer op een opzoektag wordt geklikt.
addPreSearch Hiermee voegt u een gebeurtenis-handler toe die wordt uitgevoerd vóór een zoekopdracht.
clearNotification Hiermee verwijdert u een melding uit het besturingselement.
getAttribute Retourneert de kolom waaraan het besturingselement is gebonden.
getControlType Retourneert het type besturingselement.
getDefaultView Retourneert de id van de standaardzoekweergave.
getDisabled Retourneert of het besturingselement is uitgeschakeld.
getEntityTypes Retourneert de tabeltypen die zijn toegestaan in de opzoekactie.
getLabel Retourneert het label van het besturingselement.
getName Retourneert de naam van het besturingselement.
getParent Retourneert de sectie die het besturingselement bevat.
getVisible Retourneert of het besturingselement zichtbaar is.
removeOnLookupTagClick Hiermee verwijdert u een gebeurtenis-handler voor opzoektagklikken.
removePreSearch Hiermee verwijdert u een gebeurtenis-handler die wordt uitgevoerd vóór een zoekactie.
setDefaultView Hiermee stelt u de standaardweergave in het opzoekdialoogvenster in.
setDisabled Hiermee schakelt u het besturingselement in of uit.
setEntityTypes Hiermee stelt u de tabeltypen in die zijn toegestaan in de opzoekactie.
setFocus Hiermee verplaatst u de focus naar het besturingselement.
setLabel Hiermee wijzigt u het label van het besturingselement.
setNotification Geeft een foutbericht weer om aan te geven dat gegevens niet geldig zijn.
setVisible Hiermee wordt het besturingselement weergegeven of verborgen.

Opties en keuzebeheertypen

Opties en keuzebesturingselementen hebben dezelfde set methoden die beschikbaar zijn.

Method Description
addNotification Geeft een fout- of aanbevelingsmelding weer met optionele acties.
addOption Hiermee voegt u een optie toe aan het besturingselement.
clearNotification Hiermee verwijdert u een melding uit het besturingselement.
clearOptions Hiermee verwijdert u alle opties uit het besturingselement.
getAttribute Retourneert de kolom waaraan het besturingselement is gebonden.
getControlType Retourneert het type besturingselement.
getDisabled Retourneert of het besturingselement is uitgeschakeld.
getLabel Retourneert het label van het besturingselement.
getName Retourneert de naam van het besturingselement.
getOptions Retourneert de beschikbare opties, inclusief de lege optie en het uitsluiten van verwijderde opties.
getParent Retourneert de sectie die het besturingselement bevat.
getVisible Retourneert of het besturingselement zichtbaar is.
removeOption Hiermee verwijdert u een optie uit het besturingselement.
setDisabled Hiermee schakelt u het besturingselement in of uit.
setFocus Hiermee verplaatst u de focus naar het besturingselement.
setLabel Hiermee wijzigt u het label van het besturingselement.
setNotification Geeft een foutbericht weer om aan te geven dat gegevens niet geldig zijn.
setVisible Hiermee wordt het besturingselement weergegeven of verborgen.

Formulierbesturingselementtype snel

Zie formContext.ui.quickForms voor informatie over methoden die worden ondersteund voor dit besturingselementtype.

Type subgrid-besturingselement

Zie Rasters en subrasters voor informatie over methoden die worden ondersteund voor dit besturingselementtype.

Type tijdlijnwandbesturing

Het tijdlijn besturingselement bevat de berichten, activiteiten en notities in een uniforme weergave. Deze methoden zijn beschikbaar voor dit type besturingselement.

Method Description
getControlType Retourneert het type besturingselement.
getDisabled Retourneert of het besturingselement is uitgeschakeld.
getLabel Retourneert het label van het besturingselement.
getName Retourneert de naam van het besturingselement.
getParent Retourneert de sectie die het besturingselement bevat.
getVisible Retourneert of het besturingselement zichtbaar is.
opfrissen Hiermee worden de gegevens vernieuwd die in de tijdlijn worden weergegeven.
setDisabled Hiermee schakelt u het besturingselement in of uit.
setFocus Hiermee verplaatst u de focus naar het besturingselement.
setLabel Hiermee wijzigt u het label van het besturingselement.
setVisible Hiermee wordt het besturingselement weergegeven of verborgen.

Type timerbesturing

Deze methoden zijn beschikbaar voor het timer-besturingselement.

Method Description
getControlType Retourneert het type besturingselement.
getDisabled Retourneert of het besturingselement is uitgeschakeld.
getLabel Retourneert het label van het besturingselement.
getName Retourneert de naam van het besturingselement.
getParent Retourneert de sectie die het besturingselement bevat.
getState Retourneert de huidige status van de timer.
getVisible Retourneert of het besturingselement zichtbaar is.
opfrissen Hiermee worden de gegevens vernieuwd die worden weergegeven in de timer.
setDisabled Hiermee schakelt u het besturingselement in of uit.
setFocus Hiermee verplaatst u de focus naar het besturingselement.
setLabel Hiermee wijzigt u het label van het besturingselement.
setVisible Hiermee wordt het besturingselement weergegeven of verborgen.

Type besturingselement voor webresources

Een besturingselement voor webresources heeft dezelfde set methoden die beschikbaar zijn als het iframe-besturingselement. Zie het besturingselementtype iframe.

Besturingselementtype formulieronderdeel

Een besturingselementtype formulieronderdeel heeft dezelfde set methoden die beschikbaar zijn als formContext op een hoofdformulier. Zie client-API voor het gedrag > van formulieronderdelen.

Kolommen

  • Laatst bijgewerkt om