このレッスンでは、指定した基準を満たすことを形式のデータに方法を学びます。この目的のために、条件付き外観モジュールは、アプリケーションに追加されます。あなたは強調表示されますDemoTaskは、そのオブジェクトのステータスプロパティに設定されていません完了します。また、あなたがハイライト表示されます優先それが含まれているときに、プロパティを高い値を。
このレッスンでは、指定した条件が満たされているデータをフォーマットする方法を学びます。この目的のために、モジュールは、アプリケーションの外観を条件に追加されます。あなたは、そのStatusプロパティが「完全な」デモタスクオブジェクトに設定されていません強調しました。さらに、「優先順位」属性が「高い」値が含まれている場合、属性は強調しました。
- 追加条件付き外観あなたにモジュールをMySolution.Moduleのプロジェクト。この目的のために、ダブルクリックしてModule.cs（Module.vbにあります）ファイル、MySolution.Moduleのプロジェクトを。モジュールデザイナーが呼び出されます。で、ツールボックスにナビゲートDX。19.2：XAFモジュール ]タブ、およびドラッグConditionalAppearanceModuleのデザイナーさんにこのタブからアイテムを必須モジュールを以下に示すように、セクション。
- MySolution。モジュールプロジェクトの外観のための条件にモジュールを追加します。これを行うには、ダブル位置MySolution.moduleプロジェクトModule.cs（Module.vb）ファイル。呼び出しモジュールデザイナー。ツールボックスで、DX.19.2に移動しますXAFモジュール]タブ、およびモジュールのエントリー条件このタブのドラッグの外観以下のセクションで、「デザイナーモジュールが必要」。
- あなたが変更行った後、あなたのソリューションを再構築モジュールデザイナーを。
-
条件付き出現ルール宣言するにはDemoTaskのクラスを、適用AppearanceAttributeのこのクラスに属性を。最初のパラメータとして指定外観ルール識別子を（例えば、「とfontColorRed」）。すると、次のパラメータを指定します。
-
モジュールの設計者で変更を行った後、ソリューションのリビルド。
-
条件出現ルールは、プロパティに適用される「表示プロパティ」設定、DemoTaskクラスを宣言します。最初のパラメータとして、外観ルール識別子（例えば、「とfontColorRed」）を指定します。すると、次のパラメータを指定します。
| パラメーター | 設定 |
|---|---|
| ターゲットUIエレメントは、ルールによって影響を受けることができます。 | 設定しAppearanceAttribute.AppearanceItemTypeの「ViewItem」へのパラメータとAppearanceAttribute.TargetItems「*」にパラメータを。属性から生成されたルールは、すべての影響を与えること、この手段DemoTaskのプロパティは、現在に表示ビュー。 |
| ルールが有効であることが必要な条件。 | 設定しAppearanceAttribute.Contextの「リストビュー」をパラメータとAppearanceAttribute.Criteriaのにパラメータを「ステータス！= 『完了』」。この例では、属性から生成されたルールはで有効になりますDemoTaskオブジェクトのリストビューステータスプロパティに設定されていません完了します。 |
| 条件付き外観はルールによって適用されます。 | 設定しAppearanceAttribute.FontColor「赤」にという名前のパラメータを。 |
次のコードは、に適用される属性とそのパラメータを示していDemoTaskの中で宣言されたクラス、のBusinessObjects \ DemoTask.cs（DemoTask.vb）ファイルを。
次のコードは、アプリケーションのプロパティとBusinessObjects_DemoTask.cs（DemoTask.vb）のパラメータDemoTaskクラス宣言ファイルを示します。
使用してDevExpress.ExpressApp.ConditionalAppearanceを。 // ... [外観（" とfontColorRed "、AppearanceItemType = " ViewItem "、TargetItems = " * "、コンテキスト= " リストビュー" 、 基準 = " ステータス！= '完了' "、FONTCOLOR = " 赤" ）] パブリック クラスDemoTask：タスク{ // ... }
ノートノート
基準値を使用して指定する必要があります基準言語の構文を。
あなたは値を指定し、「条件付き言語の構文」の条件を使用する必要があります。
-
適用AppearanceAttributeのに属性をDemoTaskのクラスの優先プロパティ。最初の位置パラメータとして、指定外観ルール識別子（例えば、「PriorityBackColorPinkを」）。すると、次のパラメータを指定します。
- 外観属性は、タスククラス「優先順位」属性を証明するために適用されます。最初のパラメータとしての位置、ルール識別子は、外観（例えば、「優先ピンク色バック」）を指定します。すると、次のパラメータを指定します。
-
ルールによって影響を受けるために、ターゲットUI要素を指定します
設定しAppearanceAttribute.AppearanceItemTypeの「ViewItem」にパラメータを。属性から生成されたルールが影響することを、この手段の優先順位プロパティは、現在に表示ビュー。
- ルールによって影響を受けるようにUI要素をターゲット
プロパティの外観。外観プロジェクトタイプのパラメータに設定された「表示項目。」プロパティは、ルールから生成されていることを、この手段は、現在のビューに表示された「優先度」属性に影響を与えます。 -
ルールが有効であることが必要な条件を指定してください
設定しAppearanceAttribute.Contextの「任意」とにパラメータをAppearanceAttribute.Criteriaの「優先順位= 2」へのパラメータ。この例では、属性から生成されたルールが影響する優先順位それが2（に設定されているプロパティハイいずれか）DemoTaskビュー。
- 条件を指定するルールが有効でなければならない
「外観特性。コンテキスト」であるパラメータは、「いずれか」、「外観特性は、」標準的なパラメータがに設定されているに設定されている「優先{2}。」それはどんなプレゼンテーションタスクビューで2（高）に設定されている場合この場合は、プロパティから生成されたルールは、「優先度」属性に影響を与えます。 -
ルールによって適用される条件付き外観を指定します
設定しAppearanceAttribute.BackColorの "255、240、240"にパラメータを。
- 条件が適用されるルールの外観を指定
する属性に.BackColor外観パラメータがに設定されている「255240240。」
次のコードは、印加された属性とそのパラメータを示しています。
次のコードは、プロパティとそのパラメータの適用を示しています。
パブリック クラスDemoTask：タスク{ // ... [外観（" PriorityBackColorPink "、AppearanceItemType = " ViewItem "、コンテキスト= " 任意" 、 基準 = " 優先順位= 2 "、BackColorプロパティ= " 255、240、240 " ）] パブリック優先順位優先順位{ // ... } // ... }
-
WinFormsやASP.NETアプリケーションを実行します。DemoTask以下の画像で示すようにリスト表示と詳細表示のデータは、強調表示されます。
-
ファイル名を指定して実行のWinFormsやASP.NETアプリケーション。以下に示すようにデモタスクリストビューとビューのデータの詳細は、強調表示されます。
ノートノート
Appearence Rules that are declared in code are available in the Model Editor. To access them, you can run the Model Editor for the MySolution.Module project. Navigate to the BOModel | DemoTask | AppearanceRules node. This node has two child nodes (FontColorRed and PriorityBackColorPink) that are generated automatically from Appearance attributes applied to the DemoTask class and the DemoTask.Priority property. You can create new Appearance Rules directly in the Model Editor by adding child nodes to the AppearanceRules node.
在代码中声明的显示规则在模型编辑器中可用。要访问它们，您可以运行 MySolution.模块项目的模型编辑器。导航到 BOModel |演示任务 |外观规则节点。此节点有两个子节点（FontColorRed 和优先级BackColorPink），它们从应用于 DemoTask 类和 DemoTask.Priority 属性的外观属性自动生成。通过将子节点添加到"外观规则"节点，可以直接在模型编辑器中创建新的外观规则。
You can see the changes made in the lesson in the DemoTask.cs (DemoTask.vb) file located in the MainDemo.Module project of the MainDemo solution. The MainDemo application is installed in %PUBLIC%\Documents\DevExpress Demos 19.2\Components\eXpressApp Framework\MainDemo by default. The ASP.NET version is available online at http://demos.devexpress.com/XAF/MainDemo/
あなたはmainDemoにMainDemoプログラムを解決することができます。モジュールプロジェクトのDemoTask.cs（DemoTask.vb）ファイルをこのレッスンで行った変更を確認します。デモアプリケーションをメインにインストールされているドキュメント\ DevExpress社のデモ\％PUBLIC％を19.2 \コンポーネント\ eXpressApp Frameworkの\ MainDemoは、デフォルトでは。ASP.NETバージョンでのオンライン利用はAT IS http://demos.devexpress.com/XAF/MainDemo/
。