Compartilhar via


GridAttribute (referência da API do cliente)

O GridAttribute tem suporte para grades somente leitura e editáveis.

GridAttribute representa os dados na célula de uma grade editável e contém uma referência a todas as células associadas à coluna. Consulte Coleções (referência de API do Cliente) para obter informações sobre os métodos disponíveis para acessar dados em uma coleção.

GridAttribute também dá suporte à coleção de controles para colunas de uma linha de grade selecionada, que fornece métodos para trabalhar com uma coleção de células associadas à coluna. Cada célula (GridCell) de uma linha de grade selecionada é análoga a um controle em um formulário que está vinculado a uma coluna em uma grade editável. Consulte Coleções (referência de API do Cliente) para obter informações sobre os métodos disponíveis para acessar dados em uma coleção.

Dica

Por motivos de desempenho, uma linha (registro) em uma grade editável não é editável até que o registro seja selecionado. Os usuários devem selecionar um único registro em uma grade para editá-lo. Depois que um registro é selecionado em uma grade editável, o Dynamics 365 avalia internamente várias coisas, incluindo o acesso do usuário ao registro, se o registro está ativo e validações de coluna para garantir que a segurança e a validade dos dados sejam respeitadas ao editar dados. Considere usar o evento OnRecordSelect com o método getFormContext para acessar registros na grade que estão no estado editável.

Methods

GridAttribute dá suporte aos métodos a seguir para colunas de uma linha de grade selecionada.

Nome Description
getName Retorna o nome lógico da coluna de uma linha de grade selecionada.
getRequiredLevel Retorna um valor de cadeia de caracteres que indica se um valor para a coluna é necessário ou recomendado.
setRequiredLevel Define se os dados são necessários ou recomendados para a coluna de uma linha de grade selecionada antes que o registro possa ser salvo.
getValue Recupera o valor de dados de uma coluna.
setValue Define o valor dos dados de uma coluna.

Observação

Para selecionar uma linha em uma grade editável, use a Grade. getSelectedRows

GridCell
Grades e subgrids em aplicativos controlados por modelos
Coleção controls