Kontrolka Karta w Power Apps

Umożliwia wyświetlanie i edytowanie dla jednego pola kontrolki Formularz wyświetlania lub Formularz edycji.

Opis

Kontrolki Formularz wyświetlania i Formularz edycji działają jak kontenery do wyświetlania i przeglądania całych rekordów. Każdy kontener może zawierać zestaw kontrolek Karta, które wyświetlają poszczególne pola lub udostępniają sposób aktualizowania tych pól. Każda karta właściwość DataField, która określa pola rekordu, dla których ona działa.

Wstępnie zdefiniowane karty są określone dla różnych typów danych i wymagań użytkownika. Na przykład może istnieć karta do edytowania pola numerycznego z kontrolką Wprowadzenie tekstu, która doskonale nadaje się do użycia z klawiaturą. Inna karta może obsługiwać edytowanie liczby za pomocą kontrolki Suwak. Po wybraniu kontrolki formularza możesz w okienku po prawej stronie łatwo wybrać kartę na podstawie pola.

Same karty zawierają kontrolki. Kontrolki karty tworzą środowisko do wyświetlania i edytowania pojedynczego pola. Na przykład karta liczby może zawierać kontrolkę Etykieta, aby podać nazwę wyświetlaną pola, i kontrolkę Wprowadzenie tekstu, aby dostarczyć do edytora wartość pola. Karta może mieć również kontrolkę Etykieta, która pokazuje wszelkie błędy walidacji, które wystąpiły, i kontrolkę Etykieta dla typowej gwiazdki, aby pokazać, że pole jest wymagane.

Kontrolki wstępnie zdefiniowanej karty możesz dostosować, zmieniając ich rozmiar, przenosząc je, ukrywając je, dodając do nich kontrolki i wprowadzając inne zmiany. Możesz również rozpocząć od całkiem pustej karty, „karty niestandardowej”, do której możesz dodawać kontrolki od początku.

Wstępnie zdefiniowane karty są domyślnie zablokowane. Na zablokowanej karcie można modyfikować tylko niektóre właściwości karty lub kontrolek na karcie, ale nie możesz usunąć zablokowanej karty. Można wyświetlać blokady karty i je odblokowywać na karcie Widok widoku Zaawansowany. Jeśli właściwość jest zablokowana i nie można jej modyfikować, prawdopodobnie jest ona wyświetlana z ikoną kłódki znajdującą się obok jej nazwy. Odblokowywanie karty to zaawansowane działanie i musi być wykonywane ostrożnie, ponieważ dla karty nie nastąpi już automatyczne generowanie formuły i nie można będzie ponownie zablokować karty.

W kontenerze formularza dostępny jest rekord ThisItem, który zawiera wszystkie pola rekordu. Na przykład właściwość karty Default jest często ustawiana na ThisItem.FieldName.

Możesz użyć odwołania Parent, aby skonfigurować kontrolkę tak, aby odwoływała się do właściwości karty. Na przykład kontrolka powinna używać wartości Parent.Default, aby odczytać początkowy stan pola ze źródła danych. W przypadku użycia odwołania Parent zamiast bezpośredniego dostępu do żądanych informacji karta jest lepiej hermetyzowana i możesz ją zmienić na inne pole bez naruszania wewnętrznych formuł.

Zobacz Omówienie kart danych, aby zapoznać się z przykładami dostosowywania, odblokowywania i tworzenia kart.

Kluczowe właściwości

DataField — nazwa pola w rekordzie, które ta karta pozwala wyświetlać i edytować.

• Określ nazwę jako pojedynczy statyczny ciąg ujęty w znaki podwójnego cudzysłowu (na przykład „Nazwa”), nie formułę.
• Usuń powiązanie karty, ustawiając jej właściwość DataField jako pustą. Właściwości Valid i Update są ignorowane w przypadku niepowiązanych kart.

Default — wstępna wartość kontrolki przed jej zmianą przez użytkownika.

