폼의 컨트롤을 가져옵니다.
비고
getControl 양식 본문 및 머리글의 컨트롤에서만 작동합니다. 동일한 열을 참조하는 경우에도 페이지의 다른 위치에 있는 컨트롤에는 지원되지 않습니다.
-
비즈니스 프로세스 흐름 내의 컨트롤은 접
header_process_두사를 사용하여 참조하세요. - 하위 그리드 및 타임라인 컨트롤과 같은 다른 컨트롤 내의 컨트롤은 지원되지 않습니다.
Syntax
formContext.getControl(arg);
formContext.getControl(arg) 메서드는 formContext.ui.controls.get에 액세스하는 바로 가기 메서드입니다.
매개 변수
arg: 선택 사항입니다. 폼에서 컨트롤의 이름 또는 인덱스 값 으로 인수를 전달하여 폼의 컨트롤에 액세스할 수 있습니다. 예를 들어 formContext.getControl("firstname") 또는 formContext.getControl(0)입니다.
arg 이름이 잘못되어 폼에 없으면 null 값이 반환됩니다.
값이 arg 제공되지 않으면 폼에 있는 모든 컨트롤의 배열을 반환합니다.
반환 값
형식: 개체 컬렉션, 개체 또는 null입니다.
설명: 매개 변수 없이 메서드를 사용하는 경우 개체 컬렉션입니다. 매개 변수와 함께 메서드를 사용하는 경우 개체 또는 null입니다. 이름을 매개 변수로 사용하고 동일한 열에 대해 여러 컨트롤이 있는 경우 첫 번째 컨트롤만 반환됩니다.
팁 (조언)
폼의 열에 바인딩된 모든 컨트롤을 수정하려면 열 형식 내의 컨트롤 컬렉션을 사용합니다.
예를 들어 열에 바인딩된 각 컨트롤에 name 알림을 추가하려면 다음을 수행할 수 있습니다.
const notification = {
messages: ['Sample Notification on Name Controls'],
notificationLevel: 'RECOMMENDATION',
uniqueId: 'my_unique_id'};
formContext.getAttribute("name").controls.forEach(control => control.addNotification(notification));