Поділитися через


GridAttribute (довідник з API клієнта)

GridAttribute підтримується як для сіток, доступних лише для читання, так і для редагування.

GridAttribute представляє дані у клітинці сітки, яку можна редагувати, і містить посилання на всі клітинки, пов'язані зі стовпцем. Відомості про методи доступу до даних у колекції див. в статті Колекції (довідник із інтерфейсу API клієнта).

GridAttribute також підтримує колекцію елементів керування для стовпців вибраного рядка сітки, яка надає способи роботи з колекцією клітинок, пов'язаних зі стовпцем. Кожна клітинка (GridCell) вибраного рядка сітки аналогічна елементу керування у формі, прив'язаній до стовпця в сітці, яку можна редагувати. Відомості про методи доступу до даних у колекції див. в статті Колекції (довідник із інтерфейсу API клієнта).

Порада

З міркувань продуктивності рядок (запис) у сітці, яку можна редагувати, не можна редагувати, доки запис не буде вибрано. Користувачі повинні вибрати один запис у сітці, щоб відредагувати його. Після вибору запису в сітці, яку можна редагувати, Dynamics 365 внутрішньо оцінює низку елементів, зокрема доступ користувачів до запису, чи запис активний, а також перевірки стовпців, щоб забезпечити безпеку та дійсність даних під час редагування даних. Скористайтеся подією OnRecordSelect із методом getFormContext , щоб отримати доступ до записів у сітці, які можна редагувати.

Методи

GridAttribute підтримує наведені нижче методи для стовпців вибраного рядка сітки.

Ім'я Опис
getName Повертає логічне ім'я стовпця вибраного рядка сітки.
getRequiredLevel Повертає значення рядка, яке вказує на те, обов'язкове або рекомендоване значення стовпця.
setRequiredLevel Установлює обов'язковість або рекомендацію даних для стовпця вибраного рядка сітки, перш ніж запис можна буде зберегти.
getValue Отримує значення даних для стовпця.
установити значення Установлює значення даних для стовпця.

Нотатка

Щоб вибрати рядок у сітці, яку можна редагувати, скористайтеся сіткою. getSelectedRows

Сітка
Сітки та вкладені сітки в програмах на основі моделі
Колекція елементів керування