XAMLの書き方（１） のバックアップ(No.7)

[ トップ ]   [ 新規 | 一覧 | 単語検索 | 最終更新 | ヘルプ ]

• バックアップ一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• XAMLの書き方（１） へ行く。
  • 1 (2016-12-04 (日) 17:21:40)
  • 2 (2016-12-04 (日) 18:50:49)
  • 3 (2016-12-05 (月) 09:59:52)
  • 4 (2017-03-12 (日) 15:18:55)
  • 5 (2017-05-15 (月) 17:15:54)
  • 6 (2017-05-15 (月) 19:49:07)
  • 7 (2017-05-16 (火) 10:40:46)
  • 8 (2017-05-16 (火) 16:07:05)
  • 9 (2017-05-16 (火) 16:16:56)
  • 10 (2017-05-17 (水) 20:26:57)
  • 11 (2017-05-17 (水) 21:59:17)
  • 12 (2017-05-18 (木) 09:35:06)

---

「マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

• 戻る

目次 †

概要 †

基本的なXAMLの書き方。

名前空間 †

XAMLにおける各種の名前空間の宣言は、xmlns属性を使用したXML名前空間にて行う。
ここでは、以下の既定の名前空間の宣言を例にとって説明する。

• 名前空間の宣言

  <Window x:Class="WpfApplication1.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

• XML名前空間の簡単な説明
  http://www.kanzaki.com/docs/sw/names.html

WPF名前空間 †

2行目のXML名前空間の宣言（xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"）では、
WPFフレームワーク（PresentationFramework?.dll）のアセンブリ内に同梱されるURIにマップされた
CLR名前空間（System.Windows.Controls、System.Windows.Dataなど）を、既定のXML名前空間（プレフィックスなし）として割り当てている。
そのため、既定でXAMLからWPFフレームワークのCLRオブジェクトを利用できる。

XAML名前空間 †

3行目のXML名前空間の宣言（xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"）では、
URIにマップされた共通的なXAMLの言語機能がXML名前空間（x）として割り当てられている。
これにより、「x:」というプレフィックスを使用することで、「言語機能」で説明する、XAMLの言語機能を使用できるようになる。

CLR名前空間 †

CLR名前空間について以下を例にとって説明する。

(1) †

• CLR名前空間の宣言

  <Window x:Class="WpfApplication1.Window1"
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
    xmlns:igDP="http://infragistics.com/DataPresenter" <--- 名前空間の宣言（追加
    Title="Window1" Height="300" Width="300">
    <Grid>
      <igDP:XamDataGrid Name="xamDataGrid1"/> <--- 名前空間の使用例
    </Grid>
  </Window>

Infragistics社製のNetAdvantage?など、

XmlnsDefinition?アセンブリ属性でURIとCLR名前空間のマップが指定された
サードパーティ製のUIコンポーネントをD&DでVSデザイナから追加した場合、

上記の例のように自動的にXML名前空間の宣言が追加される。

• MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Markup.XmlAttributeProperties?.XmlnsDefinition?プロパティ
  http://msdn.microsoft.com/ja-jp/library/system.windows.markup.xmlattributeproperties.xmlnsdefinition.aspx

なお、XML名前空間には一意の名前を自由に付与でき（上記の例ではigDP）、
このプレフィックスを使用することで、XAMLからUIコンポーネントのCLRオブジェクトを利用できる。

(2) †

この他に、URIとしてCLR名前空間とアセンブリを直接指定する方法もある。

• CLR名前空間の宣言

  xmlns:sys="clr-namespace:（CLR名前空間）;assembly=（アセンブリ名）"

  • 例１：サードパーティ製品

    <Window x:Class="WpfApplication1.Window1"
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      xmlns:igDP="clr-namespace:Infragistics.Windows.DataPresenter;assembly=Infragistics3・・・" <--- 名前空間の宣言
      Title="Window1" Height="300" Width="300">
      <Grid>
        <igDP:XamDataGrid Name="xamDataGrid1"/> <--- 名前空間の使用例

  • 例２：.NET Framework

    <Window x:Class="WpfApplication1.Window1"
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      xmlns:sys="clr-namespace:System;assembly=mscorlib" <--- 名前空間の宣言
      Title="Window1" Height="300" Width="300">
      <Window.Resources>
        <x:Array x:Key="List" Type="{x:Type sys:String}"> <--- 名前空間の使用例

  • 例３：自作の同一プロジェクトのクラス

    <Window x:Class="WpfApplication1.Window1"
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
      xmlns:uc="clr-namespace:WpfApplication1" <--- 名前空間の宣言
      Title="Window1" Height="300" Width="300">
      <StackPanel Orientation="Vertical">
        <uc:UserControl1 x:Name="userControl1"/> <--- 名前空間の使用例

• この方法では、「clr-namespace」、「assembly」などの定義済みトークンを使用する。
  • 当該プロジェクト中のCLR名前空間を指定する場合は、「assembly」トークンは省略できる。
  • XML名前空間には一意の名前を自由に付与でき、このプレフィックスを使用することで、XAMLからUIコンポーネントのCLRオブジェクトを利用できる。

• 製品並みのカスタムのUIコントロールを開発・使用するなどの目的を除いて、CLRクラスを開発しXAMLから使用する場合、
  • 一般的には「clr-namespace、assembly」の定義済みトークンを使用する。
  • ただし、この方法は、１つのCLR名前空間に対して、１つのXML名前空間しか割り当てられない
  • （XmlnsDefinition?アセンブリ属性を使用すると、１つのXML名前空間に複数のCLR名前空間を割り当てられる）。

参考 †

• MSDN > WPFの基礎 > WPFのXAML > XAML名前空間およびWPF XAMLの名前空間の割り当て
  http://msdn.microsoft.com/ja-jp/library/ms747086.aspx

言語機能 †

XAMLの言語機能である

• 「ディレクティブ」
• 「マークアップ拡張」

について説明する。

• MSDN > .NET Framework XAMLサービスの概念説明のドキュメント > XAML名前空間 (x:) 言語機能
  http://msdn.microsoft.com/ja-jp/library/ms753327.aspx

ディレクティブ †

XAMLの言語機能が提供する各種ディレクティブについて説明する。

• MSDN > Windows Presentation Foundation > グローバライズとローカライズ > WPFのグローバリゼーション
  http://msdn.microsoft.com/ja-jp/library/ms745650.aspx

マークアップ拡張 †

XAMLの言語機能が提供する各種「マークアップ拡張」について説明する。
通常、「マークアップ拡張」は、「{」と「}」の２つの中括弧を使用することでXAMLパーサに対し、拡張されたプロパティ指定方法を指示する。

• MSDN > WPFの基礎 > WPFのXAML
  • > マークアップ拡張機能とWPF XAML
    http://msdn.microsoft.com/ja-jp/library/ms747254.aspx
  • > WPF XAML拡張機能
    http://msdn.microsoft.com/ja-jp/library/ms747180.aspx

XAMLで定義されたマークアップ拡張 †

以下、XAMLの機能である「XAMLで定義されたマークアップ拡張」を一覧する。
これらの種類は、中括弧＋「x:」プレフィックスの直後の文字列トークンによって識別される。

• XAMLに実装されたマークアップ拡張

  項番	文字列トークン	説明
  		例
  1	x:Static	静的プロパティ（定数、静的プロパティ、フィールド、列挙値）を参照する。 構文：<object property="{x:Static Member=prefix:typeName.staticMemberName?}" .../>
  		<Button      Foreground="{x:Static Member=SystemColors?.InfoTextBrush?}"     Background="{x:Static Member=SystemColors?.InfoBrush?}">   Click Here </Button>
  2	x:Null	CLRオブジェクトのプロパティにnull値を設定する（既定値をnullクリアする場合など）。
  		<Button x:Name="button1" Background="{x:Null}" Click="button1_Click">   Click Here </Button>
  3	x:Type	CLRクラスの型情報を指定する。
  		詳しくは、下記、項番４の例を参照のこと。
  4	x:Array	IEnumerableを持つArrayオブジェクト（配列）を生成する。
  		<Window.Resources>   <x:Array x:Key="List"     Type="{x:Type sys:String}">     <sys:String>A</sys:String>     <sys:String>B</sys:String>     <sys:String>C</sys:String>   </x:Array> </Window.Resources> <StackPanel?>   <ListBox? ItemsSource?="{Binding Source={StaticResource? List}}"/> </StackPanel?> ※ 先頭で、.NET FrameworkのSystem名前空間のインポートが必要    xmlns:sys="clr-namespace:System;assembly=mscorlib" ※ StaticResource?については次項で説明する。

※ x:Arrayは、例外的に中括弧と共に使用しない。

WPF固有のマークアップ拡張 †

以下、WPF の機能である「WPF固有のマークアップ拡張」を一覧する。
こちらは、プロパティ値に「データ バインディング」や、「リソース」への参照を指定できる。

