Compartilhar via


quickViewControl.getControl (referência da API do cliente)

Obtém o controle em um formulário.

Sintaxe

quickViewControl.getControl(arg);

Parâmetro

arg: opcional. Você pode acessar um único controle na coleção de controles constituintes passando um argumento como o nome ou o valor de índice do controle constituinte em um controle de exibição rápida. Por exemplo: quickViewControl.getControl("firstname") ou quickViewControl.getControl(0)

Valor de retorno

Tipo: coleção Object ou Object.

Descrição: objeto se você usar o método com parâmetro; coleção de objetos se você usar o método sem parâmetros.

Observações

Depois de recuperar um controle constituinte em um controle de exibição rápida, você pode usar qualquer um dos métodos com suporte para um controle em aplicativos controlados por modelos no controle constituinte que não altera os dados de controle constituinte. Isso ocorre porque os controles constituintes em um controle de exibição rápida são somente leitura. Por exemplo, você pode usar:

quickViewControl.getControl(0).getAttribute()

Para obter mais informações sobre os métodos com suporte para um controle, consulte Controles.

Importante

O getAttribute ou quaisquer métodos relacionados a dados em um controle constituinte podem não funcionar no evento OnLoad do formulário principal porque o formulário de exibição rápida ao qual seu limite pode não ter carregado completamente quando o formulário principal foi carregado. Você deve usar o método isLoaded para a instância de controle de exibição rápida para ajudá-lo a determinar se o formulário de exibição rápida delimitado foi completamente carregado.

Além disso, a maneira como você recupera controles constituintes em um controle de exibição rápida em formulários usando o novo mecanismo de renderização de formulários é diferente dos formulários herdados. Portanto, se você estiver usando formulários herdados e tiver controles constituintes de direcionamento de código em um controle de exibição rápida, você deverá atualizar seu código quando decidir usar o novo mecanismo de renderização de formulário.

formContext.ui.quickForms