Partilhar via


Controles (referência da API do cliente)

Um controle representa um elemento HTML presente no formulário. Alguns controles são vinculados a uma coluna específica, enquanto outros podem representar controles não acoplados, como um IFRAME, recurso da Web ou uma subgrade adicionada ao formulário.

O objeto de controle fornece métodos para alterar a apresentação ou o comportamento de um controle e identificar a coluna correspondente. Você acessa controles usando uma das seguintes coleções:

  • formContext.ui.controls
  • formContext.ui Section.controls
  • formContext.data.entityAtributo.controles

O formContext. getControl método é um método de atalho para acessar formContext.ui.controls.get.

Os controles são categorizados por tipo. Você pode determinar o tipo de um controle usando o método getControlType . Certos métodos de controlo só estão disponíveis para tipos específicos de controlos.

Este artigo fornece informações sobre os métodos disponíveis por tipo de controle.

Tipo de controlo padrão

Estes são os métodos disponíveis para um controle padrão.

 

Os seguintes métodos para o controle Standard foram preteridos nesta versão: addOnKeyPress, fireOnKeyPresse removeOnKeyPress.

Tipo de controle IFRAME

Esses métodos estão disponíveis para um controle IFRAME.

 

Tipo de controlo Kbsearch (Pesquisa na base de conhecimento)

Esses métodos estão disponíveis para controle de pesquisa da base de dados de conhecimento.

Observação

Quando o controle de pesquisa da base de dados de conhecimento é adicionado ao painel social, o nome do controle será searchwidgetcontrol_notescontrol. Este nome não pode ser alterado.

Tipo de controle de pesquisa

Esses métodos estão disponíveis para um controle de pesquisa.

Opções e tipos de controlo de escolha

Tanto as escolhas quanto os controles de escolha têm o mesmo conjunto de métodos disponíveis.

 

 

Tipo de controle Quickform

Consulte formContext.ui.quickForms para obter informações sobre métodos suportados para esse tipo de controle.

Tipo de controle de subgrade

Consulte Grades e subgrades para obter informações sobre os métodos suportados para esse tipo de controle.

Tipo de controle Timelinewall

O controle de linha do tempo apresenta as Postagens, Atividades e Anotações em uma exibição unificada. Esses métodos estão disponíveis para esse tipo de controle.

 

Tipo de controle de temporizador

Esses métodos estão disponíveis para o controle do temporizador.

Tipo de controle de recursos da Web

Um controle de recurso da Web tem o mesmo conjunto de métodos disponíveis como o controle iframe. Ver tipo de controlo iframe

O recurso da Web do Silverlight tem estes métodos extras:

Sugestão

Se você quiser modificar todos os controles vinculados a uma coluna em um formulário, use a coleção de controles dentro do tipo de coluna. Por exemplo, para adicionar notificação a cada controle vinculado à name coluna, você pode fazer o seguinte:

 const notification = { messages: ['Sample Notification on Name Controls'], notificationLevel: 'RECOMMENDATION', uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));

Tipo de controle de componente de formulário

Um tipo de controle de componente de formulário tem o mesmo conjunto de métodos disponíveis como o formContext em um formulário principal. Consulte Comportamento > do componente de formulário API do cliente

Columns