Definiowanie zestawów zaznaczeń

Podczas tworzenia wielu widoków i kontrolek można zdefiniować zestawy obiektów, które są nazywane zestawami wyboru. Zestaw wyboru umożliwia zdefiniowanie obiektów jeden raz bez konieczności wielokrotnego definiowania ich dla każdego widoku lub kontrolki. Zazwyczaj zestawy wyboru są używane, gdy masz zestaw powiązanych obiektów .NET. Na przykład plik formatowy (FileSystem.format.ps1xml) definiuje zestaw wyboru typów systemu plików, z których korzysta FileSystem kilka widoków.

Gdzie zestawy wyboru są zdefiniowane i przywołyowane

Zestawy wyboru definiuje się jako część wspólnych danych, które mogą być używane przez wszystkie widoki i kontrolki zdefiniowane w pliku formatowania. W poniższym przykładzie pokazano, jak zdefiniować trzy zestawy wyboru.

<Configuration>
  <SelectionSets>
    <SelectionSet>...</SelectionSet>
    <SelectionSet>...</SelectionSet>
    <SelectionSet>...</SelectionSet>
  </SelectionSets>
</Configuration>

Odwołania do zestawów wyboru można odwoływać się w następujący sposób:

• Każdy widok ma ViewSelectedBy element, który definiuje, które obiekty są wyświetlane przy użyciu widoku. Element ViewSelectedBy ma element podrzędny, który określa zestaw wyboru, z których korzystają wszystkie SelectionSetName definicje widoku. Nie ma żadnych ograniczeń dotyczących liczby zestawów wyboru, do których można się odwoływać z widoku.

• W każdej definicji widoku lub kontrolki element definiuje, które obiekty są EntrySelectedBy wyświetlane przy użyciu tej definicji. Zazwyczaj widok lub kontrolka ma tylko jedną definicję, więc obiekty są definiowane przez ViewSelectedBy element . Element EntrySelectedBy definicji ma element SelectionSetName podrzędny, który określa zestaw wyboru. Jeśli określisz zestaw wyboru dla definicji, nie można określić żadnych innych elementów podrzędnych EntrySelectedBy elementu.

• W każdej definicji widoku lub kontrolki element może służyć do określania warunku, kiedy SelectionCondition definicja jest używana. Element SelectionCondition ma element SelectionSetName podrzędny, który określa zestaw wyboru, który wyzwala warunek. Warunek jest wyzwalany, gdy zostaną wyświetlone obiekty zdefiniowane w zestawie wyboru. Aby uzyskać więcej informacji na temat sposobu ustawienia tych warunków, zobacz Definiowanie warunków wyświetlania danych.

Przykład zestawu wyboru

W poniższym przykładzie pokazano zestaw wyboru, który jest owijany bezpośrednio z pliku FileSystem formatowania dostarczonego przez Windows PowerShell. Aby uzyskać więcej informacji na temat innych Windows PowerShell formatowania plików, zobacz Windows PowerShell plików formatowania.

<SelectionSets>
  <SelectionSet>
    <Name>FileSystemTypes</Name>
    <Types>
     <TypeName>System.IO.DirectoryInfo</TypeName>
     <TypeName>System.IO.FileInfo</TypeName>
     <TypeName>Deserialized.System.IO.DirectoryInfo</TypeName>
     <TypeName>Deserialized.System.IO.FileInfo</TypeName>
    </Types>
  </SelectionSet>
</SelectionSets>

Poprzedni zestaw wyboru jest przywołyny w ViewSelectedBy elemencie widoku tabeli.

<ViewDefinitions>
  <View>
    <Name>Files</Name>
    <ViewSelectedBy>
      <SelectionSetName>FileSystemTypes</SelectionSetName>
    </ViewSelectedBy>
    <TableControl>...</TableControl>
  </View>
</ViewDefinitions>

Elementy XML

Nie ma żadnego ograniczenia liczby zestawów wyboru, które można zdefiniować. Następujące elementy XML są używane do tworzenia zestawu wyboru.

• Element SelectionSets definiuje zestawy obiektów .NET, do których odwołują się widoki i kontrolki pliku formatowego.

• Element SelectionSet definiuje pojedynczy zestaw obiektów .NET.

• Nazwa element określa nazwę, która jest używana do odwołania do zestawu wyboru.

• Typy element określa typy .NET obiektów zestawu wyboru. (W plikach formatowania obiekty są określane przez ich typ .NET).

Następujące elementy XML służą do określania zestawu wyboru.

• Poniższy element określa zestaw wyboru do użycia we wszystkich definicjach widoku:

  • SelectionSetName, element — ViewSelectedBy (format)

  • SelectionSetName, element — EntrySelectedBy, GroupBy (format)

• Następujące elementy określają zestaw wyboru używany przez pojedynczą definicję widoku:

  • SelectionSetName, element — EntrySelectedBy, ListControl (format)

  • SelectionSetName, element — EntrySelectedBy, TableControl (format)

  • SelectionSetName, element — EntrySelectedBy, WideControl (format)

  • SelectionSetName, element — EntrySelectedBy, CustomControl, View (format)

• Następujące elementy określają zestaw wyboru używany przez definicje kontrolek wspólnych i widoków:

  • SelectionSetName, element — EntrySelectedBy, Controls, View (format)

  • SelectionSetName, element — EntrySelectedBy, Controls, Configuration (format)

• Następujące elementy określają zestaw wyboru używany podczas definiowania obiektu do rozwinięcia:

  • SelectionSetName, element — EntrySelectedBy, EnumerableExpansion (format)

• Następujące elementy określają zestaw wyboru używany przez warunki wyboru.

  • SelectionSetName, element — SelectionCondition, Controls, Configuration (format)

  • SelectionSetName, element — SelectionCondition, Controls, View (format)

  • SelectionSetName, element — SelectionCondition, CustomControl, View (format)

  • SelectionSetName, element — SelectionCondition, EntrySelectedBy, EnumerableExpansion (format)

  • SelectionSetName, element — SelectionCondition, EntrySelectedBy, ListEntry (format)

  • SelectionSetName, element — SelectionCondition, EntrySelectedBy, TableControl (format)

  • SelectionSetName, element — SelectionCondition, EntrySelectedBy, WideEntry (format)

  • SelectionSetName, element — SelectionCondition, GroupBy (format)

Zobacz też

SelectionSets (Zestawy wyboru)

SelectionSet (Zestaw wyboru)

Nazwa

Typy

Pliki formatujące programu PowerShell

Definiowanie warunków wyświetlania danych

Pisanie pliku formatowania i typów programu PowerShell