Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
I modeldrevne apps repræsenterer et kontrolelement et HTML-element i formularen. Nogle kontrolelementer er bundet til en bestemt kolonne, mens andre repræsenterer ubundne kontrolelementer, f.eks. en IFRAME, en webressource eller et undergitter, der er føjet til formularen.
Kontrolelementobjektet indeholder metoder til at ændre præsentationen eller funktionsmåden for et kontrolelement og identificere den tilsvarende kolonne. Få adgang til kontrolelementer ved hjælp af en af følgende samlinger:
- formContext.ui.controls
- formContext.ui Section.controls
- formContext.data.entityAttribute.controls
FormenContext. metoden getControl er en genvejsmetode til at få adgang til formContext.ui.controls.get.
Notat
Når du udfører handlinger på kontrolelementer, der er knyttet til en kolonne, skal du overveje, at kontrolelementet kan vises på siden mere end én gang. Generelt skal du udføre de samme handlinger for hvert kontrolelement for kolonnen. Du kan gå gennem samlingen af kolonnekontrolelementer og udføre handlingerne på hvert kontrolelement.
Kontrolelementerne er kategoriseret efter type. Brug metoden getControlType til at bestemme typen af et kontrolelement. Visse kontrolmetoder er kun tilgængelige for bestemte typer kontrolelementer.
Denne artikel indeholder oplysninger om de metoder, der er tilgængelige for hver kontrolelementtype.
Standardkontroltype
Disse metoder er tilgængelige for et Standard-kontrolelement.
| Metode | Beskrivende tekst |
|---|---|
| addNotification | Viser en meddelelse om fejl eller anbefalinger med valgfrie handlinger. |
| clearNotification | Fjerner en meddelelse fra kontrolelementet. |
| getAttribute | Returnerer den kolonne, som kontrolelementet er bundet til. |
| getControlType | Returnerer kontrolelementets type. |
| getDisabled | Returnerer, om kontrolelementet er deaktiveret. |
| getLabel | Returnerer kontrolelementets navn. |
| getName | Returnerer kontrolelementets navn. |
| getOutputs | Returnerer en ordbog over kontrolelementets outputegenskaber. |
| getParent | Returnerer den sektion, der indeholder kontrolelementet. |
| getVisible | Returnerer, om kontrolelementet er synligt. |
| setDisabled | Aktiverer eller deaktiverer kontrolelementet. |
| setFocus | Flytter fokus til kontrolelementet. |
| setLabel | Ændrer kontrolelementets navn. |
| setNotification | Viser en fejlmeddelelse for at angive, at dataene ikke er gyldige. |
| setVisible | Viser eller skjuler kontrolelementet. |
Følgende metoder til Standard-kontrolelementet frarådes: addOnKeyPress, fireOnKeyPress og removeOnKeyPress.
IFRAME-kontrolelementtype
Disse metoder er tilgængelige for et IFRAME-kontrolelement.
| Metode | Beskrivende tekst |
|---|---|
| getContentWindow | Returnerer indholdsvinduet for IFRAME- eller webressourcen. |
| getControlType | Returnerer kontrolelementets type. |
| getDisabled | Returnerer, om kontrolelementet er deaktiveret. |
| getInitialUrl | Returnerer den standard-URL-adresse, der er konfigureret for IFRAME. |
| getLabel | Returnerer kontrolelementets navn. |
| getName | Returnerer kontrolelementets navn. |
| getObject | Returnerer det formularobjekt, der repræsenterer IFRAME- eller webressourcen. |
| getParent | Returnerer den sektion, der indeholder kontrolelementet. |
| getSrc | Returnerer den URL-adresse, der i øjeblikket vises i IFRAME- eller webressourcen. |
| getVisible | Returnerer, om kontrolelementet er synligt. |
| setDisabled | Aktiverer eller deaktiverer kontrolelementet. |
| setFocus | Flytter fokus til kontrolelementet. |
| setLabel | Ændrer kontrolelementets navn. |
| setSrc | Angiver den URL-adresse, der skal vises i IFRAME- eller webressourcen. |
| setVisible | Viser eller skjuler kontrolelementet. |
Kbsearch-kontroltype (vidensbasesøgning)
Disse metoder er tilgængelige for kontrolelementet til søgning i vidensbasen.
| Metode | Beskrivende tekst |
|---|---|
| addOnPostSearch | Tilføjer en hændelseshandler, der kører, når en søgning er fuldført. |
| addOnResultOpened | Tilføjer en hændelseshandler, der kører, når et søgeresultat åbnes. |
| addOnSelection | Tilføjer en hændelseshandler, der kører, når der vælges et søgeresultat. |
| getControlType | Returnerer kontrolelementets type. |
| getDisabled | Returnerer, om kontrolelementet er deaktiveret. |
| getLabel | Returnerer kontrolelementets navn. |
| getName | Returnerer kontrolelementets navn. |
| getParent | Returnerer den sektion, der indeholder kontrolelementet. |
| getSearchQuery | Returnerer den tekst, der bruges som søgekriterier. |
| getSelectedResults | Returnerer det aktuelt valgte søgeresultat. |
| getTotalResultCount | Returnerer antallet af søgeresultater. |
| getVisible | Returnerer, om kontrolelementet er synligt. |
| openSearchResult | Åbner et angivet søgeresultat. |
| removeOnPostSearch | Fjerner en hændelseshandler for fuldførelse af søgning. |
| removeOnResultOpened | Fjerner en hændelseshandler for at åbne et søgeresultat. |
| removeOnSelection | Fjerner en hændelseshandler for at vælge et søgeresultat. |
| setFocus | Flytter fokus til kontrolelementet. |
| setLabel | Ændrer kontrolelementets navn. |
| setSearchQuery | Angiver den tekst, der bruges som søgekriterier. |
| setVisible | Viser eller skjuler kontrolelementet. |
Notat
Når du føjer kontrolelementet til søgning i vidensbasen til den sociale rude, er searchwidgetcontrol_notescontrolnavnet på kontrolelementet . Du kan ikke ændre dette navn.
Kontrolelementtype for opslag
Disse metoder er tilgængelige for et opslagskontrolelement.
| Metode | Beskrivende tekst |
|---|---|
| addCustomFilter | Føjer et filter til opslagsresultaterne kombineret med eksisterende filtre ved hjælp af AND. |
| addCustomView | Føjer en visning til opslagsdialogboksen. |
| addNotification | Viser en meddelelse om fejl eller anbefalinger med valgfrie handlinger. |
| addOnLookupTagClick | Tilføjer en hændelseshandler, der kører, når der klikkes på et opslagsmærke. |
| addPreSearch | Tilføjer en hændelseshandler, der kører før en opslagssøgning. |
| clearNotification | Fjerner en meddelelse fra kontrolelementet. |
| getAttribute | Returnerer den kolonne, som kontrolelementet er bundet til. |
| getControlType | Returnerer kontrolelementets type. |
| getDefaultView | Returnerer id'et for standardopslagsvisningen. |
| getDisabled | Returnerer, om kontrolelementet er deaktiveret. |
| getEntityTypes | Returnerer de tabeltyper, der er tilladt i opslaget. |
| getLabel | Returnerer kontrolelementets navn. |
| getName | Returnerer kontrolelementets navn. |
| getParent | Returnerer den sektion, der indeholder kontrolelementet. |
| getVisible | Returnerer, om kontrolelementet er synligt. |
| removeOnLookupTagClick | Fjerner en hændelseshandler for klik på opslagsmærker. |
| removePreSearch | Fjerner en hændelseshandler, der kører før en opslagssøgning. |
| setDefaultView | Angiver standardvisningen i opslagsdialogboksen. |
| setDisabled | Aktiverer eller deaktiverer kontrolelementet. |
| setEntityTypes | Angiver de tabeltyper, der er tilladt i opslaget. |
| setFocus | Flytter fokus til kontrolelementet. |
| setLabel | Ændrer kontrolelementets navn. |
| setNotification | Viser en fejlmeddelelse for at angive, at dataene ikke er gyldige. |
| setVisible | Viser eller skjuler kontrolelementet. |
Valg- og valgkontroltyper
Valg- og valgkontrolelementer har det samme sæt tilgængelige metoder.
| Metode | Beskrivende tekst |
|---|---|
| addNotification | Viser en meddelelse om fejl eller anbefalinger med valgfrie handlinger. |
| addOption | Føjer en indstilling til kontrolelementet. |
| clearNotification | Fjerner en meddelelse fra kontrolelementet. |
| clearOptions | Fjerner alle indstillinger fra kontrolelementet. |
| getAttribute | Returnerer den kolonne, som kontrolelementet er bundet til. |
| getControlType | Returnerer kontrolelementets type. |
| getDisabled | Returnerer, om kontrolelementet er deaktiveret. |
| getLabel | Returnerer kontrolelementets navn. |
| getName | Returnerer kontrolelementets navn. |
| getOptions | Returnerer de tilgængelige indstillinger, herunder den tomme indstilling og udelader fjernede indstillinger. |
| getParent | Returnerer den sektion, der indeholder kontrolelementet. |
| getVisible | Returnerer, om kontrolelementet er synligt. |
| removeOption | Fjerner en indstilling fra kontrolelementet. |
| setDisabled | Aktiverer eller deaktiverer kontrolelementet. |
| setFocus | Flytter fokus til kontrolelementet. |
| setLabel | Ændrer kontrolelementets navn. |
| setNotification | Viser en fejlmeddelelse for at angive, at dataene ikke er gyldige. |
| setVisible | Viser eller skjuler kontrolelementet. |
Kontrolelementtype for hurtig formular
Se formContext.ui.quickForms for at få oplysninger om de metoder, der understøttes for denne kontrolelementtype.
Kontrolelementtype for undergiitter
Se Gitre og undergitter for at få oplysninger om de metoder, der understøttes for denne kontrolelementtype.
Kontrolelementtype for tidslinjevægge
Kontrolelementet Tidslinje viser indlæg, aktiviteter og noter i en samlet visning. Disse metoder er tilgængelige for denne kontrolelementtype.
| Metode | Beskrivende tekst |
|---|---|
| getControlType | Returnerer kontrolelementets type. |
| getDisabled | Returnerer, om kontrolelementet er deaktiveret. |
| getLabel | Returnerer kontrolelementets navn. |
| getName | Returnerer kontrolelementets navn. |
| getParent | Returnerer den sektion, der indeholder kontrolelementet. |
| getVisible | Returnerer, om kontrolelementet er synligt. |
| Opdatere | Opdaterer de data, der vises på tidslinjen. |
| setDisabled | Aktiverer eller deaktiverer kontrolelementet. |
| setFocus | Flytter fokus til kontrolelementet. |
| setLabel | Ændrer kontrolelementets navn. |
| setVisible | Viser eller skjuler kontrolelementet. |
Kontrolelementtype for timer
Disse metoder er tilgængelige for timerkontrolelementet.
| Metode | Beskrivende tekst |
|---|---|
| getControlType | Returnerer kontrolelementets type. |
| getDisabled | Returnerer, om kontrolelementet er deaktiveret. |
| getLabel | Returnerer kontrolelementets navn. |
| getName | Returnerer kontrolelementets navn. |
| getParent | Returnerer den sektion, der indeholder kontrolelementet. |
| getState | Returnerer timerens aktuelle tilstand. |
| getVisible | Returnerer, om kontrolelementet er synligt. |
| Opdatere | Opdaterer de data, der vises i timeren. |
| setDisabled | Aktiverer eller deaktiverer kontrolelementet. |
| setFocus | Flytter fokus til kontrolelementet. |
| setLabel | Ændrer kontrolelementets navn. |
| setVisible | Viser eller skjuler kontrolelementet. |
Kontrolelementtype for webressource
Et kontrolelement af typen webressource har det samme sæt tilgængelige metoder som iframe-kontrolelementet. Se iframe-kontroltype.
Kontrolelementtype for formularkomponent
En kontrolelementtype for en formularkomponent har det samme sæt metoder, der er tilgængelige som formContext i en hovedformular. Se Klient-API til funktionsmåde > for formularkomponent.