Budowa pliku .xaml

Pliki .xaml w rozwiązaniu Data Standard zawierają podstawowe komponenty, które tworzą okno dialogowe funkcji Data Standard, takie jak tabele, pola kombi, etykiety, pola tekstowe i przyciski. Firma Autodesk zaleca zapoznanie się z tymi komponentami przed dostosowaniem lub utworzeniem własnych okien dialogowych rozwiązania Data Standard.

Uwaga: Wiele z tych komponentów zawiera bardziej złożone parametry niż opisane w tym temacie. Ten temat dotyczy podstawowych zachowań tych komponentów.

Tabela

Tabela to panel układu sterujący wszystkimi elementami w strukturze tabelarycznej wierszy i kolumn. Wszystkie komórki (komórka jest unikatowa z powodu kombinacji wiersza i kolumny) mogą zawierać wiele elementów sterujących, takich jak etykiety i pola tekstowe.

Jest to podstawowa struktura tabeli. Tabela wymaga utworzenia wierszy, które można zdefiniować w części Grid.RowDefinition. Wysokość 30 określa stałą wartość wysokości i nie można jej później zmienić. Wartość „auto” umożliwia określenie dynamicznej wysokości wiersza, więc, w zależności od elementów sterujących, może on być wyższy lub niższy. Te same wartości dotyczą szerokości kolumny.

Elementy sterujące

Po zdefiniowaniu wierszy i kolumn można dodać elementy sterujące takie jak etykiety i pola tekstowe. Elementy sterujące muszą być dołączone do dwóch właściwości: Grid.Column i Grid.Row. Te właściwości określają położenie elementu sterującego w tabeli. Pierwszy wiersz ma wartość 0, drugi ma wartość 1 .itd.

Wszystkie poniższe elementy to elementy sterujące.
  • Etykiety

    Etykiety to nazwy pól, których nie można edytować. Zawierają one tekst określający funkcję etykiety, dzięki czemu użytkownik wie, jakiego typu wartość należy wstawić w odpowiednim polu tekstowym lub polu kombi. Przykładowo: etykieta o nazwie Komentarze może znajdować się obok pustego pola tekstowego. Użytkownik może wpisać w tym polu odpowiedź na dowolny komentarz.

    Etykieta ma właściwość Content. Ta właściwość to wyświetlany tekst etykiety.

    <Label Grid.Row ="0" Grid.Colum="0" Content="sample" />
    
  • Pola tekstowe

    Pola tekstowe to pola, które można edytować. Użytkownik może wprowadzić tekst w polu tekstowym. W rozwiązaniu Data Standard można odczytać wprowadzoną wartość i użyć jej do wykonania innych operacji.

    Pole tekstowe musi mieć następujące właściwości:
    • Text: początkowy tekst wyświetlany w polu tekstowym jako przykład. W przypadku zapisania content="Wprowadź komentarze tutaj" pole tekstowe zawiera początkowo tekst „Wprowadź komentarze tutaj” i nie jest puste.
    • Name: umożliwia pobranie lub ustawienie nazwy identyfikującej element. Nazwa zawiera odwołanie, więc jej kod, na przykład kod programu obsługi zdarzeń, może zapewniać odwołanie do elementu.
    <TextBox Grid.Row="0" Grid.Column="0" Text="{Binding Prop[State].Value}" Name="testtextfield" />
    
  • ComboBox

    Pola kombi to pola, których nie można edytować, ale pozwalają one użytkownikowi na wybranie opcji bezpośrednio z listy. Po skonfigurowaniu można wyodrębnić tę wartość w celu użycia w kolejnych operacjach.

    Pole kombi wymaga następujących właściwości dodatkowych:
    • Itemsource w przypadku tego elementu sterującego określa lokalizację pobierania listy wartości dostępnych do wyboru przez użytkownika.
    • Text: początkowy tekst wyświetlany w polu kombi jako przykład. Po zapisaniu content="Stany Zjednoczone" domyślną opcją wyświetlaną w polu kombi będzie wartość „Stany Zjednoczone”.
    • Name: umożliwia pobranie lub ustawienie nazwy identyfikującej element. Nazwa zawiera odwołanie, więc jej kod, na przykład kod uchwytu zdarzeń, może zapewniać odwołanie do elementu.
    <ComboBox Name="MaterialCombo" Text="{Binding Prop[Cost].Value}" Grid.Column="3" Grid.Row="6" ItemsSource="{Binding Prop[Cost].ListValues}"/>
  • Buttons

    Przycisk to element interfejsu użytkownika umożliwiający użycie funkcji takiej jak Wyszukaj lub Zapisz.

    Przycisk wymaga właściwości Command. Ta właściwość określa akcję wykonywaną po kliknięciu przycisku.

Binding

Aby użyć tych komponentów do sterowania właściwościami pliku programu Vault lub wprowadzenia ich zmian, należy zapoznać się z właściwością „{Binding Prop[cost].Value}”. Wiązanie umożliwia przypisanie wartości do określonych właściwości pliku programu Vault. Można na przykład powiązać tekst w polu tekstowym z właściwością kosztu w programie Vault, aby po każdym wprowadzeniu danych w tym polu tekstowym właściwość Cost była automatycznie aktualizowana w programie Vault. Powiązanie to doskonały sposób na automatyzację zmian właściwości, co ogranicza liczbę czynności wykonywanych przez użytkownika.

Prop [ ]

Prop[] jest najważniejszą funkcją dotyczącą wiązania. Dzięki niej można uzyskać dostęp do właściwości pliku w repozytorium. Aby przypisać pole tekstowe do właściwość Inżynier, wpisz: <TextBox text="{Binding Prop[Inżynier].value}"/>. Po utworzeniu pola tekstowego funkcja Prop[] zwraca wartość tej właściwości. Po każdej aktualizacji pola tekstowego następuje powiadomienie funkcji Prop[ ], która zapisuje nową wartość w przypisanej właściwości pliku.