• XAMLに実装されたマークアップ拡張

  項番	文字列トークン	説明
  		構文 ※ 「プロパティ属性構文」と「プロパティ要素構文」については、後述する。
  1	{Binding ・・・	Bindingオブジェクトに「バインディング ターゲット」のプロパティを設定することで、「データ バインディング」を実装する。 MSDN > WPFの基礎 > WPFのXAML > WPF XAML拡張機能 > バインディングのマークアップ拡張機能 http://msdn.microsoft.com/ja-jp/library/ms750413.aspx
  		具体例は、「データ バインディングの基礎」を参照のこと。
  2	{StaticResource? ・・・	既に定義されたリソースに対する参照を検索し、任意のXAMLプロパティ属性の値を設定する。
  		具体例は、「リソースとのデータ バインディング」を参照のこと。 プロパティ属性構文： <object property="{StaticResource? key}" .../> なお、「データ バインディング」で使用する場合は、次のようになる。 <object property="{Binding Source={StaticResource? key} ...}" .../> プロパティ要素構文： <object>   <object.property>     <StaticResource? ResourceKey?="key" .../>   </object.property> </object>
  3	{DynamicResource? ・・・	リソースが変化したときに、任意のXAMLプロパティ属性の値を設定する。 keyには、x:Key属性によって指定された既存の「リソース」に対応するキーを指定する。
  		具体例は、「リソースとのデータ バインディング」を参照のこと。 プロパティ属性構文： <object property="{DynamicResource? key}" .../> なお、「データ バインディング」で使用する場合は、次のようになる。 <object property="{Binding Source={DynamicResource? key} ...} " .../> プロパティ要素構文： <object>   <object.property>     <DynamicResource? ResourceKey?="key" .../>   </object.property> </object>
  4	{TemplateBinding? ・・・	親コントロールに適用したプロパティ値を「テンプレート」に反映させる。 MSDN > WPFの基礎 > WPFのXAML > WPF XAML拡張機能 > TemplateBinding?のマークアップ拡張機能 http://msdn.microsoft.com/ja-jp/library/ms742882.aspx
  		具体例は、「テンプレート」を参照のこと。 プロパティ属性構文： <object property="{TemplateBinding? TargetProperty? }" .../>
  5	{RelativeSource? ・・・	Binding.RelativeSource?を指定する。詳しくは、下記のURLを参照のこと。 また、次で例を挙げて説明する。 MSDN > WPFの基礎 > WPFのXAML > WPF XAML拡張機能 > RelativeSource?のマークアップ拡張機能 http://msdn.microsoft.com/ja-jp/library/ms743599.aspx
  		具体例は、次を参照のこと。 プロパティ属性構文： <Binding RelativeSource?="{RelativeSource? modeEnumValue?}" .../> なお、「データ バインディング」で使用する場合は、次のようになる。 <object property="{Binding RelativeSource?={RelativeSource? modeEnumValue?} ...}" .../> プロパティ要素構文： <Binding>   <Binding.RelativeSource?>     <RelativeSource? Mode="modeEnumValue?"/>   </Binding.RelativeSource?> </Binding>  OR  <Binding>   <Binding.RelativeSource?>     <Relative       Mode="FindAncestor?"       AncestorType?="{x:Type typeName}"       AncestorLevel?="intLevel"/>   </Binding.RelativeSource?> </Binding>
  6	{ThemeDictionary? ・・・	カスタム コントロールの作成者やサードパーティ製のUIコンポーネントの、 コントロールの「スタイル」をアプリケーションの「リソース」から読み込む。 MSDN > WPFの基礎 > WPFのXAML > WPF XAML拡張機能 > ThemeDictionary?のマークアップ拡張機能 http://msdn.microsoft.com/ja-jp/library/ms752067.aspx
  		－

※ keyには、x:Keyディレクティブによって指定された既存のリソースに対応するキーを指定する。

マークアップ拡張の例 †

バインディングのマークアップ拡張の例 †

こちら

TemplateBinding?の例 †

こちら

RelativeSource?の例 †

こちら

プロパティの設定方法 †

プロパティの設定方法として、

• プロパティ属性構文：
  要素の属性にテキストを使用して設定する。
• プロパティ要素構文：
  要素のinnerText・innerXMLを使用してプロパティを設定する。

の２つの構文について説明する。

以下、TextBox?要素に対して、同等の属性を設定する
「プロパティ属性構文」と「プロパティ要素構文」の例を示す。

プロパティ属性構文 †

要素の属性にテキストを使用してプロパティを設定する方法

• プロパティ属性構文の例

  <TextBox 
     Width = "100"
     FontSize = "30"
     Text = "text1"
     Background = "White"
     Foreground = "Blue" />

プロパティ要素構文 †

要素のinnerText・innerXMLを使用してプロパティを設定する方法

• プロパティ要素構文の例

  <TextBox>
    <TextBox.Width>100</TextBox.Width>
    <TextBox.FontSize>30</TextBox.FontSize>
    <TextBox.Background>
      <SolidColorBrush Color="White"/>
    </TextBox.Background>
    <TextBox.Foreground>
      <SolidColorBrush Color="Blue"/>
    </TextBox.Foreground>
    <TextBox.Text>text1</TextBox.Text>
  </TextBox>

なお、子要素のコレクションを設定する「プロパティ要素構文」である

• Panel.Childrenプロパティ
• ItemsControl?.Itemsプロパティ

などは、暗黙的に使用されるため明記が不要のものもある。

型コンバータ †

XAMLパーサは、XAMLの「プロパティ属性構文」として指定された各属性テキストを、
プリミティブ型に変換できるリテラル文字列として解釈するか、「型コンバータ」を使用してオブジェクトに変換する。

なお、「型コンバータ」（と、そのベース クラスであるTypeConverter?クラス）は、
.NETのコンポーネントとコントロールのデザイン時・実行時の動作を実装する一般的なクラスであり、WPF独自のクラスではない。
しかし、XAMLの「プロパティ属性構文」からのCLRプロパティ設定を多用するWPF / Silverlight開発では、その存在を認識しておいたほうが良い。

XAMLパーサは通常、プロパティの型（CLRクラス）にTypeConverterAttribute?属性 が付与されているかを調べる。
付与されている場合は、この属性値に基づいた「型コンバータ」を使って、TypeConverter?.ConvertFrom?メソッド により文字列をプロパティ値に変換する。

以下は、ユーザ コントロールに、MyPoint?というカスタムの型を取るCLRプロパティを実装しXAMLに公開、
XAMLの「プロパティ属性構文」として指定された各属性テキストを、カスタムの型に変換する「型コンバータ」を実装した例である。

カスタム型 †

MyPoint?というカスタム型（型コンバータを実装）

/// <summary>
/// カスタム型（型コンバータを実装）
/// </summary>
[TypeConverter(typeof(MyPointConverter))]
public class MyPoint {
  public MyPoint(int x, int y) {
    this._x = x;
    this._y = y;
  }
  private int _x;
  public int X {
    set { this._x =value; }
    get { return this._x; } 
  }
  private int _y;
  public int Y {
    set { this._y = value; }
    get { return this._y; }
  }
}

型コンバータ †

/// <summary>カスタム型の型コンバータ</summary>
public class MyPointConverter : TypeConverter {

  /// <summary>CanConvertFrom（変換可能かチェックする）</summary>
  public override bool CanConvertFrom(
    ITypeDescriptorContext context, Type sourceType) {
    if (sourceType == typeof(string)) {
      return true;
    }
    return base.CanConvertFrom(context, sourceType);
  }

  /// <summary>指定された文字列をカスタム型（MyPoint）に変換する</summary>
  public override object ConvertFrom(
    ITypeDescriptorContext context,
    CultureInfo culture, object value) {
    if (value is string) {
      string[] v = ((string)value).Split(new char[] { ',' });
      return new MyPoint(int.Parse(v[0]), int.Parse(v[1]));
    }
    return base.ConvertFrom(context, culture, value);
  }

  /// <summary>指定されたカスタム型（MyPoint）を文字列に変換する</summary>
  public override object ConvertTo(ITypeDescriptorContext context,
    CultureInfo culture, object value, Type destinationType) {
    if (destinationType == typeof(string)) {
      return ((MyPoint)value).X + "," + ((MyPoint)value).Y;
    }
    return base.ConvertTo(context, culture, value, destinationType);
  }
}

ユーザ コントロール †

MyPoint?というカスタム型のCLRプロパティを実装

/// <summary>
/// UserControl1.xaml の相互作用ロジック
/// </summary>
public partial class UserControl1
  : UserControl {
  // CLRプロパティの定義（XAML属性に公開可能）
  private MyPoint _myLocation;

  public MyPoint MyLocation {
    set { this._myLocation = value; }
    get { return this._myLocation; }
  }

・・・

型コンバータの使用例 †

上記のユーザ コントロールのカスタムの型を取るCLRプロパティを、以下のようにXAMLの「プロパティ属性構文」として指定された各属性テキストから初期化できる。

<uc:UserControl1 x:Name="userControl1" MyLocation="10,20"/>

ただし、(当然ながら、)文字列からの変換をサポートしているだけで、すべてのプロパティ値をサポートすることはできない。
文字列で表現できないプロパティ値は、「プロパティ属性構文」ではなく「プロパティ要素構文」として記述する方法を取る。

• MSDN > WPFの基礎 > WPFのXAML > TypeConverters?及びXAML
  http://msdn.microsoft.com/ja-jp/library/aa970913.aspx

コンテンツ構文 †

「コンテンツ構文」とは、Contentプロパティ（またはItemsプロパティ）に要素を設定する構文である。

• ContentPropertyAttribute?を付けることで、

• MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Markup.ContentPropertyAttribute?クラス
  http://msdn.microsoft.com/ja-jp/library/system.windows.markup.contentpropertyattribute.aspx
  • [ContentPropertyAttribute?("Content")]→ Contentプロパティ
  • [ContentPropertyAttribute?("Items")]→ Itemsプロパティ

• 属性に指定されるContentプロパティを、
  innerText・innerXML（プロパティ要素構文）として記述できるようになる。

• コンテンツ構文
  • プロパティ属性構文

    <Button Content="Click Here" />

  • プロパティ要素構文

    <Button>Click Here</Button>

• 比較
  • なお、Windows FormsやWeb Forms（HTML）などで、UIコントロールの表示のカスタマイズをするには、
    UIコントロールの「スタイル」属性の指定による方法のみサポートされていた。
  • これに対し、WPFのUIコントロールは「スタイル」属性の指定による方法だけでなく、
    Contentプロパティ（またはItemsプロパティ）に任意の型の子要素を設定することができるため、
    コントロールの「外観」を自由に変更でき、柔軟性が非常に高くなっている。

• 補足：Windowsフォームの外観の変更
  • コントロールを自前で描画する「オーナー描画」と呼ばれる方法が用意されていたが、
    「オーナー描画」はグラフィックス メソッドなどを使用して、
    すべての描画を独自に行わなければならないため、深い知識と多量のコードが必要であった。

• 関連資料
  • .NETコントロールのカスタマイズ方法

Contentプロパティ †

WPFのContentControl?は、Contentプロパティに任意の型の子要素を設定することができるため、コントロールの「外観」を自由に変更できる。

文字列のコンテンツ要素を格納 †

ContentControl?のButtonコントロールを例にしてContentプロパティへ要素を設定する例を示す。

• XAML
  • プロパティ属性構文：

    <Button Width="200" Height="200" Content="ボタン"/>

  • プロパティ要素構文：

    <Button Width="200" Height="200">ボタン</Button>

• レンダリング結果
  

イメージのコンテンツ要素を格納 †

Contentプロパティには、Imageオブジェクトなどの任意の型の要素も設定できる。

• XAML

  <Button Width="200" Height="200">
    <Button.Content>
      <Image Source=".\Blue hills.jpg"/>
    </Button.Content>
  </Button>

• レンダリング結果
  

パネルに纏めて格納した複数のコンテンツ要素 †

• XAML
  • 2つ以上の要素を設定したい場合は、パネル要素を使用する。

    <Button Width="200" Height="200">
      <Button.Content>
        <StackPanel Orientation="Vertical">
          <Image Source=".\Blue hills.jpg" Margin="5" />
          <TextBlock Text="ボタン" HorizontalAlignment="Center" Margin="5"/>
        </StackPanel>
      </Button.Content>
    </Button>

  • なお、<Object.Content>タグは省略することもできる。

    <Button Width="200" Height="200">
      <StackPanel Orientation="Vertical">
        <Image Source=".\Blue hills.jpg" Margin="5" />
        <TextBlock Text="ボタン" HorizontalAlignment="Center" Margin="5"/>
      </StackPanel>
    </Button>

• レンダリング結果
  

Itemsプロパティ †

WPFのItemsControl?は、Itemsプロパティに任意の型の子要素を設定することができるため、コントロールの「外観」を自由に変更できる。

複数のパネルに纏めて格納した複数のコンテンツ要素 †

ItemsControl?のItemsプロパティへは、複数のコンテンツを追加できる。
以下、ListBox?コントロールを例にしてItemsプロパティへ子要素の設定する例を示す。

• XAML

  <Grid>
    <ListBox>
      <Border BorderBrush ="Black" BorderThickness ="1" Margin="5">
        <StackPanel Orientation="Horizontal" Height="120" Width="250" Margin="5">
          <Image Source=".\Blue hills.jpg" Height="100"/>
          <TextBlock Text="Blue hills" VerticalAlignment="Center"/>
        </StackPanel>
      </Border>
      <Border BorderBrush ="Black" BorderThickness ="1" Margin="5">
        <StackPanel Orientation="Horizontal" Height="120" Width="250" Margin="5">
          <Image Source=".\Sunset.jpg" Height="100"/>
          <TextBlock Text="Sunset" VerticalAlignment="Center"/>
        </StackPanel>
      </Border>
      <Border BorderBrush ="Black" BorderThickness ="1" Margin="5">
        <StackPanel Orientation="Horizontal" Height="120" Width="250" Margin="5">
          <Image Source=".\Water lilies.jpg" Height="100"/>
          <TextBlock Text="Water lilies" VerticalAlignment="Center"/>
        </StackPanel>
      </Border>
      <Border BorderBrush ="Black" BorderThickness ="1" Margin="5">
        <StackPanel Orientation="Horizontal" Height="120" Width="250" Margin="5">
          <Image Source=".\Winter.jpg" Height="100"/>
          <TextBlock Text="Winter" VerticalAlignment="Center"/>
        </StackPanel>
      </Border>
    </ListBox>
  </Grid>

• レンダリング結果
  

• 説明
  • Itemsプロパティに子要素を設定する場合は、
    innerText・innerXMLを使用する「プロパティ要素構文」を使用する。
    • また、この際に<Object.Items>タグは省略することもできる。
  • ちなみに、上記を「データ バインディング」で実装することもできる。
    • これについては、「データ バインディングの基礎」を参照のこと。

リソース †

ここでは、

• 「リソース」の定義方法と、

• 前述の各「マークアップ拡張」を使用し、
  プロパティ値に「リソース」への参照を指定する方法

について説明する。

※「リソース」の「データ バインディング」については、
「リソースとのデータ バインディングを参照のこと。

• 参考
  • MSDN > WPFの基礎 > リソース
    http://msdn.microsoft.com/ja-jp/library/ms742538.aspx

リソースの定義 †

「リソース」とは、ResourceDictionary? 型のオブジェクトであり、

• ApplicationオブジェクトのResources プロパティ
• 各UI要素（FrameworkElement? or FrameworkContentElement?）のResources プロパティ

に「プロパティ要素構文」を使用して定義できる。

• MSDN > .NET Frameworkクラス ライブラリ
  • > System.Windows.ResourceDictionary?クラス
    http://msdn.microsoft.com/ja-jp/library/system.windows.resourcedictionary.aspx
  • > System.Windows.Application.Resourcesプロパティ
    http://msdn.microsoft.com/ja-jp/library/system.windows.application.resources.aspx
  • > System.Windows.FrameworkElement?.Resourcesプロパティ
    http://msdn.microsoft.com/ja-jp/library/system.windows.frameworkelement.resources.aspx
  • > System.Windows.FrameworkContentElement?.Resourcesプロパティ
    http://msdn.microsoft.com/ja-jp/library/system.windows.frameworkcontentelement.resources.aspx

このため、任意のUI要素に定義可能であるが、
通常はルート要素（Window or Page）上に定義する。

また、「リソース」は、定義場所により以下のような呼称・特徴がある。

リソースの定義場所 †

• アプリケーション リソース
  ApplicationオブジェクトのResourcesプロパティに定義された「リソース」を
  「アプリケーション リソース」と呼び、全体から（つまりどこからでも）参照できるという特徴を持っている。

• ウィンドウ ページ リソース
  Window・PageオブジェクトのResourcesプロパティに定義された「リソース」を
  「アプリケーション リソース」と呼び、そのWindow・Pageと、その子要素から参照できるという特徴を持っている。

• イミディエイト リソース
  各UI要素（FrameworkElement? or FrameworkContentElement?）の
  Resourcesプロパティに定義された「リソース」を「イミディエイト・リソース」と呼び、
  「リソース」を定義した要素と、その子要素から参照できるという特徴を持っている。

リソースの定義例 †

• 「リソース」には、前述のx:Key ディレクティブを使用して一意のキーを持たせて定義する必要がある。
  

  <Window.Resources>
    <x:Array x:Key="List" Type="{x:Type sys:String}">
      <sys:String>A</sys:String>
      <sys:String>B</sys:String>
      <sys:String>C</sys:String>
    </x:Array>
  </Window.Resources>

  ※ 先頭で、String型のインポートが必要
  xmlns:sys="clr-namespace:System;assembly=mscorlib"

• 補足：ジェネリック コレクションのリソース
  ジェネリック コレクションを「リソース」に定義するには、x:TypeArguments?のディレクティブを使用して、
  ObservableCollection?<T>コレクション クラスなどのジェネリック型のコンストラクタに渡す必要があるが、
  これは、XAML2009 からのサポートとなる。

リソースの使用方法 †

「リソース」を定義したら、各種「マークアップ拡張」を使用して、
プロパティ値に「データ バインディング」や、「リソース」への参照を指定できる。

この時、参照する側からx:Key ディレクティブを使用して割り当てたキーを「リソース」検索のキーとして指定できる。

なお、「スタイル」や「テンプレート」などは、キーを定義せず、TargetType? 属性のみ使用して、
指定の型のオブジェクトに「スタイル」や「テンプレート」を適用することもできる。
これについては、「スタイルとテンプレート」を参照のこと。

• MSDN > .NET Frameworkクラス ライブラリ
  • > System.Windows.Style.TargetType? プロパティ
    http://msdn.microsoft.com/ja-jp/library/system.windows.style.targettype.aspx
  • > System.Windows.Controls.ControlTemplate?.TargetType?プロパティ
    http://msdn.microsoft.com/ja-jp/library/system.windows.controls.controltemplate.targettype.aspx

リソースの定義と参照 †

以下、「リソース」の定義と、プロパティ値に「リソース」への参照を指定する例を示す。

StaticResource?参照の例 †

StaticResource?参照では、

• コンパイル時に「リソース」検索が行われ、各「リソース」に指定されたキーが存在するかどうかが確認される。
• 「リソース」検索により、「リソース」が発見できなかった場合は、コンパイル時にエラーとなる。

以下は、StaticResource?の定義と参照例。

• XAML
  • StaticResource?の定義と参照例（１）
    • 以下は、「マークアップ拡張」を使用して、「プロパティ属性構文」でStaticResource?参照した例である。
    • また、属性名を省略すると自動的にコンストラクタに渡される動作を利用して、
      ResourceKey?属性に指定の値を渡す旨を指示する「ResourceKey?=」という記述を省略することができる。

<Window.Resources>
  <SolidColorBrush x:Key="BlueBrush" Color="Blue"/>
</Window.Resources>
<Grid>
  <Ellipse Fill="{StaticResource ResourceKey=BlueBrush}" Height="150" Width="150"/>
</Grid>

↓ 「ResourceKey? =」という記述を省略

<Window.Resources>
  <SolidColorBrush x:Key="BlueBrush" Color="Blue"/>
</Window.Resources>
<Grid>
  <Ellipse Fill="{StaticResource BlueBrush}" Height="150" Width="150"/>
</Grid>

• StaticResource?の定義と参照例（２）
  以下は、一般的ではないが「プロパティ要素構文」を使用してStaticResource?参照した例である。
  なお、WPFのみ、StaticResource?参照を「プロパティ要素構文」で記述可能である。

  <Window.Resources>
    <SolidColorBrush x:Key="BlueBrush" Color="Blue"/>
  </Window.Resources>
  <Grid>
    <Ellipse Height="150" Width="150">
      <Ellipse.Fill>
        <StaticResource ResourceKey="BlueBrush"/> 
      </Ellipse.Fill>
    </Ellipse>
  </Grid>

• レンダリング結果
  

DynamicResource?参照の例 †

• DynamicResource?参照では、アプリケーションの起動時に、
  後で「リソース」検索を行う際に使用する一時的な式が作成され、
  アプリケーションの実行後、「リソース」が必要になった際に都度、「リソース」検索が行われる。

• このためDynamicResource?参照は、
  • 主に「リソース」の値が変更される場合、StaticResource?参照に代替して使用する。
  • 「リソース」検索により、「リソース」が発見できなかった場合は、デフォルト値が設定される。

• なお、DynamicResource?参照は、WPFでのみ利用可能で、「Silverlight」では利用不可である。

以下は、DynamicResource?の定義と参照例。

• 以下は、リソースがアプリケーション外部から変更される場合の例
  以下は、デスクトップ画面のテーマの変更（Windows XP → Windowsクラシック）を反映する例である。
  

<Grid>
  <Grid.RowDefinitions>
    <RowDefinition/>
    <RowDefinition/>
  </Grid.RowDefinitions>
  <Ellipse Grid.Row="0"
    Fill="{StaticResource ResourceKey={x:Static SystemColors.HighlightBrushKey}}"/>
  <Ellipse Grid.Row="1"
    Fill="{DynamicResource ResourceKey={x:Static SystemColors.HighlightBrushKey}}"/>
</Grid>

• 以下は、リソースがアプリケーション内部から変更される場合の例
  以下は、アプリケーションからの「リソース」の動的な変更を反映する例である。
  なお、「リソース」の動的な変更は、FrameworkElement?.Resourcesプロパティで変更できる。
  • XAML

    <Window.Resources>
      <SolidColorBrush x:Key="MyBrush" Color="Blue"/>
    </Window.Resources>
    <Grid>
      <Grid.RowDefinitions>
        <RowDefinition/>
        <RowDefinition/>
        <RowDefinition Height="23"/>
      </Grid.RowDefinitions>
      <Ellipse Grid.Row="0" Fill="{StaticResource MyBrush}"/>
      <Ellipse Grid.Row="1" Fill="{DynamicResource MyBrush}"/>
      <StackPanel Grid.Row="2" Orientation="Horizontal" HorizontalAlignment="Center">
        <Button Content="青" Height="23" Name="button1" Width="75" Click="button1_Click" />
        <Button Content="赤" Height="23" Name="button2" Width="75" Click="button2_Click" />
      </StackPanel>
    </Grid>

• コードビハインド

  private void button1_Click(object sender, RoutedEventArgs e) {
    this.Resources["MyBrush"] = Brushes.Blue;
  }
  private void button2_Click(object sender, RoutedEventArgs e) {
    this.Resources["MyBrush"] = Brushes.Red;
  }

StaticResource?参照 + ディクショナリ ファイルの例 †

ResourceDictionary?は、「ディクショナリ ファイル」に定義することもできる。

「ディクショナリ ファイル」を追加する際は、

1. プロジェクト ファイルを右クリックし、
2. [追加] → [リソース ディクショナリ]を選択するか、
   [追加] → [新しい項目]を選択し、表示されるテンプレートから[リソース ディクショナリ（WPF）]を選択する。

• 前述のStaticResource?参照の例を、
  「ディクショナリ ファイル」を使用するように書き直した例を以下に示す。

  <ResourceDictionary
    xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
    xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
    <SolidColorBrush x:Key="BlueBrush" Color="Blue"/>
  </ResourceDictionary>

  ディクショナリ ファイルの定義例 (Dictionary1.xaml)

• 「ディクショナリ ファイル」を「イミディエイト・リソース」にロードする。

  <Window.Resources>
    <ResourceDictionary Source="Dictionary1.xaml"/>
  </Window.Resources>
  <Grid>
    <Ellipse Fill="{StaticResource BlueBrush}" Height="150" Width="150"/>
  </Grid>

StaticResource?参照 ＋ ディクショナリ ファイルの使用例

DynamicResource?参照 + ディクショナリ ファイルの例 †

• DynamicResource?参照とResourceDictionary?を組み合わせ、
• ResourceDictionary?を、Application.LoadComponent?で動的にロード、
• Application.Current.Resourcesに設定することにより、
• 「スタイル」（スキン ）などの設定をアプリケーションから動的に変更することが可能である。

以下の、その例を示す。

• Dictionary
  • Dictionary1.xaml

    <ResourceDictionary
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
      <SolidColorBrush x:Key="MyBrush" Color="Blue"/>
    </ResourceDictionary>

  • Dictionary2.xaml

    <ResourceDictionary
      xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
      <SolidColorBrush x:Key="MyBrush" Color="Red"/>
    </ResourceDictionary>

• XAML

  <StackPanel>
    <Ellipse Fill="{DynamicResource MyBrush}" Height="150" Width="150"/>
    <Button Content="青" Height="23" Name="button1" Width="75" Click="button1_Click" />
    <Button Content="赤" Height="23" Name="button2" Width="75" Click="button2_Click" />
  </StackPanel>

• コードビハインド

  public partial class Window1 : Window {
    public Window1() {
      InitializeComponent();
      this.LoadResourceDictionary("Dictionary1.xaml");
    }
  
    private void button1_Click(object sender, RoutedEventArgs e) {
      this.LoadResourceDictionary("Dictionary1.xaml");
    }
  
    private void button2_Click(object sender, RoutedEventArgs e) {
      this.LoadResourceDictionary("Dictionary2.xaml");
    }
  
    private void LoadResourceDictionary(string name) {
      ResourceDictionary dictionary =
        (ResourceDictionary)Application.LoadComponent(new Uri(name, UriKind.Relative));
      if (dictionary != null) Application.Current.Resources = dictionary;
    }
  }

DynamicResource?参照 ＋ ディクショナリ ファイルの使用例

データ バインディング †

様々なソースと「データ バインディング」するサンプルを示す。

なお、サンプルのXAMLソースを読むためには、以下の、
Bindingプロパティの設定方法を理解しておく必要がある。

Bindingプロパティの設定方法

• MSDN > ・・・ > バインディングのマークアップ拡張機能
  http://msdn.microsoft.com/ja-jp/library/ms750413.aspx
  • MSDN > ・・・ > PropertyPath?のXAML構文
    http://msdn.microsoft.com/ja-jp/library/ms742451.aspx
  • MSDN > ・・・ > 方法：XMLDataProvider?とXPathクエリを試用してXMLデータにバインドする
    http://msdn.microsoft.com/ja-jp/library/ms749287.aspx

データ バインディングの基礎 †

以下、「WPFのアーキテクチャ - データ バインディング」に対応するサンプルを示す。

コードビハインドからのデータ バインディング（モード：OneWay?） †

• モード：OneWay?の「データ バインディング」を行う。
• 「データ バインディング」の基本的な動作を理解するために、
  • Bindingオブジェクトをコード ビハインドで自作し、
  • 以下の２つのオブジェクトを結びつける。
    • 「バインディング ソース」
    • 「バインディング ターゲット」

• XAML

  <StackPanel 
    x:Name="MainPanel"
    Loaded="MainPanel_Loaded">
    <TextBlock x:Name="TextBlock1"/>
    <TextBlock x:Name="TextBlock2"/>
  </StackPanel>

• コードビハインド

  public partial class Window1 : Window {
    public Window1() {
      InitializeComponent();
    }
  
    private void MainPanel_Loaded(object sender, RoutedEventArgs e)
    {
      // バインディング ソース（Person）
      Person BindingSource =
        new Person() { Height = 1.7, Weight = 60 };
  
      // Bindingオブジェクトによりバインド
  
      // HeightプロパティをOneWayでバインド
      Binding BindingHeight = new Binding("Height");
      BindingHeight.Mode = BindingMode.OneWay;
      // バインディング ソース（Person）
      BindingHeight.Source = BindingSource;
      // バインディング ターゲット（TextBlock）
      TextBlock1.SetBinding(TextBlock.TextProperty, BindingHeight);
  
      // WeightプロパティをOneWayでバインド
      Binding BindingWeight = new Binding("Weight");
      BindingWeight.Mode = BindingMode.OneWay;
      // バインディング ソース（Person）
      BindingWeight.Source = BindingSource;
      // バインディング ターゲット（TextBlock）
      TextBlock2.SetBinding(TextBlock.TextProperty, BindingWeight);
    } 
  }
  
  /// <summary>バインディング ソース（Person）</summary>
  public class Person {
    public double Height { get; set; }
    public double Weight { get; set; }
  }

コードビハインドからのDataContext?を使用したデータ バインディング（モード：OneWay?） †

上記のMainPanel_Loadedメソッドのコードを一部編集し、MainPanel?（StackPanel?）の
FrameworkElement?.DataContext?プロパティに「バインディング ソース」を設定することで、
Bindingオブジェクトへの「バインディング ソース」の指定が不要になる。

• コードビハインド

  private void MainPanel_Loaded(object sender, RoutedEventArgs e) {
    // バインディング ソース（Person）
    MainPanel.DataContext =
      new Person() { Height = 1.7, Weight = 60 };
  
    // Bindingオブジェクトによりバインド
  
    // HeightプロパティをOneWayでバインド
    Binding BindingHeight = new Binding("Height");
    BindingHeight.Mode = BindingMode.OneWay;
    // バインディング ターゲット（TextBlock）
    this.TextBlock1.SetBinding(TextBlock.TextProperty, BindingHeight);
  
    // WeightプロパティをOneWayでバインド
    Binding BindingWeight = new Binding("Weight");
    BindingWeight.Mode = BindingMode.OneWay;
    // バインディング ターゲット（TextBlock）
    TextBlock2.SetBinding(TextBlock.TextProperty, BindingWeight);
  }

BindingオブジェクトをXAMLで実装する（プロパティ要素構文） †

• BindingオブジェクトをXAMLのマークアップ機能で実装する。
  更に、XAMLのマークアップ機能を使用して、Bindingオブジェクトの生成処理・設定処理をXAML側に移動することで、
  上記のXAMLとMainPanel_Loadedメソッドのコードを一部編集し、コード ビハインドのコード量を削減できる。

• XAML

  <StackPanel 
    x:Name="MainPanel"
    Loaded="MainPanel_Loaded">
    <TextBlock>
      <TextBlock.Text>
        <Binding Path="Height" Mode="OneWay"/>
      </TextBlock.Text>
    </TextBlock>
    <TextBlock>
      <TextBlock.Text>
        <Binding Path="Weight" Mode="OneWay"/>
      </TextBlock.Text>
    </TextBlock>
  </StackPanel>

• コードビハインド

  private void MainPanel_Loaded
     (object sender, RoutedEventArgs e) {
  
    // バインディング ソース（Person）
    MainPanel.DataContext =
    new Person() { Height = 1.7, Weight = 60 };
  }

Bindingオブジェクトをバインディングのマークアップ拡張で実装する（プロパティ属性構文） †

• 一般的には、「データ バインディング」を実装する場合、XAML側の記述は（前述とは異なる）
  「バインディングのマークアップ拡張」により「プロパティ属性構文」化して実装する方法を採る。

• 上記のXAMLを「バインディングのマークアップ拡張」を使用して、「プロパティ属性構文」化して実装すると次のようになる。

  <StackPanel x:Name="MainPanel" Loaded="MainPanel_Loaded">
    <TextBlock Text="{Binding Path=Height, Mode=OneWay}" />
    <TextBlock Text="{Binding Path=Weight, Mode=OneWay}" />
  </StackPanel>

• また、属性名を省略すると自動的にコンストラクタに渡される動作を利用して、
  （Path属性に指定の値を渡す旨を指示する）「Path=」という記述を省略することができる。

  <StackPanel x:Name="MainPanel" Loaded="MainPanel_Loaded">
    <TextBlock Text="{Binding Height, Mode=OneWay}" />
    <TextBlock Text="{Binding Weight, Mode=OneWay}" />
  </StackPanel>

変更通知の追加（モード：OneWay? or OneWayToSource?） †

下記は、モード：OneWay? or OneWayToSource?を併用した「データ バインディング」によるBMI（肥満度）の自動計算アプリケーションの例である。
この例では、「バインディング ソース」のプロパティ値の変更を、自動的に「バインディング ターゲット」に反映できる。
なお、この際、「バインディング ソース」は、INotifyPropertyChanged?インターフェイスを実装して、BMI（肥満度）プロパティの変更通知処理を実装する必要がある。

• XAML

  <StackPanel x:Name="MainPanel" Loaded="MainPanel_Loaded">
    <TextBox Margin="10" Text="{Binding Height, Mode=OneWayToSource}"/>
    <TextBox Margin="10" Text="{Binding Weight, Mode=OneWayToSource}"/>
    <Button Margin="10" Content="計算" Click="Button_Click" />
    <TextBlock Margin="10" Text="{Binding Bmi, Mode=OneWay}"/>
  </StackPanel>

• コードビハインド

  /// <summary>/// Window1.xaml の相互作用ロジック/// </summary>
  public partial class Window1 : Window {
    public Window1() {
      InitializeComponent();
    }
  
    /// <summary>初期化イベント</summary>
    private void MainPanel_Loaded(object sender, RoutedEventArgs e) {
      // バインド ソース（Person）
      MainPanel.DataContext = new Person();
    }
    /// <summary>計算イベント</summary>
    private void Button_Click(object sender, RoutedEventArgs e) {
      ((Person)MainPanel.DataContext).Calculate();
    } 
  }

• バインディングソース

  /// <summary>バインド ソース（Person）</summary>
  public class Person : INotifyPropertyChanged {
    public double Height { get; set; }
    public double Weight { get; set; }
  
    double _bmi;
    public double Bmi {
      get { return this._bmi; }
      set {
        this._bmi = value;
  
        // 変更通知
        this.OnPropertyChanged("Bmi");
      }
    }
  
    /// <summary>計算処理</summary>
    public void Calculate() {
      this.Bmi = Weight / Math.Pow(Height, 2);
    }
  
    #region INotifyPropertyChanged メンバ
  
    /// <summary>値変更イベントの定義</summary>
    public event PropertyChangedEventHandler PropertyChanged;
  
    /// <summary>変更通知（値変更イベントを発生させる）</summary>
    protected virtual void OnPropertyChanged(string propertyName) {
      PropertyChangedEventHandler handler = this.PropertyChanged;
  
      if (handler != null)
        handler(this, new PropertyChangedEventArgs(propertyName));
    }
  
    #endregion
  }

値コンバータを使用したデータ バインディング（モード：OneWay? or OneWayToSource?） †

続いて、上記処理に、BMI（肥満度）プロパティが

• 18.5未満の場合、出力先のTextBlock?の背景色を青色に
• 25以上の場合、出力先のTextBlock?の背景色を赤色に

変更する処理を追加する。

これには別途、背景色プロパティを定義することで実現することも可能であるが、
ここでは、前述のIValueConverter?インターフェイスを実装した「値コンバータ」を実装することでこれを実現する。
値の変換処理は、「値コンバータ」のConvertメソッドに実装する。

• XAML

  <Window.Resources>
    <my:BmiLevelConverter x:Key="bmiLevelConverter"/>
  </Window.Resources>
  <StackPanel x:Name="MainPanel" Loaded="MainPanel_Loaded">
    <TextBox Margin="10" Text="{Binding Height, Mode=OneWayToSource}"/>
    <TextBox Margin="10" Text="{Binding Weight, Mode=OneWayToSource}"/>
    <Button Margin="10" Content="計算" Click="Button_Click" />
    <TextBlock Margin="10"
      Text="{Binding Bmi, Mode=OneWay}"
      Background="{Binding Bmi, Mode=OneWay,
      Converter={StaticResource bmiLevelConverter}}"/>
  </StackPanel>

• 値コンバータ

  /// <summary>BMIレベルに合った背景色を返す</summary>
  public class BmiLevelConverter : IValueConverter {
    #region IValueConverter メンバ
  
    /// <summary>変換メソッド（ソースからターゲット）</summary>
    public object Convert(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture) {
      // BMIレベルに合った背景色を返す
      double target = (double)value;
      SolidColorBrush level;
  
      if (target < 18.5)
        level = new SolidColorBrush(Colors.Blue);
      else if (target > 25)
        level = new SolidColorBrush(Colors.Red);
      else
        level = new SolidColorBrush(Colors.White);
  
      return level;
    }
  
    /// <summary>変換メソッド（ターゲットからソース）</summary>
    public object ConvertBack(object value, Type targetType, object parameter, System.Globalization.CultureInfo culture) {
      throw new NotImplementedException();
    }
  
    #endregion
  }

INotifyPropertyChanged?の変更通知を「依存関係プロパティ」で代替 †

なお、変更通知は、INotifyPropertyChanged?インターフェイスの実装ではなく、「依存関係プロパティ」でも代替できる。
上記の例のBMI（肥満度）プロパティを「依存関係プロパティ」として、以下のように書き直し、動作を確認する。

• バインディングソース

  /// <summary>バインド ソース（Person）</summary>
  public class Person : DependencyObject {
    public double Height { get; set; }
    public double Weight { get; set; }
  
    /// <summary>Bmiプロパティを依存関係プロパティとして登録</summary>
    public static readonly DependencyProperty BmiProperty =
      DependencyProperty.Register("Bmi", typeof(double), typeof(Person), 
          new UIPropertyMetadata(0.0));
  
    /// <summary>BmiプロパティのCLRプロパティ</summary>
    public double Bmi {
      get { return (double)this.GetValue(Person.BmiProperty); }
      set { this.SetValue(Person.BmiProperty, value); }
    }
  
    /// <summary>計算処理</summary>
    public void Calculate(){
      this.Bmi = Weight / Math.Pow(Height, 2);
    }
  }

BMI（肥満度）プロパティが変更されると、UI要素（TextBlock?）に変更が反映されることを確認できる。
このように、「依存関係プロパティ」は既定で変更通知をサポートしている。

双方向のデータ バインディング（モード：TwoWay?） †

以下の例では、モード：TwoWay?の「データ バインディング」を行うため、
2つのUI要素、TextBox?とSliderを双方向接続した例である。

なお前述のようにUI要素の表示に関するプロパティは、
基本的に「依存関係プロパティ」として定義されており、
既定で変更通知をサポートしている。このため、既定で双方向接続が可能である。

なお、「バインディング ソース」をUI要素に接続する場合は、ElementName?属性を使用すると良い。

• TextBox?（ソース）→Slider（ターゲット）

• XAML

  <StackPanel Orientation="Vertical">
    <Label>TextBox</Label>
    <TextBox x:Name="textBox1" Text="5"/>
    <Rectangle Height="20"></Rectangle>
    <Label>Slider</Label>
    <Slider x:Name="Slider1" 
      Value="{Binding ElementName=textBox1, Path=Text, Mode=TwoWay}"/>
  </StackPanel>

• Slider（ソース）→TextBox?（ターゲット）
  • バインディング ソース、バインディング ターゲットを反転する。
  • すると「バインディング ターゲット」（TextBox?）の変更が直ちに通知されなくなる。
    （TextBox?から、フォーカスが外れないとSliderに変更値が反映されない）。
  • これは、ほとんどの依存関係プロパティの既定値は PropertyChanged?であるが、Textプロパティの既定値は LostFocus?のため。
  • この場合、「バインディングのマークアップ拡張」に、「UpdateSourceTrigger?=PropertyChanged?」 という属性の記述を追加することで、
    「バインディング ターゲット」（TextBox?）からの変更が直ちに「バインディング ソース」（Slider）に通知されるようになる。

• XAML

  <StackPanel Orientation="Vertical">
    <Label>TextBox</Label>
    <TextBox x:Name="textBox1"
      Text="{Binding ElementName=Slider1, Path=Value, Mode=TwoWay}"/>
    <Rectangle Height="20"></Rectangle>
    <Label>Slider</Label>
    <Slider x:Name="Slider1" Value="5"/>
  </StackPanel>

• MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Data.Binding
  • UpdateSourceTrigger?プロパティ
    http://msdn.microsoft.com/ja-jp/library/system.windows.data.binding.updatesourcetrigger.aspx
  • UpdateSourceTrigger?列挙体
    http://msdn.microsoft.com/ja-jp/library/system.windows.data.updatesourcetrigger.aspx

値コンバータを使用したデータ バインディング（モード：TwoWay?） †

双方向の値の変換に対応した「値コンバータ」は、
Convert、ConvertBack?メソッドの双方を実装する必要がある。

• XAML

  <Window.Resources>
    <my:ValConverter x:Key="valConverter" />
  </Window.Resources>
  <StackPanel Orientation="Vertical">
    <Label>TextBox</Label>
    <TextBox x:Name="textBox1" Text="500"/>
    <Rectangle Height="20"></Rectangle>
    <Label>Slider</Label>
    <Slider x:Name="Slider1"
      Value="{Binding ElementName=textBox1, Path=Text, Mode=TwoWay,
      Converter={StaticResource valConverter}}"/>
  </StackPanel>

• コードビハインド

  public class ValConverter : IValueConverter {
    #region IValueConverter メンバ
  
    /// <summary>変換メソッド（ソースからターゲット）</summary>
    public object Convert(object value, Type targetType,
      object parameter, System.Globalization.CultureInfo culture) {
      return int.Parse(value.ToString()) / 100;
    }
  
    /// <summary>変換メソッド（ターゲットからソース）</summary>
    public object ConvertBack(object value, Type targetType,
      object parameter, System.Globalization.CultureInfo culture) {
      return ((double)value) * 100;
    }
  
    #endregion
  }

ItemsSource?へのデータ バインディング †

ItemsControl?から派生した要素のItemsSource?属性にコレクションを「データ バインディング」する場合、対象オブジェクトは反復処理をサポートしている必要がある。

• ItemsSource?へのデータ バインディング（UI要素を含まない「データ バインディング」）
  以下は、ObservableCollection?<T> コレクション クラスを使用して「データ バインディング」する例である。
  なお、ObservableCollection?<T>コレクション クラスは、INotifyPropertyChanged?インターフェイスを継承しており、変更通知が可能となっている。

• XAML

  <StackPanel x:Name="stackPanel1">
    <ListBox x:Name="listBox1" ItemsSource="{Binding}"/>
    <Button Height="23" Name="button1" Click="button1_Click">Button</Button>
  </StackPanel>

• コードビハインド

  public partial class Window1 : Window {
  
    ObservableCollection<string> _cities = new ObservableCollection<string>();
  
    public Window1() {
      InitializeComponent();
  
      this._cities.Add("札幌市");
      this._cities.Add("仙台市");
      this._cities.Add("静岡市");
  
      this.stackPanel1.DataContext = _cities;
    }
  
    private void button1_Click(object sender, RoutedEventArgs e) {
      this._cities.Add("神戸市" + this.listBox1.Items.Count.ToString());
    }
  }

• UI要素を含まない「データ バインディング」の実装例について、
  • 上記例では、button1_ClickイベントでItemがObservableCollection?<T>コレクションに追加さると直ちにListBox?の表示に反映されることが確認できる。
    また、この変更通知をサポートしているObservableCollection?<T>コレクション クラスを、変更通知をサポートしないCollection<T> コレクション クラスに変更した場合、
    Collection<T>コレクションに追加されたItemがListBox?の表示に反映されないことも確認できる。
  • なお、変更通知に対応したカスタム コレクションを作成する場合は、
    ObservableCollection?<T>や、Collection<T> & INotifyCollectionChanged?を継承したカスタム コレクションを作成すると良い。
  • この際の注意点としては、後者のCollection<T> & INotifyCollectionChanged?を継承したカスタム コレクションを作成する場合、
    Add、RemoveAt?などのメソッドに変更通知を実装し、「変更通知の基盤処理」の値変更イベントに、
    前述のPropertyChangedEventHandler?ではなく、NotifyCollectionChangedEventHandler?を使用する点である。

• ItemsSource?へのデータ バインディング（UI要素を含んだ「データ バインディング」）
  以下は、「Itemsプロパティ」の例を「データ バインディング」で実装した例である。

• XAML

  <StackPanel x:Name="stackPanel1">
    <ListBox ItemsSource="{Binding}"/>
  </StackPanel>

• コードビハインド

  public Window1() {
    InitializeComponent();
  
    // バンディング ソース（コレクション）
    ObservableCollection<Border> cities = new ObservableCollection<Border>();
  
    // ワーク
    Border tmpBorder = null;
    StackPanel tmpStackPanel = null;
    Image tmpImage = null;
    TextBlock tmpTextBlock = null;
  
    // Borderの構築
    tmpBorder = new Border();
    tmpBorder.BorderBrush = Brushes.Black;
    tmpBorder.BorderThickness = new Thickness(1);
    tmpBorder.Margin = new Thickness(5);
  
    // StackPanelの構築
    tmpStackPanel = new StackPanel();
    tmpStackPanel.Orientation = Orientation.Horizontal;
    tmpStackPanel.Height = 120;
    tmpStackPanel.Width = 250;
    tmpStackPanel.Margin = new Thickness(5);
  
    // Imageの構築
    tmpImage = new Image();
    tmpImage.Source=new BitmapImage(
      new Uri(@".\Water lilies.jpg", UriKind.Relative));
    tmpImage.Height=100;
  
    // TextBlockの構築
    tmpTextBlock = new TextBlock();
    tmpTextBlock.Text="Water lilies";
    tmpTextBlock.VerticalAlignment = VerticalAlignment.Center;
  
    // 階層構造の組み立て
    tmpStackPanel.Children.Add(tmpImage);
    tmpStackPanel.Children.Add(tmpTextBlock);
  
    tmpBorder.Child = tmpStackPanel;
  
    // バンディング ソース（コレクション）に追加
    cities.Add(tmpBorder);
  
    // ・・・（ｎ項繰り返し）・・・
  
    // データ バンディング
    stackPanel1.DataContext = cities;
  }

• UI要素を含んだ「データ バインディング」の実装例について、
  • 子要素を持つUI要素をコードビハインドで作成し、これを「データ バインディング」する実装例も、一般的ではない。
  • このような場合は、「テンプレート」を使用するのが一般的である。
  • 「テンプレート」を使用した実装例は、「スタイルとテンプレート」 - 「テンプレート」を参照のこと。

インデクサによるデータ バインディング †

インデクサについても、Path属性に角括弧を指定することで接続可能である。

• XAML

  <Grid>
    <Image x:Name="Image1"
      Height="200" Width="200"
      Source="{Binding Path=[Source]}"
      ToolTip="{Binding Path=[ToolTip]}"/>
  </Grid>

• コードビハインド

  public Window1() {
    InitializeComponent();
  
    Hashtable ht = new Hashtable();
    ht["Source"] = @".\Winter.jpg";
    ht["ToolTip"] = "Winter";
    this.Image1.DataContext = ht;
  }

これらを応用すると、

インデクサを持つオブジェクトの配列（反復処理をサポート）
をデータ バインディングすることも可能であることが分かる。

ビジネス・アプリケーションでは、DataGrid?へDataTable?をデータ バインディングする際に、
DataGrid?の列へDataTable?の列をマッピングするようなケースでよく利用します。

リソースとのデータ バインディング †

「リソース」参照を「バインディングのマークアップ拡張」でも使用することができる。

StaticResource?を使用したデータ バインディング †

• 例えば、静的な「リソース」を使用し、以下のように「データ バインディング」できる。

• StaticResource?のデータ バインディング (1)

  <Window.Resources>
    <sys:String x:Key="val">Click Here</sys:String >
  </Window.Resources>
  <StackPanel>
    <Button Content="{Binding Source={StaticResource val}}"/>
  </StackPanel>

  ※ 先頭で、String型のインポートが必要
  xmlns:sys="clr-namespace:System;assembly=mscorlib"

• ItemsControl?から派生したUIコントロールのItemsSource?属性に「データ バインディング」する場合、
  「リソース」の対象オブジェクトは反復処理をサポートしている必要がある。
  • StaticResource?のデータ バインディング (2)

    <Window.Resources>
      <x:Array x:Key="list"
        Type="{x:Type sys:String}">
        <sys:String>A</sys:String>
        <sys:String>B</sys:String>
        <sys:String>C</sys:String>
      </x:Array>
    </Window.Resources>
    <StackPanel>
      <ListBox ItemsSource="{Binding Source={StaticResource list}}"/>
    </StackPanel>

    ※ 先頭で、String型のインポートが必要
    xmlns:sys="clr-namespace:System;assembly=mscorlib"

DynamicResource?を使用したデータ バインディング †

動的な「リソース」を使用した「データ バインディング」はサポートされない。
以下、「{Binding Source={DynamicResource?」をテストした際のエラーメッセージである。

型 'Binding' の 'Source' プロパティで 'DynamicResourceExtension' を設定することはできません。'DynamicResourceExtension' は、DependencyObject の DependencyProperty でのみ設定できます。

• 参考
  • MSDN > .NET Frameworkクラス ライブラリ
    • >　System.Windows.Data.Binding.Sourceプロパティ
      http://msdn.microsoft.com/ja-jp/library/system.windows.data.binding.source.aspx
    • >　System.Windows.DynamicResourceExtension?クラス
      http://msdn.microsoft.com/ja-jp/library/system.windows.dynamicresourceextension.aspx

レイアウト †

ココでは、レイアウト方法として、

• レイアウトのプロパティ
• パネルの種類と使い方

の2つについて説明する。

• MSDN > WPFの基礎 > レイアウト システム
  http://msdn.microsoft.com/ja-jp/library/ms745058.aspx

レイアウトのプロパティ †

• ココでは、「レイアウト」関係のプロパティについて説明する。

• これらのプロパティは、「レイアウト」機能を追加するFrameworkElement?基本クラスにより提供される。
  • 配置の際、各要素間に余白を指定したい場合は、Margin、Padding属性を使用する。
    • Margin ：自要素と親要素の間
    • Padding：自要素と子要素の間
      ※ [left, top, right, bottom]と設定可能。省略時の動作は、リファレンスを参照のこと。
  • 配置の際、「揃え」を指定したい場合は、HorizontalAlignment?、VerticalAlignment?属性を使用する。
    • HorizontalAlignment? ：水平方法の揃え（Center、Left、Right、Stretchを指定可）
    • VerticalAlignment? ：垂直方法の揃え（Center、Top、Bottom、Stretchを指定可）
      ※ Stretchは、引き伸ばして余白を埋めて配置の意味。

• 以下、「レイアウト」関係のプロパティを使用したXAMLとレンダリングの例を示す。
  • XAML

    <Border Background="LightBlue" BorderBrush="Black" BorderThickness="2" Padding="15">
      <StackPanel Background="White" HorizontalAlignment="Center" VerticalAlignment="Top">
        <TextBlock Margin="5,0,5,0" HorizontalAlignment="Center">Alignment, Margin and Padding Sample</TextBlock>
        <Button HorizontalAlignment="Left" Margin="20">Button 1</Button>
        <Button HorizontalAlignment="Right" Margin="10">Button 2</Button>
        <Button HorizontalAlignment="Stretch" Margin="0">Button 3</Button>
      </StackPanel>
    </Border>

  • レンダリング

• 参考
  • MSDN > WPFの基礎 > 基本要素 > 配置、余白、パディングの概要
    http://msdn.microsoft.com/ja-jp/library/ms751709.aspx

パネルの種類と使い方 †

WPFでは、パネルを使用した「レイアウト」が可能である。

• パネルには、以下のような特徴がある。
  • 複数のUIElementを含めることができる（UIElementCollection? のプロパティを持つ）。
    • MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Controls.UIElementCollection?クラス
      http://msdn.microsoft.com/ja-jp/library/system.windows.controls.uielementcollection.aspx

      UIElement子要素の順序付けられたコレクションを表す。
      XAMLから「プロパティ要素構文」の「コンテンツ構文」でパネル要素に子要素を追加する場合は、
      <Panel.Children>タグを使用する（ただし、このタグを明示しなくとも、暗黙的に使用される）。
      また、コード ビハインドから、パネル要素に子要素を追加する場合は、Children.Add メソッドを使用する。

• 自分に含まれるUIElementを管理する。
• パネル自体もUIElementであるため、パネルへの組み込みが可能

• 使用可能なパネル要素には次のものがある。

  #	パネル名	クラス名	説明
  1	キャンバス パネル	Canvas	座標を使用して子要素を明示的に配置できる領域を定義する。
  2	ドック パネル	DockPanel?	パネルの各「辺」に、子要素をドッキングする領域を定義する。
  3	スタック パネル	StackPanel?	子要素を水平方向または垂直方向に整列する領域を定義する。
  4	折り返しパネル	WrapPanel?	子要素を水平方向または垂直方向に整列し、端に達したら改行して整列する領域を定義する。
  5	（均一）グリッド パネル	UniformGrid?	列と行で構成されているグリッド領域を定義する。
  6	グリッド パネル	Grid	列と行で構成されている柔軟なグリッド領域を定義する。

• また、親要素であるパネルへ配置する子要素の座標などの情報については、
  子要素から「添付プロパティ」を使用して設定可能である。

キャンバス パネル †

• 座標を使用して子要素を明示的に配置できる領域を定義する。
  • XAML

    <Canvas Background="LightSteelBlue">
      <TextBlock Canvas.Top="10" Canvas.Left="20">
        Hello World!
      </TextBlock>
      <TextBlock Canvas.Top="40" Canvas.Left="50">
        絶対位置決め方式は便利ではありませんか？
      </TextBlock>
    </Canvas>

  • レンダリング結果
    

• キャンバス パネルでは、「添付プロパティ」であるCanvas.Top・Canvas.Left属性を使用して、
  子要素から座標位置を明示的に指定・配置できるため、Windowsフォームに近い開発が可能である。

• 参考
  • MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Controls.Canvasクラス
    http://msdn.microsoft.com/ja-jp/library/system.windows.controls.canvas.aspx

ドック パネル †

• パネルの各「辺」に、子要素をドッキングする領域を定義する。
  • XAML

    <DockPanel LastChildFill="True">
      <Border Height="25" Background="SkyBlue" DockPanel.Dock="Top">
        <TextBlock Foreground="Black">Dock = "Top（１）"</TextBlock>
      </Border>
      <Border Height="25" Background="SkyBlue" DockPanel.Dock="Top">
        <TextBlock Foreground="Black">Dock = "Top（２）"</TextBlock>
      </Border>
      <Border Height="25" Background="LemonChiffon" DockPanel.Dock="Bottom">
        <TextBlock Foreground="Black">Dock = "Bottom"</TextBlock>
      </Border>
      <Border Width="100" Background="PaleGreen" DockPanel.Dock="Left">
        <TextBlock Foreground="Black">Dock = "Left"</TextBlock>
      </Border>
      <Border Background="White">
        <TextBlock Foreground="Black">
          This content will "Fill" the remaining space
        </TextBlock>
      </Border>
    </DockPanel>

  • レンダリング結果
    

• DockPanel?.LastChildFill?プロパティ（LastChildFill?属性）をtrue （既定値）に設定すると、
  DockPanel?の最終の子要素は常に残りの領域を埋めるようになる。

• 参考
  • MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Controls.DockPanel?クラス
    http://msdn.microsoft.com/ja-jp/library/system.windows.controls.dockpanel.aspx

スタック パネル †

• 子要素を水平方向または垂直方向に整列する領域を定義する。
  • XAML
    • 水平方向

      <StackPanel Orientation="Horizontal">
        <RadioButton Margin="4">test1</RadioButton>
        <RadioButton Margin="4">test2</RadioButton>
        <RadioButton Margin="4">test3</RadioButton>
      </StackPanel>

    • 垂直方向

      <StackPanel Orientation="Vertical">
        <RadioButton Margin="4">test1</RadioButton>
        <RadioButton Margin="4">test2</RadioButton>
        <RadioButton Margin="4">test3</RadioButton>
      </StackPanel>

  • レンダリング結果
    • 水平方向
      
    • 垂直方向
      

• 整列方向は、StackPanel?.Orientationプロパティ（Orientation属性）で指定する。

• 参考
  • MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Controls.StackPanel?クラス
    http://msdn.microsoft.com/ja-jp/library/system.windows.controls.stackpanel.aspx

折り返しパネル †

• 子要素を水平方向または垂直方向に整列し、端に達したら改行して整列する領域を定義する。
  ※ パネルのサイズが変更されると、改行位置も変更される。
  • XAML
    • 水平方向

      <WrapPanel Orientation="Horizontal">            
        <Button Width="26" Height="26" Margin="4" Content="0"></Button>
        <Button Width="26" Height="26" Margin="4" Content="1"></Button>
        <Button Width="26" Height="26" Margin="4" Content="2"></Button>
      　・・・
        <Button Width="26" Height="26" Margin="4" Content="7"></Button>
        <Button Width="26" Height="26" Margin="4" Content="8"></Button>
        <Button Width="26" Height="26" Margin="4" Content="9"></Button>
      </WrapPanel>

    • 垂直方向

      <WrapPanel Orientation="Vertical">            
        <Button Width="26" Height="26" Margin="4" Content="0"></Button>
        <Button Width="26" Height="26" Margin="4" Content="1"></Button>
        <Button Width="26" Height="26" Margin="4" Content="2"></Button>
      　・・・
        <Button Width="26" Height="26" Margin="4" Content="7"></Button>
        <Button Width="26" Height="26" Margin="4" Content="8"></Button>
        <Button Width="26" Height="26" Margin="4" Content="9"></Button>
      </WrapPanel>

  • レンダリング結果
    • 水平方向
      
    • 垂直方向
      

• 整列方向は、WrapPanel?.Orientationプロパティ（Orientation属性）で指定する。

• 参考
  • MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Controls.WrapPanel?クラス
    http://msdn.microsoft.com/ja-jp/library/system.windows.controls.wrappanel.aspx

（均一）グリッド パネル †

• 列と行で構成されているグリッド領域を定義する。
  ※ グリッド内のすべてのセルが同じサイズである必要がある。
  • XAML
    • 3行 * 4列

      <UniformGrid Rows="3" Columns="4"> 
        <Button Width="26" Height="26" Margin="4" Content="0"></Button>
        <Button Width="26" Height="26" Margin="4" Content="1"></Button>
        <Button Width="26" Height="26" Margin="4" Content="2"></Button>
      　・・・
        <Button Width="26" Height="26" Margin="4" Content="7"></Button>
        <Button Width="26" Height="26" Margin="4" Content="8"></Button>
        <Button Width="26" Height="26" Margin="4" Content="9"></Button>
      </UniformGrid>

    • 4行 * 3列

      <UniformGrid Rows="4" Columns="3">
        <Button Width="26" Height="26" Margin="4" Content="0"></Button>
        <Button Width="26" Height="26" Margin="4" Content="1"></Button>
        <Button Width="26" Height="26" Margin="4" Content="2"></Button>
      　・・・
        <Button Width="26" Height="26" Margin="4" Content="7"></Button>
        <Button Width="26" Height="26" Margin="4" Content="8"></Button>
        <Button Width="26" Height="26" Margin="4" Content="9"></Button>
      </UniformGrid>

  • レンダリング結果
    • 3行 * 4列
      
    • 4行 * 3列
      

• 行・列数は、UniformGrid?.Rows、UniformGrid?.Columns属性（UniformGrid?. Rows・Columnsプロパティ）で指定する。

• 参考
  • MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Controls.UniformGrid?クラス
    http://msdn.microsoft.com/ja-jp/library/system.windows.controls.primitives.uniformgrid.aspx

グリッド パネル †

• 列と行で構成されている柔軟なグリッド領域を定義する。
  • 行・列の定義にGrid.RowDefinitions?、Grid.ColumnDefinitions?タグを使用する。
    • 「添付プロパティ」であるGrid.Row・Grid.Column属性を使用して子要素をセルへ配置する。
    • 列長・行長の設定も、この属性で指定する。
    • このためHTMLのテーブルと使い方は異なる。

• XAML ( 4行 * 3列

  <Grid Width="250" Height="100">
    <Grid.ColumnDefinitions>
      <ColumnDefinition />
      <ColumnDefinition />
      <ColumnDefinition />
    </Grid.ColumnDefinitions>
    <Grid.RowDefinitions>
      <RowDefinition />
      <RowDefinition />
      <RowDefinition />
      <RowDefinition />
    </Grid.RowDefinitions>
  
    <TextBlock Grid.ColumnSpan="3" Grid.Row="0">2005 Products Shipped</TextBlock>
    <TextBlock Grid.Row="1" Grid.Column="0">Quarter 1</TextBlock>
    <TextBlock Grid.Row="1" Grid.Column="1">Quarter 2</TextBlock>
    <TextBlock Grid.Row="1" Grid.Column="2">Quarter 3</TextBlock>
    <TextBlock Grid.Row="2" Grid.Column="0">50000</TextBlock>
    <TextBlock Grid.Row="2" Grid.Column="1">100000</TextBlock>
    <TextBlock Grid.Row="2" Grid.Column="2">150000</TextBlock>
    <TextBlock Grid.ColumnSpan="3" Grid.Row="3">Total Units: 300000</TextBlock>
  </Grid>

• レンダリング結果
  

• なお、ColumnDefinition?タグのWidth属性に" n*"と指定することで、比率を指定できる。
  • XAML ( 比率を指定

    <Grid>
      <Grid.ColumnDefinitions>
        <ColumnDefinition Width="1*"></ColumnDefinition>
        <ColumnDefinition Width="2*"></ColumnDefinition>
        <ColumnDefinition Width="3*"></ColumnDefinition>
      </Grid.ColumnDefinitions>
      <Grid.RowDefinitions>
        <RowDefinition Height="1*"></RowDefinition>
        <RowDefinition Height="2*"></RowDefinition>
        <RowDefinition Height="3*"></RowDefinition>
      </Grid.RowDefinitions>
    </Grid>

  • レンダリング結果
    

• 参考
  • MSDN > .NET Frameworkクラス ライブラリ > System.Windows.Controls.Gridクラス
    http://msdn.microsoft.com/ja-jp/library/system.windows.controls.grid.aspx

スタイルとテンプレート †

ココでは、「外観」に関する設定を行う「スタイル」と「テンプレート」について説明する。

• 参考
  • MSDN > WPFの基礎 > スタイルとテンプレート ： 概念
    http://msdn.microsoft.com/ja-jp/library/bb613570.aspx
    • > スタイルとテンプレート
      http://msdn.microsoft.com/ja-jp/library/ms745683.aspx
    • > ControlTemplate?の作成による既存のコントロールの外観のカスタマイズ
      http://msdn.microsoft.com/ja-jp/library/ee230084.aspx

• MSDN > Windows Presentation Foundation > コントロール
  • > コントロールのカスタマイズ > ControlTemplate?の例
    http://msdn.microsoft.com/ja-jp/library/aa970773.aspx

スタイル †

スタイルの基本 †

「スタイル」は、UI要素の「依存関係プロパティ」の一括管理機能を持ち、これを使用して「外観」に統一性を持たせるための機能である。
「スタイル」は、Style型のオブジェクトであり、各UI要素（FrameworkElement? or FrameworkContentElement?）のStyleプロパティに指定可能である。

• 外観に関する値を設定する「プロパティ属性構文」
  以下は、UI要素の「依存関係プロパティ」に、「外観」に関するFill、Height、Width属性の属性値を設定する「プロパティ属性構文」である。
  • XAML

    <Grid>
      <Ellipse Fill="Blue" Height="80" Width="160"/>
    </Grid>

  • レンダリング結果
    

• プロパティ属性構文のスタイル化
  • 上記を、「プロパティ要素構文」を使用してStyle型のオブジェクトを生成し、Styleプロパティにこれを指定する例を以下に示す。
    • TargetType?属性により、「スタイル」は指定の型（ここではEllipse要素）に適用される。
    • このTargetType?属性による型指定が無いと、対象のプロパティの有・無などが判別できないため、型指定は必須となっている。

• XAML

  <Grid>
    <Ellipse>
      <Ellipse.Style>
        <Style TargetType="Ellipse">
          <Setter Property="Fill" Value="Blue"/>
          <Setter Property="Height" Value="80"/>
          <Setter Property="Width" Value="160"/>
        </Style>
      </Ellipse.Style>
    </Ellipse>
  </Grid>

• レンダリング結果
  

• スタイルをリソースとして定義
  • なお、上記の「スタイル」化は、通常のプロパティ設定を冗長に記述しているに過ぎず、何の意味もなさない。
  • このため、通常、「スタイル」を「リソース」として定義し、各UI要素のStyleプロパティにはStaticResource?参照を使用して設定する。

• 以下は、x:Keyを明示した例である。
  • XAML

      <StackPanel.Resources>
        <Style x:Key="EllipseStyle" TargetType="Ellipse">
          <Setter Property="Fill" Value="Blue"/>
          <Setter Property="Height" Value="80"/>
          <Setter Property="Width" Value="160"/>
        </Style>
      </StackPanel.Resources>
      <Ellipse Style="{StaticResource EllipseStyle}"/>
      <Ellipse Style="{StaticResource EllipseStyle}"/>
    </StackPanel>

  • レンダリング結果
    

• ベースクラスの型にスタイルを適用
  また、派生元（ここではShape型）が同じであれば、異なる要素でも同じ「スタイル」を適用できる。
  • XAML

    <StackPanel>
      <StackPanel.Resources>
        <Style x:Key="ShapeStyle" TargetType="Shape">
          <Setter Property="Fill" Value="Blue"/>
          <Setter Property="Height" Value="80"/>
          <Setter Property="Width" Value="160"/>
        </Style>
      </StackPanel.Resources>
      <Ellipse Style="{StaticResource ShapeStyle}"/>
      <Rectangle Style="{StaticResource ShapeStyle}"/>
    </StackPanel>

  • レンダリング結果
    

• スタイルを全体に適用する例
  x:Keyを設定しなければ、TargetType?属性により、「スタイル」は指定の型（ここではEllipse型）、全体に適用される
  （ただし、派生元が同じだが、型の異なる全ての要素に「スタイル」を適用することはできない）。
  
  • XAML

    <StackPanel>
      <StackPanel.Resources>
        <Style TargetType="Ellipse">
          <Setter Property="Fill" Value="Blue"/>
          <Setter Property="Height" Value="80"/>
          <Setter Property="Width" Value="160"/>
        </Style>
      </StackPanel.Resources>
      <Ellipse/>
      <Ellipse/>
    </StackPanel>

  • レンダリング結果
    

スタイルの継承 †

• TargetType? プロパティが同じ２つのStyleクラスを定義し、
  BasedOn?プロパティに継承元となるStyleクラスを設定することで、

  「スタイル」の継承が可能である。

（Silverlight 2のStyleクラスにはBasedOn?プロパティが存在しなかったが、Silverlight 3で追加されている）

• スタイルの継承例
  • XAML

    <StackPanel>
      <StackPanel.Resources>
        <Style x:Key="EllipseBaseStyle" TargetType="Ellipse">
          <Setter Property="Fill" Value="Blue"/>
          <Setter Property="Height" Value="80"/>
          <Setter Property="Width" Value="160"/>
        </Style>
        <Style x:Key="EllipseInheritedStyle" TargetType="Ellipse"
          BasedOn="{StaticResource EllipseBaseStyle}">
          <Setter Property="Stroke" Value="Yellow"/>
          <Setter Property="StrokeThickness" Value="10"/>
        </Style>
      </StackPanel.Resources>
      <Ellipse Style="{StaticResource EllipseBaseStyle}"/>
      <Ellipse Style="{StaticResource EllipseInheritedStyle}"/>
     </StackPanel>

  • レンダリング結果
    

外部ディクショナリ ファイル化 †

• 「ディクショナリ ファイル」を使用して、CSSファイルのように、
  「スタイル」を外部ディクショナリ ファイルに定義することも可能である。

• 以下は、「ディクショナリ ファイル」を使用する例である。
  • XAML

    <Window.Resources>
      <ResourceDictionary Source="Dictionary1.xaml"/>
    </Window.Resources>
    <StackPanel>
      <StackPanel.Resources>
        <Style x:Key="EllipseInheritedStyle" TargetType="Ellipse"
          BasedOn="{StaticResource EllipseBaseStyle}">
          <Setter Property="Stroke" Value="Yellow"/>
          <Setter Property="StrokeThickness" Value="10"/>
        </Style>
      </StackPanel.Resources>
      <Ellipse Style="{StaticResource EllipseBaseStyle}"/>
      <Ellipse Style="{StaticResource EllipseInheritedStyle}"/>
    </StackPanel>

  • XAML ( 外部ディクショナリ ファイル : Dictionary1.xaml

    <ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
      xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
      <Style x:Key="EllipseBaseStyle" TargetType="Ellipse">
        <Setter Property="Fill" Value="Blue"/>
        <Setter Property="Height" Value="80"/>
        <Setter Property="Width" Value="160"/>
      </Style>
    </ResourceDictionary>

実行時スタイル †

• 「リソースの定義と参照」の
  • DynamicResource?参照
  • ディクショナリ ファイル

の方法を、「スタイル」でも応用可能である。

• 上記の例のXAMLを以下のように書き換え、
  コードビハインドからResourceDictionary?を切り換え
  「スタイル」（スキン）を実行時に、動的に切り換えることができる。
  • XAML

    <StackPanel>
      <Ellipse Style="{DynamicResource MyEllipseStyle}"/>
      <Button Content="青" Height="23" Name="button1" Width="75" Click="button1_Click" />
      <Button Content="赤" Height="23" Name="button2" Width="75" Click="button2_Click" />
    </StackPanel>

  • XAML ( 外部ディクショナリ ファイル :
    • Dictionary1.xaml

      <ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
        <Style x:Key="MyEllipseStyle" TargetType="Ellipse">
          <Setter Property="Fill" Value="Blue"/>
          <Setter Property="Height" Value="80"/>
          <Setter Property="Width" Value="160"/>
        </Style>
      </ResourceDictionary>

    • Dictionary2.xaml

      <ResourceDictionary xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
          xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
          <Style x:Key="MyEllipseStyle" TargetType="Ellipse">
              <Setter Property="Fill" Value="Red"/>
              <Setter Property="Height" Value="160"/>
              <Setter Property="Width" Value="80"/>
          </Style>
      </ResourceDictionary>

  • コード・ビハインド

    public partial class Window1 : Window {
      public Window1() {
        InitializeComponent();
        this.LoadResourceDictionary("Dictionary1.xaml");
      }
    
      private void button1_Click(object sender, RoutedEventArgs e) {
        this.LoadResourceDictionary("Dictionary1.xaml");
      }
    
      private void button2_Click(object sender, RoutedEventArgs e) {
        this.LoadResourceDictionary("Dictionary2.xaml");
      }
    
      private void LoadResourceDictionary(string name) {
        ResourceDictionary dictionary =
          (ResourceDictionary)Application.LoadComponent(new Uri(name, UriKind.Relative));
        if (dictionary != null) Application.Current.Resources = dictionary;
      }
    }

  • レンダリング結果
    

テンプレート †

テンプレートの基本 †

• 「コンテンツ構文」でも述べたように、WPFのUIコントロールは、
  「プロパティ属性構文」と「プロパティ要素構文」を使用することによって、
  • 「スタイル」属性の指定だけでなく、
  • Contentプロパティ（またはItemsプロパティ）に

任意の型の子要素を設定することができる。

• このため、WPFのUIコントロールはコントロールの「外観」を自由に変更でき、柔軟性が非常に高くなっている。

• また、「テンプレート」により、
  • コントロールの「外観」を宣言型マークアップでカスタマイズ可能になる（「テンプレート」を複数の子要素から構成する）。
  • また、「イベント ハンドラ」や「イベント トリガ」なども、この「テンプレート」により定義可能で、
    「テンプレート」を「スタイル」化することで、任意の型のコントロールに、これらの「テンプレート」の定義の適用を強制できる。

• 「テンプレート」は、コントロールの用途毎に、複数のものが用意されている。
  • テンプレートを設定するのプロパティと、テンプレートの型

    #	テンプレートを設定するプロパティ	テンプレートのクラス型	説明
    1	Control.Template	ControlTemplate?	Control.Templateプロパティに設定するControlTemplate?クラスは、 Controlコントロールを表示する「テンプレート」を定義する際に使用する。
    2	ContentControl?.ContentTemplate?	DataTemplate?	ContentControl?.ContentTemplate?プロパティに設定するDataTemplate?クラスは、 ContentControl?コントロールのContentプロパティのデータを表示する「テンプレート」を定義する際に使用する。
    3	ItemsControl?.ItemTemplate?	DataTemplate?	ItemsControl?.ItemTemplate?プロパティに設定するDataTemplate?クラスは、 ItemsControl?コントロールのItemsプロパティのデータを使用する「テンプレート」を定義する際に使用する。
    4	HeaderTemplate?、CellTemplate?など	DataTemplate?	種々のコントロールに独自のテンプレートが存在する。

• ただし、「テンプレート」で作成できる「外観」は、静的なものに限られる。

• 参考
  • MSDN > Windows Presentation Foundation
    • > データ > データ バインディング > データ テンプレートの概要
      http://msdn.microsoft.com/ja-jp/library/ms742521.aspx
  • MSDN > .NET Frameworkクラス ライブラリ
    • > System.Windows.Controls.Control.Templateプロパティ
      http://msdn.microsoft.com/ja-jp/library/system.windows.controls.control.template.aspx
    • > System.Windows.Controls.ContentControl?.ContentTemplate?プロパティ
      http://msdn.microsoft.com/ja-jp/library/system.windows.controls.contentcontrol.contenttemplate.aspx
    • > System.Windows.Controls.ItemsControl?.ItemTemplate?プロパティ
      http://msdn.microsoft.com/ja-jp/library/system.windows.controls.itemscontrol.itemtemplate.aspx
    • > System.Windows.Controls.ControlTemplate?クラス
      http://msdn.microsoft.com/ja-jp/library/system.windows.controls.controltemplate.aspx
    • > System.Windows.DataTemplate?クラス
      http://msdn.microsoft.com/ja-jp/library/system.windows.datatemplate.aspx

「テンプレート」値を反映させる方法 †

また、親コントロールに適用した、「テンプレート」の値を
Contentプロパティ（またはItemsプロパティ）を含む
プロパティ値に反映させるにめには、下記の3通りの方法を使用できる。

• 「プレゼンター」を利用する方法
  • 親コントロールのContentプロパティの場合は、ContentPresenter? を用いる。
    Contentプロパティは、任意の型の子要素を取得し、「テンプレート」に反映できる。

• また、ItemsControl?のItemsプロパティに対応するものにItemsPresenter? があり、
  Itemsプロパティの並びを、ItemsControl?のItemsPanel? プロパティのItemsPanelTemplate? で変更できる。

• その他、コントロールによって、ScrollContentPresenter? 、CellValuePresenter?などの「プレゼンター」が用意されている。

• なお、DataTemplate?は、
  • ContentPresenter?（Contentプロパティ）
  • ItemsPresenter?（Itemsプロパティ）
    の表示をカスタマイズするための「テンプレート」である。
    このため、ControlTemplate?とDataTemplate?の両方のカスタマイズを行う場合は、
    ControlTemplate?側に必ず、ContentPresenter?・ItemsPresenter?を含める必要がある点に注意が必要である。

• TemplateBinding の「マークアップ拡張」を使用する。
  親コントロールに適用したプロパティ値を「テンプレート」に反映させる。

  <object property="{TemplateBinding TargetProperty }" .../>

• 同様に、RelativeSource の「マークアップ拡張」も使用できる。

  <Binding RelativeSource="{RelativeSource TemplatedParent}" .../>

  • なお、「データ バインディング」で使用する場合は、次のようになる。

    <object property="{Binding RelativeSource={RelativeSource TemplatedParent} ...}" .../>

  • RelativeSource?の例
    • XAML

      <StackPanel>
      
        <TextBlock Text="{Binding RelativeSource
          ={RelativeSource Self}, Path=FontFamily}" />・・・(1)
      
        <Border Background="Black" Height="5"/>
      
        <TextBlock Text="{Binding RelativeSource
          ={RelativeSource AncestorType={x:Type StackPanel}},Path=Orientation}" />・・・(2)
      
        <Border Background="Black" Height="5"/>
      
        <Button Content="Hello world">
          <Button.Template>
            <ControlTemplate TargetType="{x:Type Button}">
              <ContentPresenter Content="{Binding RelativeSource
                ={RelativeSource TemplatedParent}, Path=Content}" />・・・(3)
            </ControlTemplate>
          </Button.Template>
        </Button>
      
      </StackPanel>

    • レンダリング結果
      

• 説明
  • (1) では、TextBlock?要素自身のFontFamily?プロパティを取得して、自身のTextプロパティに設定している。
  • (2) では、親要素（AncestorType? 属性に指定されているStackPanel?型）を検索し、Orientationプロパティを取得して、自身のTextプロパティに設定している。
  • (3) では、TemplatedParent? 属性により、テンプレートを適用しているControlTemplate?（ここでは、ControlTemplate?であるButton要素）の
    Contentプロパティを取得し、ContentPresenter?クラスのContentプロパティに設定している。

コントロールと「テンプレート」内の各要素の関係 †

以上を纏めた、コントロールと「テンプレート」内の各要素の関係は、次のようになる。

• ContentControl?コントロール
  • ContentControl?全体の外観のカスタマイズ
    ContentControl?の（Control.）Templateプロパティには、ControlTemplate?クラスを設定する。
    • 各種プロパティの表示方法
      各種プロパティを表示するための要素をControlTemplate?クラスに含める。
    • Contentプロパティの表示方法
      ContentControl?.Contentプロパティを表示する ContentPresenter?クラスをControlTemplate?クラスに含める。
  • ContentControl?のContentプロパティのデータ表示の外観のカスタマイズ
    ContentControl?.ContentTemplate?プロパティには、DataTemplate?クラスを設定する。
    • 各種プロパティの表示方法
      各種プロパティを表示するための要素をDataTemplate?クラスに含める。

• ItemsControl?コントロール
  • ItemsControl?全体の外観のカスタマイズ
    ItemsControl?の（Control. ）Templateプロパティには、ControlTemplate?クラスを設定する。
    • 各種プロパティの表示方法
      各種プロパティを表示するための要素をControlTemplate?クラスに含める。
    • Itemsプロパティの表示方法
      ItemsControl?.Itemsプロパティを表示するItemsPresenter?クラスをControlTemplate?クラスに含める。
  • ItemsControl?のItemsプロパティのデータ表示の外観のカスタマイズ
    ItemsControl?.ItemTemplate?プロパティには、DataTemplate?クラスを設定する。
    • 各種プロパティの表示方法
      各種プロパティを表示するための要素をDataTemplate?クラスに含める。

同じ要領で、コントロールによってはヘッダやセル専用の「テンプレート」プロパティが存在し、「外観」のカスタマイズを行うことができる。

ContentControl?のテンプレート（ControlTemplate?）の例 †

• XAML
  • 以下は、ControlTemplate?とContentPresenter?を使用したContentControl?（Button）コントロールの例である。

    <Grid>
      <Button Margin="5" Width="100" Height="100" Content="ボタン">
        <Button.Template>
          <ControlTemplate TargetType="Button">
            <Grid>
              <Rectangle Fill="Blue"/>
              <Ellipse Fill="Red"/>
              <ContentPresenter
                HorizontalAlignment="Center"
                VerticalAlignment="Center"/>
            </Grid>
          </ControlTemplate>
        </Button.Template>
      </Button>
    </Grid>

  • 上記のContentPresenter?を、「マークアップ拡張」のTemplateBinding?に書き換えた例

    <Grid>
      <Button Margin="5" Width="100" Height="100" Content="ボタン">
        <Button.Template>
          <ControlTemplate TargetType="Button">
            <Grid>
              <Rectangle Fill="Blue"/>
              <Ellipse Fill="Red"/>
              <TextBlock
                Text="{TemplateBinding Content}"
                HorizontalAlignment="Center" VerticalAlignment="Center"/>
            </Grid>
          </ControlTemplate>
        </Button.Template>
      </Button>
    </Grid>

  • 上記のTemplateBinding?を、「マークアップ拡張」のRelativeSource?に書き換えた例。
    なお、RelativeSource?の場合、TargetType?属性を消しても上手く動作する現象を確認できた。

    <Grid>
      <Button Margin="5" Width="100" Height="100" Content="ボタン">
        <Button.Template>
          <ControlTemplate>
            <Grid>
              <Rectangle Fill="Blue"/>
              <Ellipse Fill="Red"/>
              <TextBlock
                Text="{Binding Path=Content, RelativeSource={RelativeSource TemplatedParent}}"
                HorizontalAlignment="Center" VerticalAlignment="Center"/>
            </Grid>
          </ControlTemplate>
        </Button.Template>
      </Button>
    </Grid>

• レンダリング結果
  

• スタイル化
  • 「テンプレート」は、以下のように「スタイル」に組み込むことも可能である。
    • XAML

      <Window.Resources>
        <Style x:Key="buttonTemplate" TargetType="Button">
          <Setter Property="Template">
            <Setter.Value>
              <ControlTemplate TargetType="Button">
                <Grid>
                  <Rectangle Fill="Blue"/>
                  <Ellipse Fill="Red"/>
                  <ContentPresenter
                    HorizontalAlignment="Center"
                    VerticalAlignment="Center"/>
                </Grid>
              </ControlTemplate>
            </Setter.Value>
          </Setter>
        </Style>
      </Window.Resources>
      <StackPanel Orientation="Vertical">
        <Button Margin="5" Width="100" Height="100">ボタン１</Button>
        <Button Margin="5" Width="100" Height="100">ボタン２</Button>
        <Button Margin="5" Width="100" Height="100"
          Style="{StaticResource buttonTemplate}">ボタン３</Button>
      </StackPanel>

    • レンダリング結果
      

• なお、x:Keyを設定しなければ、TargetType?属性により、
  「スタイル」は指定の型（ここではButtonコントロール）、全体に適用される。
  • XAML

    <Window.Resources>
      <Style TargetType="Button">
        <Setter Property="Template">
          <Setter.Value>
            <ControlTemplate TargetType="Button">
              <Grid>
                <Rectangle Fill="Blue"/>
                <Ellipse Fill="Red"/>
                <ContentPresenter
                  HorizontalAlignment="Center"
                  VerticalAlignment="Center"/>
              </Grid>
            </ControlTemplate>
          </Setter.Value>
        </Setter>
      </Style>
    </Window.Resources>
    <StackPanel Orientation="Vertical">
      <Button Margin="5" Width="100" Height="100">ボタン１</Button>
      <Button Margin="5" Width="100" Height="100">ボタン２</Button>
      <Button Margin="5" Width="100" Height="100">ボタン３</Button>
    </StackPanel>

  • レンダリング結果
    

トリガ †

プロパティ トリガ †

データ トリガ †

イベント トリガ †

---

Tags: :.NET開発, :UIサブシステム, :WPF/Silverlight, XAML

     

Site admin: dotNetDevelopmentInfrastructure

PukiWiki 1.4.7 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL.
Based on "PukiWiki" 1.3 by yu-ji. Powered by PHP 5.3.3. HTML convert time: 0.279 sec.