UI ツール Intent デザインの概要
UI ツールは、次の主なコンポーネントで構成されます。
- UIPartMixin
- UICategory
- UIProperty
- UIMessage
UIPartMixin
UIPartMixin は UI ツールの基礎です。この Mixin は、パーツを UI ツールによって管理できるようにし、UIPartMixin でミックスされるすべてのパーツは .NET で UIPart オブジェクトとして使用可能になります。これにはパーツ、その UI アクションと子、および UI に送信する必要のあるメッセージの UI プロパティの一覧を保持するのに必要なルールが含まれます。UI ツールを機能させるのに最小限必要なことは、ルート パーツが UIPartMixin をミックスすることです。
UIPartMixin の重要なルール
- UIName
- UI ツール全体で使用する UIPart の表示名です。
- Seq
- UIParts のソート時に使用されるシーケンス値です。
- IconPath
- この UIPart の UIPartTree で使用するイメージへのパスです。
- UIProperties
- この UIPart で現在アクティブになっている UIProperties の一覧です。
- UIChildren
- UIPartTree でこの UIPart の子として表示される UIPart パーツの一覧です。
- アクション
- この UIPart で現在使用できる UIActions の一覧です。
- メッセージ
- この UIPart で現在アクティブになっている UIMessages の一覧です。
UICategory
UICategory デザインは、単に UIProperties のカテゴリ情報のコンテナです。UIProperties グループ、およびさまざまなグループのソートに使用されます。また、UIProperties のグループを無効にするために使用できるルールが含まれています。
UICategory の重要なルール
- CategoryName
- UIProperties をグループ化するときに表示されるカテゴリの名前です。
- CategorySeq
- UIProperties のカテゴリをソートするときに使用するシーケンス値です。
UIProperty
UIProperty は、UI ツールの 2 番目に重要な部分です。Intent モデルと UI の間の実際のインタフェースとして使用されます。既定値、現在値、選択肢の一覧などは、すべて UIProperty に格納されます。UIProperty のデザインには非常に多くのオプションが含まれているため、このドキュメントでは最も広く使用されるものにのみ焦点を当てています。
UIProperty の重要なルール
- CategoryPart
- UIProperty のカテゴリ名およびカテゴリのシーケンスを提供する UICategory パーツへの参照です。
- BaseName
- これはこの UIProperty のベース名です。これは NamePrefix と NameSuffix パラメータに値を指定することによってさらに修正できますが、通常 NamePrefix と NameSuffix の使用は UIProperties の子リストが必要な場合に限られます。
- Seq
- カテゴリ内の UIProperties ソートするときに使用するシーケンス値です。
- DefaultValue
- UIProperty に使用する既定値です。
- 値
- UIPropety の現在の値です。
- IsValueModified?
- この UIProperty が UI を介してユーザによって修正されているかどうかを示すフラグです。
- IsReadOnly?
- UIProperty を読み取り専用にします。
- ChoiceListValues
- この UIProperty から選択できる値の一覧です。
- RestrictToList?
- 選択肢を ChoiceListValues で指定されたものだけに制限するように UIProperty を指定します。
- Formatter
- UIProperty に使用するフォーマッタの名前または ID です。フォーマッタは、値が表示方法および入力テキストの解析方法をコントロールします。
- Converter
- UIProperty に使用するコンバータの名前または ID です。コンバータは、一部の UI 値は適用可能な Intent データ タイプを持たないため、Intent モデルに値を保存する方法をコントロールします。日付はこれらの値のタイプの一例です。
- [ツールチップ]
- この UIProperty の UI に表示されるツールチップです。
- ForPaintColor
- この UIProperty に使用する前景のペイント カラーです。
- BackPaintColor
- この UIProperty に使用する背景のペイント カラーです。
UIMessage
UIMessage は、UI に表示されるメッセージを追加するために使用されます。これらは通常、エラーまたは警告メッセージですが、モデルに関する単なる情報の場合があります。UIPartMixin でミックスされているすべてのデザインは UIMessages を持つことができます。
UIMessage の重要なルール
- Severity
- メッセージの重大度であり、:Info、:Warning、または :Error の場合があります。
- Message
- この UIMessage の実際のメッセージ テキストです。
- Triggered?
- Triggered? パラメータが true と評価されたメッセージだけが、UI に表示されます。