Udostępnij za pośrednictwem

Kontrolka Załączniki w Power Apps

  • Artykuł

Kontrolka umożliwiający użytkownikom pobieranie plików na swoje urządzenie oraz przekazywanie i usuwanie plików z listy utworzonej przy użyciu list Microsoft Lists lub tabeli Microsoft Dataverse.

opis

Kontrolka Załączniki pozwala otwierać, dodawać i usuwać pliki na listach i w tabeli Dataverse.

Ograniczenia

Kontrolka attachment ma następujące ograniczenia:

  1. Kontrolka attachment obsługuje tylko listy i tabele Dataverse jako źródła danych. Wyrażenia, które przekształcają te źródła danych w tabele, na przykład za pomocą funkcji ForAll, nie są obsługiwane.

  2. Funkcje przekazywania i usuwania działają tylko wewnątrz formularza. Kontrolka Załączniki będzie wyglądała na wyłączoną podczas pracy w trybie edycji poza formularzem. Aby można było zapisać Dodatki i usunięcia pliku, użytkownik aplikacji musi zapisać formularz. Z powodu tego ograniczenia formant Attachment nie jest dostępny z poziomu karty Wstawianie, ale jest wyświetlany w formularzu, kiedy włączone jest pole formularza Załącznik w formularzu SharePoint lub Dataverse.

  3. Kontrolka Załączniki w przeglądarce sieci Web umożliwia wybieranie wielu plików oraz używanie funkcji przeciągania i upuszczania. Jednak używając formantu Załączniki w aplikacji Power Apps Mobile, można dodawać tylko po jednym pliku.

Kluczowe właściwości

Items — kolumna Załącznika listy lub tabeli Dataverse. Collections i Tables nie są obsługiwane.

MaxZałączniki — maksymalna liczba plików akceptowanych przez kontrolkę.

MaxAttachmentSize — maksymalny dozwolony rozmiar pliku (w MB) każdego nowego załącznika. 1 MB to 1000000 bajtów (106 B) lub 1000 KB.

OnAddFile — akcje do wykonania po dodaniem przez użytkownika nowego załącznika pliku.

OnRemoveFile — akcje do wykonania, gdy użytkownik usuwa istniejący załącznik.

OnUndoRemoveFile — akcje do wykonania, gdy użytkownik przywraca usunięty załącznik.

Dodatkowe właściwości

AccessibleLabel – etykieta dla czytników zawartości ekranu. Powinna opisywać przeznaczenie załączników.

AddAttachmentText — tekst etykiety dla linku służącego do dodawania nowego załącznika.

BorderColor – kolor obramowania kontrolki.

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

BorderThickness – grubość obramowania kontrolki.

Color — kolor tekstu w kontrolce.

DisabledBorderColor – kolor obramowania kontrolki, jeśli właściwość DisplayMode kontrolki jest ustawiona na wartość Wyłączone.

DisabledColor – kolor tekstu w kontrolce, jeśli jej właściwość DisplayMode jest ustawiona na wartość Wyłączone.

DisabledFill – kolor tła kontrolki, jeśli jej właściwość DisplayMode jest ustawiona na wartość Wyłączone.

DisplayMode — czy kontrolka zezwala na dodawanie i usuwanie plików (Edytuj), czy tylko wyświetla dane (Wyświetl) lub jest wyłączona (Wyłączone).

[DropTargetBackgroundColor]— Kolor tła docelowego upuszczania kontrolki.

[DropTargetBorderColor]— Kolor obramowania celu upuszczania kontrolki.

[DropTargetBorderStyle] – Określa, czy obramowanie elementu docelowego upuszczania jest Pełne, kreskowany, Kropkowane czy Brak.

[DropTargetBorderThickness]— Grubość obramowania celu upuszczania kontrolki.

[DropTargetTextColor]— Kolor tekstu docelowego upuszczania kontrolki.

Fill – kolor tła kontrolki.

FocusedBorderColor – kolor obramowania kontrolki z fokusem.

FocusedBorderThickness – grubość obramowania kontrolki z fokusem.

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

Font — nazwa rodziny czcionek używanej do wyświetlania tekstu.

FontWeight — grubość tekstu w kontrolce: Pogrubiony, Półpogrubiony, Normalny lub Cieńszy.

HoverBorderColor – kolor obramowania kontrolki po umieszczeniu na niej wskaźnika myszy.

HoverColor – kolor tekstu w kontrolce po umieszczeniu na niej wskaźnika myszy.

HoverFill – kolor tła kontrolki po umieszczeniu na niej wskaźnika myszy.

Italic — czy tekst w kontrolce jest pochylony.

MaxZałącznikiText — tekst zastępujący link „Dołącz plik”, gdy kontrolka zawiera maksymalną dozwoloną liczbę plików.

NoAttachmentsText — tekst informacyjny pokazywany użytkownikowi, gdy nie ma dołączonych plików.

Padding — odległość między tekstem na przycisku importowania lub eksportowania a krawędziami tego przycisku.

PressedBorderColor – kolor krawędzi kontrolki, gdy użytkownik wybierze tę kontrolkę.

PressedColor — kolor tekstu, gdy użytkownik wybierze tę kontrolkę.

PressedFill – kolor tła kontrolki, gdy użytkownik wybierze tę kontrolkę.

Reset — powoduje powrót wszystkich zmian do kontrolki Załączniki, które są zwracane do zapisanego wcześniej stanu.

Size — rozmiar czcionki tekstu wyświetlanego w kontrolce.

Strikethrough — czy przez tekst widoczny na kontrolce przebiega linia.

TabIndex — kolejność nawigacji za pomocą klawiatury w odniesieniu do innych kontrolek.

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

Underline — czy pod tekstem widocznym na kontrolce przebiega linia.

Visible – określa, 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 (lubekranu, jeśli brak kontenera nadrzędnego).

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

Przykład

  1. Możesz dodać formularz do aplikacji i ustawić listę jako źródło danych.

  2. Wybierz kontrolkę Formularz wyświetlania w widoku drzewa po lewej stronie. Zamiast tego można też użyć Formularz edycji.

  3. Wybierz opcję Źródło danych na karcie właściwości w panelu opcje po prawej stronie, a następnie wybierz listę, z którą połączono.

  4. Wybierz Edytuj pola w sekcji Pola i wybierz opcję Dodaj pole.

  5. Wybierz Załączniki, a następnie wybierz opcję Dodaj.

    W formularzu zostanie wyświetlone pole Załączniki skojarzone z listą.

Dowiedz się, jak dodawać i konfigurować kontrolkę

Wytyczne dotyczące ułatwień dostępu

Kontrast kolorów

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

  • ItemColor i ItemFill
  • ItemHoverColor i ItemHoverFill
  • ItemPressedColor i ItemPressedFill
  • AddedItemColor i AddedItemFill
  • RemovedItemColor i RemovedItemFill
  • ItemErrorColor i ItemErrorFill
  • AddAttachmentColor i Fill
  • MaxAttachmentsColor i Fill
  • NoAttachmentsColor i Fill

Ten wymóg to uzupełnienie standardowych wymagań dotyczących kontrastu kolorów.

Obsługa czytników ekranu

Należy zdefiniować następujące właściwości:

Obsługa klawiatury

  • Właściwość TabIndex musi mieć wartość zero lub większą, dzięki czemu użytkownicy korzystający z klawiatury mogą przejść do kontrolki.
  • Wskaźniki fokusu muszą być wyraźnie widoczne. Aby to zapewnić, skorzystaj z właściwości FocusedBorderColor i FocusedBorderThickness.

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).