캔버스 앱의 그림 추가 컨트롤
사진을 촬영하거나 로컬 디바이스에서 이미지를 로드합니다.
설명
이 컨트롤을 통해 사용자는 사진을 촬영하거나 디바이스에서 이미지 파일을 업로드하고 이 콘텐츠로 데이터 원본을 업데이트할 수 있습니다. 모바일 디바이스에서 사용자에게 사진을 촬영하거나 이미 사용 가능한 이미지 중에서 선택할지 묻는 디바이스의 선택 대화 상자가 표시됩니다.
이 컨트롤은 두 가지 컨트롤 이미지 및 그림 추가 버튼가 포함된 그룹화된 컨트롤입니다. 이미지가 업로드되지 않은 경우 이미지 컨트롤은 업로드된 이미지 또는 자리 표시자를 표시합니다. 그림 추가 버튼은 이미지를 업로드할지 묻는 메시지를 표시합니다.
Image 속성에 대해서는 이미지 컨트롤 참조를 참조하십시오.
제한 사항
사진 컨트롤에는 이러한 제한 사항이 있습니다.
- iOS에서 사진 추가 컨트롤을 사용하는 경우 카메라 또는 갤러리를 사용하여 가져온 이미지에는 방향, 위치 정보 또는 카메라 설정과 같은 메타데이터가 포함되지 않습니다.
Add picture button 속성
AccessibleLabel – 화면 읽기 프로그램의 레이블입니다. 이미지 추가의 목적을 설명해야 합니다.
Align - 컨트롤의 가로 가운데를 기준으로 한 텍스트의 위치입니다.
BorderColor – 컨트롤의 테두리 색입니다.
BorderStyle – 컨트롤의 테두리는 Solid, Dashed, Dotted, None입니다.
BorderThickness – 컨트롤의 테두리 굵기입니다.
ChangePictureText – 이미지가 업로드되었을 때 단추에 나타나는 텍스트입니다.
Color – 컨트롤의 텍스트 색입니다.
DisabledBorderColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 테두리 색입니다.
DisabledColor – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 텍스트 색입니다.
DisabledFill – 컨트롤의 DisplayMode 속성이 Disabled로 설정된 경우 컨트롤의 배경색입니다.
DisplayMode – 컨트롤이 사용자 입력을 허용(편집)하거나, 데이터만 표시(보기)하거나 사용 안 하도록(사용 안 함) 설정할지 선택합니다.
Error - 이미지를 업로드하는 중에 문제가 있어 이 속성이 적절한 오류 문자열이 포함됩니다.
Fill – 컨트롤의 배경색입니다.
FocusedBorderColor – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 색입니다.
FocusedBorderThickness – 컨트롤에 포커스가 있을 때 컨트롤의 테두리 두께입니다.
Font – 텍스트가 표시되는 글꼴의 제품군 이름입니다.
FontWeight - 컨트롤의 텍스트 굵기입니다. Bold, Semibold, Normal 또는 Lighter입니다.
Height – 컨트롤의 위쪽 및 아래쪽 가장자리 사이의 간격입니다.
HoverBorderColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 테두리 색입니다.
HoverColor – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 텍스트 색입니다.
HoverFill – 사용자가 해당 컨트롤에 마우스 포인터를 올려두는 경우 컨트롤의 배경색입니다.
Italic - 컨트롤의 텍스트를 기울임꼴로 설정할지 여부를 선택합니다.
Media – 오디오 또는 비디오 컨트롤에서 재생하는 클립에 대한 식별자입니다.
OnChange – 사용자가 컨트롤의 값을 변경할 때(예: 슬라이더 조절) 수행할 작업입니다.
OnSelect – 사용자가 컨트롤을 탭하거나 클릭할 때 수행할 작업입니다.
Padding – 가져오기 또는 내보내기 단추의 텍스트와 단추의 가장자리 사이의 간격입니다.
PressedBorderColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 테두리 색입니다.
PressedColor – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 텍스트 색입니다.
PressedFill – 사용자가 컨트롤을 탭하거나 클릭하는 경우 컨트롤의 배경색입니다.
Reset – 컨트롤을 기본값으로 되돌릴지 여부를 선택합니다.
Size – 컨트롤에 표시되는 텍스트의 글꼴 크기입니다.
Strikethrough - 컨트롤에 표시되는 텍스트 중앙에 선을 표시할지 여부를 선택합니다.
TabIndex – 다른 컨트롤에 관련된 키보드 탐색 순서입니다.
Text – 이미지가 업로드되지 않았을 때 단추에 나타나는 텍스트입니다.
Tooltip – 사용자가 컨트롤을 마우스로 가리킬 때 나타나는 설명 텍스트입니다.
Underline – 컨트롤에 표시되는 텍스트 아래에 선을 표시할지 여부를 선택합니다.
UseMobileCamera – 가능한 경우 모바일 카메라를 직접 사용할지 여부입니다. Android 기기의 경우 이 속성을 사용하려면 개선된 미디어 캡처 실험 설정이 켜져 있어야 합니다.
VerticalAlign – 컨트롤의 세로 정렬을 기준으로 한 텍스트의 위치입니다.
Visible – 컨트롤을 표시하거나 숨길지 여부를 선택합니다.
Width – 컨트롤의 왼쪽 및 오른쪽 가장자리 사이의 간격입니다.
X – 컨트롤의 왼쪽 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우는 화면)의 왼쪽 가장자리 사이의 거리입니다.
Y – 컨트롤의 상단 가장자리와 해당 부모 컨테이너(부모 컨테이너가 없는 경우는 화면)의 상단 가장자리 사이의 거리입니다.
관련된 함수
Patch( DataSource, BaseRecord, ChangeRecord )
예제
이미지 갤러리 컨트롤에 이미지 추가
그림 추가 컨트롤을 추가하고 세 번 클릭합니다.
컨트롤을 추가, 이름을 지정하고, 구성하는 방법을 모르시나요?
열기 대화 상자에서 이미지 파일을 클릭하거나 탭한 다음, 열기를 클릭하거나 탭합니다.
버튼 컨트롤을 추가하고 그림 추가 컨트롤 아래로 이동시키고 버튼 컨트롤에 대한 OnSelect 속성을 이 수식으로 설정합니다.
Collect(MyPix, AddMediaButton1.Media)Vertical 갤러리 컨트롤을 추가하고 Items 속성을 MyPix로 설정합니다.
갤러리에서 이미지 컨트롤을 선택하고 Image 속성을 ThisItem.Value로 설정합니다.
F5 키를 누르고 버튼 컨트롤을 클릭하거나 탭합니다.
그림 추가 컨트롤의 이미지가 Vertical 갤러리 컨트롤에 나타납니다. 이미지가 Vertical 갤러리 컨트롤에서 가로 세로 비율이 이미지 와 동일하지 않을 경우, 이미지 컨트롤의 ImagePosition 속성을 Fit로 설정합니다.
그림 추가 컨트롤을 클릭하거나 탭하고 다른 이미지 파일을 클릭하거나 탭하고, 열기를 클릭하거나 탭한 다음, 사용자가 추가한 버튼 컨트롤을 클릭하거나 탭합니다.
두 번째 이미지가 이미지 갤러리 컨트롤에 나타납니다.
(선택 사항) 이전 단계를 1회 이상 반복한 다음, Esc 키를 눌러 기본 작업 영역으로 돌아갑니다.
SaveData 함수를 사용하여 이미지를 로컬에서 저장하거나, Patch 함수를 사용하여 데이터 원본을 업데이트합니다.
접근성 지침
버튼 및 이미지 에 대해 동일한 지침이 적용됩니다. 또한 다음을 고려해야 합니다.
색 대비
- 그림 추가 button에는 텍스트와 배경 사이에 적절한 대비가 있어야 합니다. 업로드된 이미지의 색은 다양할 수 있으므로 그림 추가 button에서 불투명 Fill 을 사용하여 일관적인 대비를 보장합니다.
스크린 리더 지원
- 그림 추가 button에는 사용자에게 이미지를 추가하거나 변경할지 묻는 메시지를 표시하는 Text 및 ChangePictureText가 있어야 합니다.
키보드 지원
- 그림 추가 button에는 키보드 사용자가 탐색할 수 있도록 0 이상의 TabIndex 가 있어야 합니다.
- 그림 추가 button에는 명확하게 표시되는 포커스 표시기가 있어야 합니다. FocusedBorderColor 및 FocusedBorderThickness 를 사용하여 이를 달성합니다.
참고
귀사의 설명서 언어 기본 설정에 대해 말씀해 주시겠습니까? 간단한 설문 조사에 응해주세요. (이 설문 조사는 영어로 되어 있습니다.)
이 설문 조사는 약 7분 정도 걸립니다. 개인 데이터는 수집되지 않습니다(개인정보처리방침).