Tworzenie nowoczesnej kontrolki w aplikacjach kanwy

Użyj nowoczesnego formularza do wyświetlania, edytowania i tworzenia rekordów w źródle danych.

Description

Nowoczesna kontrolka Formularz umożliwia użytkownikom wyświetlanie pojedynczego rekordu i pracę z jednym rekordem ze źródła danych. Dodaj formularz Edytuj , aby umożliwić użytkownikom tworzenie rekordu lub edytowanie istniejącego i zapisywanie zmian. Możesz też dodać formularz Wyświetlania , aby wyświetlić rekord jako tylko do odczytu. Nowoczesny formularz jest oparty na systemie projektowym Microsoft Fluent 2, dzięki czemu używa zaktualizowanych ustawień stylów, odstępów i ułatwień dostępu. Dostosowuje układ do różnych rozmiarów ekranu.

Każde pole w rekordzie jest wyświetlane w formularzu. Wybierasz kolumny, które mają być wyświetlane, oraz kolejność ich wyświetlania. Po wybraniu pola możesz zmienić kolumnę, z którą jest powiązana, oraz sposób wyświetlania wartości.

Kluczowe właściwości tej kontrolki to DataSource, Item i DefaultMode.

Nowoczesny i klasyczny formularz

Nowoczesna kontrolka Formularz oraz klasyczna kontrolka Formularz edycji i Formularz wyświetlaniaużywają tego samego bazowego modelu formularza. Należy ustawić te same właściwości źródła danych i elementu . Do sterowania formularzem używasz tych samych funkcji - formularzySubmitForm, NewForm, EditForm, ViewForm i ResetForm. Istniejąca wiedza i formuły są przenoszone.

Nowoczesna forma różni się od klasycznej formy na następujące sposoby:

  • Używa systemu projektowego Microsoft Fluent 2 w celu zapewnienia spójnego, nowoczesnego wyglądu.
  • Stosuje odstępy dynamiczne i układ, które dopasowują się do dostępnej szerokości.
  • Zapewnia zaktualizowane wartości domyślne ułatwień dostępu, takie jak jaśniejszy wskaźnik pola wymaganego.

Obsługiwane są zarówno klasyczne, jak i nowoczesne formularze, dzięki czemu można wybrać ten, który pasuje do aplikacji. Aby użyć nowoczesnych kontrolek, włącz nowoczesne kontrolki i motywy w ustawieniach aplikacji.

Kluczowe funkcje

Nowoczesna kontrolka Formularz zapewnia następujące możliwości:

  • Microsoft Projektu Fluent 2: Pola, etykiety i komunikaty weryfikacji używają systemu projektowego Fluent 2 do czystego, spójnego wyglądu zgodnego z resztą nowoczesnej aplikacji.
  • Układ dynamiczny: formularz dostosowuje odstępy i układ do dostępnej szerokości, dzięki czemu działa na pulpicie, tablecie i urządzeniach przenośnych bez ręcznego zmieniania położenia.
  • Motyw: formularz jest zgodny z motywem aplikacji, dzięki czemu można stylować formularze spójnie z jednego miejsca.
  • Wbudowane ułatwienia dostępu: formularz udostępnia dostępne wartości domyślne, w tym jasny wskaźnik pola wymaganego i obsługę czytnika zawartości ekranu.
  • Znany model formularza: formularz używa tych samych właściwości DataSource, Item i DefaultMode oraz tych samych funkcji formularza co formularz klasyczny, dzięki czemu istniejące wzorce i formuły są przenoszone.

Ogólne

DataSource — źródło danych zawierające rekord, w którym formularz jest wyświetlany lub edytowany. Źródło danych udostępnia również nazwy wyświetlane i walidację kolumn, takie jak pola, które są wymagane.

Item — rekord do wyświetlania lub edytowania. Na przykład ustaw pozycję Element na wybrany element galerii lub na funkcję, taką jak First(Accounts) lub LookUp(Accounts, "Fabrikam" in name). W trybie Nowy właściwość Item jest ignorowana, a formularz wyświetla wartości domyślne ze źródła danych.

DefaultMode — początkowy tryb formularza. Akceptuje wartości wyliczenia FormMode :

