Controale (Referință API client)

În aplicațiile bazate pe modele, un control reprezintă un element HTML din formular. Unele controale sunt legate la o anumită coloană, în timp ce altele reprezintă controale nelegate, cum ar fi un IFRAME, o resursă web sau un subgrid adăugat la formular.

Obiectul de control furnizează metode de a modifica prezentarea sau comportamentul unui control și de a identifica coloana corespunzătoare. Controalele Access utilizând una dintre următoarele colecții:

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

The formContext. metoda getControl este o metodă de comandă rapidă pentru a accesa formContext.ui.controls.get.

Notă

Atunci când efectuați acțiuni asupra controalelor legate la o coloană, luați în considerare faptul că controlul poate apărea de mai multe ori pe pagină. În general, trebuie să efectuați aceleași acțiuni pentru fiecare control al coloanei. Puteți să parcurgeți colecția de controale de coloană și să efectuați acțiunile pentru fiecare control.

Controalele sunt clasificate după tip. Utilizați metoda getControlType pentru a determina tipul unui control. Anumite metode de control sunt disponibile doar pentru anumite tipuri de controale.

Acest articol oferă informații despre metodele disponibile pentru fiecare tip de control.

Tip de control standard

Aceste metode sunt disponibile pentru un control Standard.

Metodă Descriere
addNotification Afișează o eroare sau o notificare de recomandare cu acțiuni opționale.
clearNotification Elimină o notificare din control.
getAttribute Returnează coloana la care este legat controlul.
getControlType Returnează tipul controlului.
getDisabled Returnează dacă controlul este dezactivat.
getLabel Returnează eticheta controlului.
getName Returnează numele controlului.
getOutputs Returnează un dicționar al proprietăților de ieșire ale controlului.
getParent Returnează secțiunea care conține controlul.
getVisible Returnează dacă controlul este vizibil.
setDisabled Activează sau dezactivează controlul.
setFocus Mută focalizarea la control.
setLabel Modifică eticheta controlului.
setNotification Afișează un mesaj de eroare pentru a indica faptul că datele nu sunt valide.
setVisible Afișează sau ascunde comanda.

Următoarele metode pentru controlul Standard sunt perimate: addOnKeyPress, fireOnKeyPress și removeOnKeyPress.

Tip de control IFRAME

Aceste metode sunt disponibile pentru un control IFRAME.

Metodă Descriere
obțineFereastrăConținut Returnează fereastra de conținut a resursei IFRAME sau web.
getControlType Returnează tipul controlului.
getDisabled Returnează dacă controlul este dezactivat.
getInitialUrl Returnează URL-ul implicit configurat pentru IFRAME.
getLabel Returnează eticheta controlului.
getName Returnează numele controlului.
obțineObiect Returnează obiectul formular care reprezintă resursa IFRAME sau web.
getParent Returnează secțiunea care conține controlul.
getSrc Returnează URL-ul afișat în prezent în IFRAME sau în resursa web.
getVisible Returnează dacă controlul este vizibil.
setDisabled Activează sau dezactivează controlul.
setFocus Mută focalizarea la control.
setLabel Modifică eticheta controlului.
setSrc Setează URL-ul de afișat în IFRAME sau în resursa web.
setVisible Afișează sau ascunde comanda.

Tipul de control kbsearch (căutare în baza de cunoștințe)

Aceste metode sunt disponibile pentru controlul căutărilor din baza de cunoștințe.

Metodă Descriere
addOnPostSearch Adaugă o rutină de tratare a evenimentelor care rulează după finalizarea unei căutări.
addOnResultOpened Adaugă o rutină de tratare a evenimentelor care rulează atunci când se deschide un rezultat de căutare.
addOnSelection Adaugă o rutină de tratare eveniment care rulează atunci când este selectat un rezultat de căutare.
getControlType Returnează tipul controlului.
getDisabled Returnează dacă controlul este dezactivat.
getLabel Returnează eticheta controlului.
getName Returnează numele controlului.
getParent Returnează secțiunea care conține controlul.
getSearchQuery Returnează textul utilizat ca criteriu de căutare.
getSelectedResults Returnează rezultatul de căutare selectat în prezent.
getTotalResultCount Returnează numărul de rezultate de căutare.
getVisible Returnează dacă controlul este vizibil.
openSearchResult Deschide un rezultat de căutare specificat.
removeOnPostSearch Elimină o rutină de tratare a evenimentelor pentru finalizarea căutării.
removeOnResultOpened Elimină o rutină de tratare a evenimentelor pentru deschiderea unui rezultat de căutare.
removeOnSelection Elimină o rutină de tratare a evenimentelor pentru selectarea unui rezultat de căutare.
setFocus Mută focalizarea la control.
setLabel Modifică eticheta controlului.
setSearchQuery Setează textul utilizat ca criteriu de căutare.
setVisible Afișează sau ascunde comanda.

Notă

