Partilhar via


GridAttribute (referência da API do cliente)

GridAttribute é suportado 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 da API do cliente) para obter informações sobre os métodos disponíveis para acessar dados em uma coleção.

GridAttribute também suporta a 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 da API do cliente) para obter informações sobre os métodos disponíveis para acessar dados em uma coleção.

Sugestão

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 uma série de 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 quando você edita 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 suporta os seguintes métodos 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 de dados para uma coluna.

Observação

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

GridCell
Grades e subgrades em aplicativos controlados por modelo
Recolha de controlos