Value Description
FormMode.Edit Formularz edytuje rekord we właściwości Item . Domyślne.
FormMode.New Formularz tworzy rekord, zaczynając od wartości domyślnych źródła danych.
FormMode.View Formularz wyświetla rekord we właściwości Item jako tylko do odczytu.

Behavior

OnSuccess — akcje do wykonania, gdy operacja danych zakończy się powodzeniem po uruchomieniu funkcji SubmitForm .

OnFailure — akcje do wykonania, gdy operacja danych kończy się niepowodzeniem po uruchomieniu funkcji SubmitForm .

OnReset — akcje, które mają być wykonywane, gdy formularz jest resetowany, na przykład po uruchomieniu polecenia ResetForm .

DisplayMode — określa, czy kontrolka zezwala na wprowadzanie danych (Edycja), wyświetla tylko dane (Widok), czy jest wyłączona (wyłączone). Tryb formularza określa tę wartość.

Visible — określa, czy kontrolka jest wyświetlana, czy ukryta.

Właściwości danych wyjściowych

Mode — bieżący tryb formularza: Edycja, Nowy lub Widok.

Niezapisane — czy formularz ma zmiany, których użytkownik jeszcze nie zapisał. Użyj tej właściwości, aby ostrzegać użytkowników przed odejściem od niezapisanych edycji.

Updates — rekord wartości w polach formularza, gotowy do przekazania do funkcji, takiej jak Patch.

Prawidłowe — czy wszystkie pola w formularzu, w tym wymagane pola, obecnie przechowują prawidłowe wartości.

Error — przyjazny dla użytkownika komunikat o błędzie wyświetlany w przypadku niepowodzenia operacji danych. Dostępne po uruchomieniu onFailure .

ErrorKind — rodzaj błędu, który wystąpił, wyrażony jako wartość wyliczeniowa ErrorKind .

LastSubmit — ostatni pomyślnie przesłany rekord, w tym wszystkie wartości wygenerowane przez serwer, takie jak identyfikator. Dostępne po uruchomieniu polecenia OnSuccess .

Praca z formularzem

Użyj funkcji formularza , aby zmienić tryb formularza i zapisać zmiany. Ustaw te formuły we właściwości OnSelect przycisków.

  • Przełącz się do trybu Nowy , aby użytkownik mógł utworzyć rekord:

    NewForm(Form1)

  • Przejdź do trybu edycji , aby zmienić rekord we właściwości Item :

    EditForm(Form1)

  • Przełącz się do trybu Wyświetl , aby wyświetlić rekord jako tylko do odczytu:

    ViewForm(Form1)

  • Zapisz zmiany w formularzu w źródle danych:

    SubmitForm(Form1)

  • Odrzuć zmiany w toku i zresetuj formularz do wartości domyślnych:

    ResetForm(Form1)

Po uruchomieniu funkcji SubmitForm formularz weryfikuje wymagane pola przed zapisem w źródle danych. Jeśli walidacja zakończy się pomyślnie, formularz zapisze rekord i uruchomi polecenie OnSuccess. W przypadku niepowodzenia formularz uruchamia polecenie OnFailure i ustawia właściwości Error i ErrorKind .

Ostatnie ulepszenia

Najnowsze wersje dodały następujące ulepszenia nowoczesnej kontrolki Formularz :

  • Nowe szablony ekranu: Zaktualizowane szablony ekranu zapewniają domyślny odstęp między formularzem i nagłówkiem, wypełnieniem i tekstem opisu podczas dodawania ekranu opartego na formularzach.
  • Jaśniejsze wymagane pola: wskaźnik wymaganego pola jest wyświetlany na czerwono, dzięki czemu użytkownicy mogą łatwiej wykrywać wymagane pola.
  • Spójna typografia: Rozmiar czcionki i pogrubione style są spójne w polach i etykietach formularza.
  • Nazwy wyświetlane dla pól osób: pole osoby lub grupy wyświetla nazwę wyświetlaną wybranego użytkownika zamiast identyfikatora.
  • Niezawodne pola dat: pole daty zachowuje swoją wartość, gdy formularz przełącza się do trybu edycji .
  • Dokładna walidacja: Weryfikacja pola wymaganego pozostaje dokładna, gdy zmienia się powiązane źródło danych formularza.

Zobacz także

  • Ostatnia aktualizacja o