Atunci când adăugați controlul de căutare din baza de cunoștințe în panoul social, numele controlului este searchwidgetcontrol_notescontrol. Nu puteți modifica acest nume.

Tip control căutare

Aceste metode sunt disponibile pentru un control de căutare.

Metodă Descriere
addCustomFilter Adaugă un filtru la rezultatele căutării, combinat cu filtrele existente utilizând AND.
addCustomView Adaugă o vizualizare la caseta de dialog de căutare.
addNotification Afișează o eroare sau o notificare de recomandare cu acțiuni opționale.
addOnLookupTagClick Adaugă o rutină de tratare a evenimentelor care rulează atunci când se face clic pe o etichetă de căutare.
addPreSearch Adaugă o rutină de tratare a evenimentelor care rulează înainte de o căutare.
clearNotification Elimină o notificare din control.
getAttribute Returnează coloana la care este legat controlul.
getControlType Returnează tipul controlului.
getDefaultView Returnează ID-ul vizualizării de căutare implicite.
getDisabled Returnează dacă controlul este dezactivat.
getEntityTypes Returnează tipurile de tabel permise în căutare.
getLabel Returnează eticheta controlului.
getName Returnează numele controlului.
getParent Returnează secțiunea care conține controlul.
getVisible Returnează dacă controlul este vizibil.
removeOnLookupTagClick Elimină o rutină de tratare a evenimentelor pentru clicurile etichetei de căutare.
removePreSearch Elimină o rutină de tratare a evenimentelor care rulează înainte de o căutare.
setDefaultView Setează vizualizarea implicită în caseta de dialog de căutare.
setDisabled Activează sau dezactivează controlul.
setEntityTypes Setează tipurile de tabel permise în căutare.
setFocus Mută focalizarea la control.
setLabel Modifică eticheta controlului.
setNotification Afișează un mesaj de eroare pentru a indica faptul că datele nu sunt valide.
setVisible Afișează sau ascunde comanda.

Tipuri de control opțiuni și alegere

Opțiunile și controalele de alegere au același set de metode disponibile.

Metodă Descriere
addNotification Afișează o eroare sau o notificare de recomandare cu acțiuni opționale.
adăugareopție Adaugă o opțiune la control.
clearNotification Elimină o notificare din control.
clearOptions Elimină toate opțiunile din control.
getAttribute Returnează coloana la care este legat controlul.
getControlType Returnează tipul controlului.
getDisabled Returnează dacă controlul este dezactivat.
getLabel Returnează eticheta controlului.
getName Returnează numele controlului.
getOptions Returnează opțiunile disponibile, inclusiv opțiunea necompletată și cu excepția opțiunilor eliminate.
getParent Returnează secțiunea care conține controlul.
getVisible Returnează dacă controlul este vizibil.
eliminareopție Elimină o opțiune din control.
setDisabled Activează sau dezactivează controlul.
setFocus Mută focalizarea la control.
setLabel Modifică eticheta controlului.
setNotification Afișează un mesaj de eroare pentru a indica faptul că datele nu sunt valide.
setVisible Afișează sau ascunde comanda.

Tip control formular rapid

Consultați formContext.ui.quickForms pentru informații despre metodele acceptate pentru acest tip de control.

Tip control subgrid

Consultați Grile și subgriduri pentru informații despre metodele acceptate pentru acest tip de control.

Tip control perete cronologie

Controlul cronologiei prezintă postările, activitățile și notele într-o vizualizare unificată. Aceste metode sunt disponibile pentru acest tip de control.

Metodă Descriere
getControlType Returnează tipul controlului.
getDisabled Returnează dacă controlul este dezactivat.
getLabel Returnează eticheta controlului.
getName Returnează numele controlului.
getParent Returnează secțiunea care conține controlul.
getVisible Returnează dacă controlul este vizibil.
împrospăta Reîmprospătează datele afișate în cronologie.
setDisabled Activează sau dezactivează controlul.
setFocus Mută focalizarea la control.
setLabel Modifică eticheta controlului.
setVisible Afișează sau ascunde comanda.

Tip control cronometru

Aceste metode sunt disponibile pentru controlul cronometrului.

Metodă Descriere
getControlType Returnează tipul controlului.
getDisabled Returnează dacă controlul este dezactivat.
getLabel Returnează eticheta controlului.
getName Returnează numele controlului.
getParent Returnează secțiunea care conține controlul.
getState Returnează starea curentă a cronometrului.
getVisible Returnează dacă controlul este vizibil.
împrospăta Reîmprospătează datele afișate în cronometru.
setDisabled Activează sau dezactivează controlul.
setFocus Mută focalizarea la control.
setLabel Modifică eticheta controlului.
setVisible Afișează sau ascunde comanda.

Tip control resurse Web

Un control de resurse web are același set de metode disponibile ca controlul iframe. Vedeți tipul de control iframe.

Tip control componentă formular

Un tip de control al componentei formular are același set de metode disponibile ca formContext într-un formular principal. Consultați API-uri client pentru comportamentul > componentelor de formular.

Coloane