Udostępnij za pośrednictwem

Kontrolka Wprowadzanie za pomocą pióra w Power Apps

  • Artykuł

Kontrolka, w której użytkownik może rysować, wymazywać i zaznaczać obszary obrazu.

Opis

Użytkownik może użyć tej kontrolki jak tablicy, rysując diagramy i pisząc słowa, które można przekonwertować na tekst.

Ograniczenia

Kontrolka wprowadzania za pomocą pióra ma następujące ograniczenia:

  • Kontrolka pióra tylko częściowo obsługuje rysowanie przy użyciu myszy lub dotyku w aplikacji systemu Windows. Pociągnięcia mogą być przerywane. Aby można było płynnie rysować, użyj pióra lub uruchom aplikację w przeglądarce.

Właściwości klucza

Image — właściwość danych wyjściowych reprezentująca obraz narysowany przez użytkownika końcowego.

Color — kolor pociągnięć wejściowych.

Mode — kontrolka jest w trybie Rysowania lub Wymazywania. Wybór trybu został wycofany.

Dodatkowe właściwości

AccessibleLabel – etykieta dla czytników zawartości ekranu. Może służyć do opisu przeznaczenia kontrolki, a także jako alternatywna metoda wprowadzania danych wejściowych.

BorderColor – kolor obramowania kontrolki.

BorderStyle – rodzaj obramowania kontrolki: Ciągłe, Kreskowane, Kropkowane lub Brak.

BorderThickness – grubość obramowania kontrolki.

DisplayMode – czy kontrolka zezwala na wprowadzanie danych wejściowych przez użytkownika (Edytuj), czy tylko wyświetla dane (Wyświetl) lub jest wyłączona (Wyłączone).

Fill – kolor tła kontrolki.

Height – odległość między górną i dolną krawędzią kontrolki.

Input — przestarzałe. Czy wprowadzanie danych odbywa się za pomocą myszy, pióra lub dotyku. Wartość domyślna (7) obsługuje wszystkie trzy metody.

OnSelect — akcje do wykonania po naciśnięciu lub kliknięciu formantu przez użytkownika.

SelectionColor — kolor tekstu zaznaczonego elementu lub elementów listy albo kolor narzędzia zaznaczania w kontrolce pióra.

SelectionThickness — grubość narzędzia zaznaczania dla kontrolki wprowadzania piórem.

ShowControls — czy odtwarzacz audio lub wideo pokazuje, na przykład, przycisk odtwarzania i suwak głośności, a kontrolka pióra pokazuje, na przykład, ikony rysowania, usuwania i czyszczenia.

Size — rozmiar czcionki tekstu wyświetlanego w kontrolce.

Tooltip – tekst objaśnienia wyświetlany po umieszczeniu wskaźnika myszy na kontrolce.

Visible – czy kontrolka jest widoczna, czy ukryta.

Width – odległość między lewą i prawą krawędzią kontrolki.

X — odległość między lewą krawędzią kontrolki a lewą krawędzią jej kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).

Y — odległość między górną krawędzią kontrolki a górną krawędzią kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego).

Collect( CollectionName, DatatoCollect )

Przykład

Tworzenie zestawu obrazów

  1. Dodaj kontrolkę Wprowadzanie za pomocą pióra, nadaj jej nazwę MyDoodles i ustaw jej właściwość ShowControls na prawda.

    Nie wiesz, jak dodać, nazwać i skonfigurować kontrolkę?

  2. Dodaj kontrolkę Przycisk, przenieś ją poniżej kontrolki MyDoodles i ustaw właściwość Text kontrolki Przycisk tak, aby wyświetlić Dodaj.

  3. Ustaw właściwość OnSelect kontrolki Przycisk na następującą formułę:
    Zbierz (Doodles {Sketch:MyDoodles.Image})

  4. Dodaj kontrolkę Galeria obrazów, przenieś ją poniżej kontrolki Przycisk i zmniejsz szerokość kontrolki Galeria obrazów, aż pokaże ona trzy elementy.

  5. Ustaw właściwość Items kontrolki Galeria obrazów na Doodles, a następnie naciśnij klawisz F5.

  6. Narysuj obraz w kontrolce MyDoodles, a następnie kliknij lub naciśnij kontrolkę Przycisk.

    Narysowany obraz pojawi się w kontrolce Galeria obrazów.

  7. (opcjonalnie) W kontrolce Wprowadzanie za pomocą pióra kliknij lub naciśnij ikonę, aby wyczyścić narysowany obraz, narysować inny obraz, a następnie kliknij lub naciśnij kontrolkę Przycisk.

  8. W kontrolce Galeria obrazów ustaw właściwość OnSelect kontrolki Obraz na następującą formułę:
    Remove(Doodles, ThisItem)

  9. Usuń rysunek, klikając lub naciskając go w kontrolce Galeria obrazów.

Użyj funkcji SaveData, aby zapisać rysunki lokalnie, lub funkcji Patch, aby zapisać je do źródła danych.

Wytyczne dotyczące ułatwień dostępu

Kontrast kolorów

Między poniższymi kolorami musi istnieć odpowiedni kontrast:

  • kolor określony we właściwości BorderColor i kolor na zewnątrz kontrolki (jeśli występuje obramowanie)
  • kolor określony we właściwości Fill i kolor na zewnątrz kontrolki (jeśli nie ma obramowania)

Obsługa czytników ekranu

  • Należy podać wartość właściwości AccessibleLabel.

    Ważne

    Właściwość Wprowadzanie za pomocą pióra nie jest dostępna dla użytkowników czytników zawartości ekranu. Zawsze zapewnij możliwość skorzystania z alternatywnej formy wprowadzania danych wejściowych. Jeśli na przykład wymagany jest szkic, należy rozważyć dodanie kontrolki Dodaj obraz, która umożliwia przekazanie obrazu. Można udostępnić obie metody, a użytkownik wybierz tę, która mu bardziej odpowiada.

Obsługa klawiatury

Ważne

Właściwość Wprowadzanie za pomocą pióra nie jest dostępna dla użytkowników korzystających z klawiatury. Zawsze zapewnij możliwość skorzystania z alternatywnej formy wprowadzania danych wejściowych. Jeśli na przykład wymagany jest podpis, rozważ dodanie kontrolki Wprowadzenie tekstu, która umożliwi użytkownikowi podanie swojego imienia i nazwiska. Można udostępnić obie metody, a użytkownik wybierz tę, która mu bardziej odpowiada.

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).