표시 폼 또는 편집 양식 컨트롤의 단일 필드에 대한 표시 및 편집 환경을 제공합니다.
Description
폼 표시 및 편집 폼 컨트롤은 전체 레코드를 표시하고 보기 위한 컨테이너 역할을 합니다. 각 컨테이너는 개별 필드를 표시하거나 해당 필드를 업데이트하는 방법을 제공하는 카드 컨트롤 집합을 보유할 수 있습니다. 각 카드에는 작동하는 레코드의 필드를 지정하는 DataField 속성이 있습니다.
미리 정의된 카드는 다양한 데이터 형식 및 사용자 환경에 대해 정의됩니다. 예를 들어 텍스트 입력 컨트롤을 사용하여 숫자 필드를 편집하는 카드가 있을 수 있습니다. 이 카드는 키보드에 사용하기에 적합합니다. 다른 카드는 대신 슬라이더 컨트롤을 사용하여 숫자 편집을 지원할 수 있습니다. 양식 컨트롤을 선택하면 오른쪽 창에서 필드를 기반으로 카드를 쉽게 선택할 수 있습니다.
카드 자체에는 컨트롤이 포함됩니다. 카드 컨트롤은 단일 필드를 표시하고 편집하기 위한 환경을 구성합니다. 예를 들어 숫자 카드는 필드의 표시 이름을 제공하는 레이블 컨트롤과 필드 값에 대한 편집기를 제공하는 텍스트 입력 컨트롤로 구성됩니다. 카드에는 발생하는 유효성 검사 오류를 표시하는 레이블 컨트롤과 필드가 필요함을 나타내는 공통 별표에 대한 레이블 컨트롤이 있을 수도 있습니다.
미리 정의된 카드의 컨트롤 크기를 조정하고, 이동하고, 숨기고, 컨트롤을 추가하고, 다른 변경 내용을 적용하여 미리 정의된 카드의 컨트롤을 사용자 지정할 수 있습니다. 완전히 비어 있는 카드인 "사용자 지정 카드"로 시작하여 처음부터 컨트롤을 추가할 수도 있습니다.
미리 정의된 카드는 기본적으로 잠겨 있습니다. 잠긴 카드에서는 카드의 특정 속성 또는 카드 내의 컨트롤만 수정할 수 있으며 잠긴 카드는 삭제할 수 없습니다. 고급 보기의 보기 탭에서 카드 잠금을 표시하고 잠금 해제할 수 있습니다. 속성이 잠겨 있고 수정할 수 없는 경우 이름 옆에 잠금 아이콘이 표시됩니다. 카드 잠금 해제는 고급 작업이며 카드에 대해 자동 수식 생성이 더 이상 발생하지 않으며 카드를 다시 차단할 수 없으므로 주의해야 합니다.
폼의 컨테이너 내에서 ThisItem 레코드를 사용할 수 있으며 레코드의 모든 필드를 포함합니다. 예를 들어 카드의 Default 속성은 종종 ThisItem으로 설정됩니다. FieldName.
부모 참조를 사용하여 카드의 속성을 참조하도록 컨트롤을 구성할 수 있습니다. 예를 들어 컨트롤은 Parent.Default 를 사용하여 데이터 원본에서 필드의 초기 상태를 읽어야 합니다. 원하는 정보에 직접 액세스하는 대신 Parent 를 사용하면 카드가 더 잘 캡슐화되고 내부 수식을 중단하지 않고 다른 필드로 변경할 수 있습니다.
카드를 사용자 지정, 잠금 해제 및 만드는 방법에 대한 예제는 데이터 카드 이해 를 참조하세요.
키 속성
DataField – 이 카드가 표시하고 편집하는 레코드 내의 필드 이름입니다.
- 이름을 수식이 아닌 큰따옴표(예: "Name")로 묶은 단일 정적 문자열로 지정합니다.
- DataField 속성을 비워서 카드를 바인딩 해제합니다. 언바운드 카드의 경우 유효 및 업데이트 속성이 무시됩니다.
기본값 - 사용자가 변경하기 전에 컨트롤의 초기 값입니다.
- 카드의 각 컨트롤에 대해 이 속성을 Parent.Default 로 설정하여 데이터 원본에 따라 필드의 기본값을 참조합니다. 예를 들어 사용자가 해당 슬라이더의 제네릭 값으로 시작하도록 슬라이더의 Default 속성을 Parent.Default 로 설정합니다.
DisplayMode – 값은 편집, 보기 또는 사용 안 함일 수 있습니다. 카드 내의 컨트롤이 사용자 입력(편집)을 허용하는지, 데이터만 표시할지(보기) 또는 사용하지 않도록 설정(사용 안 함)을 허용하는지 여부를 구성합니다.
- 기본적으로 폼의 동작에 연결된 이 속성을 구성하여 편집 및 보기 양식 모두에서 단일 카드를 사용할 수 있습니다.
- 보기 모드에서 텍스트 입력, 드롭다운, 날짜 선택기와 같은 자식 컨트롤은 텍스트 값만 표시하고 대화형 요소 또는 장식을 렌더링하지 않습니다.
DisplayName – 데이터 원본의 필드에 대한 사용자 이름입니다.
- DataSourceInfo 함수는 데이터 원본에서 이 메타데이터를 제공합니다.
- 카드 내의 컨트롤은 Parent.DisplayName 을 사용하여 필드 이름을 참조해야 합니다.
오류 – 유효성 검사에 실패할 때 이 필드에 표시할 사용자에게 친숙한 오류 메시지입니다.
- SubmitForm이 호출되면 이 속성이 설정됩니다.
- 이 메시지는 데이터 원본의 메타데이터 및 카드의 필수 속성 확인에 따른 유효성 검사 문제를 설명합니다.
필수 – 데이터 원본 필드를 편집하는 카드에 값이 포함되어야 하는지 여부입니다.
- DataSourceInfo 함수는 데이터 원본에서 필요한 메타데이터를 제공합니다.
- 카드 내의 컨트롤은 Parent.Required 를 사용하여 해당 카드의 필드가 필요한지 여부를 결정해야 합니다.
업데이트 – 필드의 데이터 원본에 다시 쓸 값입니다.
- 데이터 원본에 다시 쓰기 위해 카드의 편집 컨트롤에서 값을 가져오려면 이 속성의 수식을 사용합니다. 예를 들어 카드의 Update 속성을 Slider.Value 로 설정하여 해당 카드의 슬라이더 값으로 데이터 원본을 업데이트합니다.
너비 – 컨트롤의 왼쪽 가장자리와 오른쪽 가장자리 사이의 거리입니다.
WidthFit – 편집 양식 컨트롤과 같은 컨테이너 컨트롤의 빈 공간을 채우기 위해 컨트롤이 자동으로 가로로 커지는지 여부입니다. 여러 카드에 이 속성이 true로 설정된 경우 공백이 구분됩니다. 자세한 내용은 데이터 양식 레이아웃 이해(Understand Data Form Layout)를 참조하세요.
추가 속성
BorderColor – 컨트롤 테두리의 색입니다.
BorderStyle – 컨트롤의 테두리가 Solid, Dashed, Dotted 또는 None인지 여부입니다.
BorderThickness – 컨트롤 테두리의 두께입니다.
Fill – 컨트롤의 배경색입니다.
높이 – 컨트롤의 위쪽 가장자리와 아래쪽 가장자리 사이의 거리입니다.
유효 – 카드 또는 편집 양식 컨트롤에 유효한 항목이 포함되어 있는지 여부에 관계없이 데이터 원본에 제출할 준비가 되었습니다.
표시 – 컨트롤이 표시되는지 숨겨지는지 여부입니다.
X – 컨트롤의 왼쪽 가장자리와 부모 컨테이너의 왼쪽 가장자리 사이의 거리입니다(부모 컨테이너가 없는 경우 화면). 여러 열이 있는 컨테이너의 카드 컨트롤에 대해 이 속성은 카드가 표시되는 열을 결정합니다.
Y – 컨트롤의 위쪽 가장자리와 부모 컨테이너의 위쪽 가장자리 사이의 거리입니다(부모 컨테이너가 없는 경우 화면). 여러 행이 있는 컨테이너의 카드 컨트롤에 대해 이 속성은 카드가 표시되는 행을 결정합니다.
예시
예제는 데이터 카드 이해 및 데이터 양식 레이아웃 이해 를 참조하세요.
내게 필요한 옵션 지침
색 대비
다음 사이에 적절한 색 대비가 있어야 합니다.
- 채우기 및 모든 자식 컨트롤입니다. 예를 들어 카드에 레이블 이 있고 레이블에 투명한 채우기가 있는 경우 카드의 Fill 은 레이블의 배경색이 됩니다. 따라서 카드의 채우기 와 레이블의 색 사이에 적절한 대비가 있어야 합니다.
화면 읽기 프로그램 지원
- DisplayName 이 있어야 합니다.