• Dla każdej kontrolki na karcie należy ustawić tę właściwość na Parent.Default, aby odwoływała się do wartości domyślnej pola zgodnie ze źródłem danych. Na przykład ustaw właściwość Default suwaka na Parent.Default, aby upewnić się, że użytkownik rozpocznie od ogólnej wartości dla tego suwaka.

DisplayMode — możliwe wartości to Edit, View lub Disabled. Konfiguruje, czy kontrolka wewnątrz karty zezwala na wprowadzanie danych wejściowych przez użytkownika (Edytuj), czy tylko wyświetla dane (Wyświetl) lub jest wyłączona (Wyłączona).

• Umożliwia używanie pojedynczej karty w formularzach zarówno do edycji, jak i przeglądania, konfigurując tę właściwość, która jest domyślnie powiązana z zachowaniem formularza.
• W trybie Wyświetl kontrolki podrzędne, takie jak Wprowadzenie tekstu, Menu rozwijane i Selektor daty będą wyświetlać tylko samą wartość tekstową i nie będą renderować żadnych elementów interaktywnych ani dekoracji.

DisplayName — przyjazna dla użytkownika nazwa pola źródła danych.

• Funkcja DataSourceInfo zapewnia metadane ze źródła danych.
• Kontrolki w ramach karty powinny używać ustawienia Parent.DisplayName do odwoływania się do nazwy pola.

Error — przyjazny dla użytkownika komunikat o błędzie do wyświetlenia dla tego pola w przypadku niepowodzenia weryfikacji.

• Ta właściwość jest ustawiona, gdy jest wywoływana funkcja SubmitForm.
• Komunikat opisuje problemy weryfikacji na podstawie metadanych źródła danych i sprawdzania właściwości Required karty.

Required — czy karta edytująca pole źródła danych musi zawierać wartość.

• Funkcja DataSourceInfo zapewnia wymagane metadane ze źródła danych.
• Kontrolki w ramach karty powinny używać ustawienia Parent.Required do ustalenia, czy to pole karty jest wymagane.

Update — wartość do zapisania z powrotem do źródła danych dla pola.

• Formuła tej właściwości służy do pobierania wartości z kontrolek edycji karty w celu zapisania z powrotem do źródła danych. Na przykład ustaw właściwość Update karty na Slider.Value, aby zaktualizować źródło danych wartością z suwaka na tej karcie.

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

WidthFit — czy kontrolka automatycznie rozszerza się w poziomie, aby wypełnić całe puste miejsce w kontenerze kontrolki, takiej jak kontrolka Formularz edycji. Jeśli wiele kart ma tę właściwość ustawioną na true, miejsce jest dzielone między nimi. Aby uzyskać więcej informacji, zobacz Omówienie układu formularza danych.

Dodatkowe właściwości

BorderColor – kolor obramowania kontrolki.

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

BorderThickness – grubość obramowania kontrolki.

Fill – kolor tła kontrolki.

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

Valid – czy kontrolka Karta lub Formularz edycji zawiera prawidłowe wpisy, gotowe do wysłania do źródła danych.

Visible – czy kontrolka jest widoczna, czy ukryta.

X — odległość między lewą krawędzią kontrolki a lewą krawędzią jej kontenera nadrzędnego (ekranu, jeśli brak kontenera nadrzędnego). W przypadku kontrolki Karta w kontenerze, który zawiera wiele kolumn, ta właściwość określa kolumnę, w której zostanie wyświetlona karta.

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). W przypadku kontrolki Karta w kontenerze, który zawiera wiele wierszy, ta właściwość określa wiersz, w którym zostanie wyświetlona karta.

Przykłady

Aby przejrzeć przykłady, zobacz Omówienie kart danych i Omówienie układu formularza danych.

Wytyczne dotyczące ułatwień dostępu

Kontrast kolorów

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

• Fill i kontrolki podrzędne. Jeśli na przykład karta zawiera Etykieta z przezroczystym wypełnieniem, właściwość Fill staje się kolorem tła etykiety. Dlatego powinien istnieć odpowiedni kontrast między właściwością Fill karty i właściwością Color etykiety.

Obsługa czytników ekranu

• Należy określić wartość właściwości DisplayName.

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