Контрола Въвеждане с писалка в Power Apps
Контрола, в който потребителят може да рисува, изтрива и маркира области на изображение.
Описание
Потребителят може да използва това управление като бяла дъска, да рисува диаграми и да пише думи, които могат да бъдат преобразувани във въведен текст.
Ограничения
Контролата за въвеждане на перо има следните ограничения:
- Контролата на перото има само частична поддръжка за рисуване с помощта на мишка или въвеждане с докосване в приложението Windows. Щрихите може да са прекъснати. За гладко рисуване използвайте химикалка или стартирайте приложението в браузър.
Свойства на ключове
Image - Свойство на изхода, което представлява изображението, начертано от крайния потребител.
Color - Цветът на входните щрихи.
Mode – Контролата е в режим Чертане или Изтриване. Избраният режим е оттеглен.
Допълнителни свойства
AccessibleLabel - Етикет за четци на екрани. Може да се използва за описание на целта на контрола, както и алтернативни методи за въвеждане.
BorderColor – Цветът на границата на контролата.
BorderStyle – Дали границата на контрола е солидна, с тирета, с точки или няма.
BorderThickness – Дебелината на границата на контролата.
DisplayMode – Дали контрола позволява въвеждане от потребителя (редактиране), показва само данни (изглед) или е деактивирана (Забранено).
Fill – Цветът на запълване в контрола.
Height - Разстоянието между горния и долния ръб на контрола.
Input - Отхвърлено. Дали входът поддържа входове за мишка, писалка или докосване. Стойността по подразбиране (7) поддържа и трите.
OnSelect – Действия, които се извършват, когато потребителят докосне или щракне върху контрола.
SelectionColor - Цветът на текста на избран елемент или елементи в списък или цветът на инструмента за избор в контрола за писалка.
SelectionThickness - Дебелината на инструмента за избор за управление на вписване с писалка.
ShowControls - Независимо дали аудио или видео плейърът показва например бутон за възпроизвеждане и плъзгач за сила на звука, а контролът на писалката показва например икони за рисуване, изтриване и изчистване.
Size - Размерът на шрифта на текста, който се появява на контрола.
Tooltip - Обяснителен текст, който се появява, когато потребителят задържи курсора над контрола.
Visible - Дали се появява контрола, или е скрита.
Width - Разстоянието между левия и десния ръб на контрола.
X - Разстоянието между левия ръб на контрола и левия ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер).
Y - Разстоянието между горния ръб на контрола и горния ръб на неговия родителски контейнер (или екрана, ако няма родителски контейнер).
Свързани функции
Collect( CollectionName, DatatoCollect )
Пример
Създайте набор от изображения
Добавете контрола за Pen input, дайте й име MyDoodles, и задайте нейното свойство ShowControls на вярно.
Не знаете как да добавяте, назовавате и конфигурирате контрола?
Добавете контрола Button, преместете я под MyDoodles, и задайте свойството Text на контролата Button да показва Добави.
Задайте свойството OnSelect на контролата Button на тази формула:
Collect(Doodles, {Sketch:MyDoodles.Image})Добавете контрола Image gallery, преместете я под контрола Button и свийте ширината на Image gallery контрола, докато не покаже три елемента.
Задайте свойството Items на Image gallery контрола до Doodles и след това натиснете F5.
Начертайте изображение в MyDoodles и след това щракнете или докоснете контролата Button.
Изображението, което сте нарисували, се появява в контролата Image gallery.
(незадължително) В контролата Pen input, щракнете или докоснете иконата, за да изчистите изображението, което сте нарисували, нарисувайте друго изображение и след това щракнете или натиснете върху контролата Button.
В контролата Image gallery задайте свойството OnSelect на контролата Image на тази формула:
Remove(Doodles, ThisItem)Премахнете чертежа, като щракнете или го докоснете в контролата Image gallery.
Използвайте функцията SaveData за записване на чертежите ви локално или функцията Patch за записването им в източник на данни.
Насоки за достъпност
Контраст на цвят
Трябва да има достатъчен цветен контраст между:
- BorderColor и цветът извън контролата (ако има граница)
- Fill и цветът извън контролата (ако няма граница)
Поддръжка на екранен четец
AccessibleLabel трябва да е налице.
Важно
Pen input не е достъпен за потребителите на екранен четец. Винаги предоставяйте алтернативна форма на въвеждане. Например, ако е необходима скица, помислете за добавяне на контрола Add picture на потребителите за качване на изображение. И двата метода могат да бъдат предложени и потребителят може да избере този, с който е по-удобен.
Поддръжка на клавиатурата
Важно
Pen input не е достъпно за потребителите на клавиатура. Винаги предоставяйте алтернативна форма на въвеждане. Например, ако се изисква подпис, помислете за добавяне на Text input за потребителите да въведат името си. И двата метода могат да бъдат предложени и потребителят може да избере този, с който е по-удобен.
Бележка
Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)
Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).
Обратна връзка
https://aka.ms/ContentUserFeedback.
Очаквайте скоро: През цялата 2024 г. постепенно ще отстраняваме проблемите в GitHub като механизъм за обратна връзка за съдържание и ще го заменим с нова система за обратна връзка. За повече информация вижте:Подаване и преглед на обратна връзка за