■ WPF デザイナでの簡単な WPF アプリケーションの作成 ■
此のチュートリアルでは、WPF デザイナで簡単な WPF（Windows Presentation Foundation）アプリ ケーションを作成する方法を示す。 此のチュートリアルでは下記のタスクを行う。 ・プロジェクトを作成する。 ・レイアウトを作成する。 ・レイアウトにコントロールを追加する。 ・レイアウト関連のプロパティを設定する。 ・データソースを作成する。 ・データソースに接続する。 ・コントロールのプロパティをバインドする。 ファイルシステムを検索出来る簡単なアプリケーションを作成する。アプリケーションのユーザーイン ターフェイスは、XAML（Extensible Application Markup Language）で実装する。詳細に付いては、 「WPF XAML」を参照され度い。最終的なアプリケーションを、下図に示す。
■ プロジェクトの作成
最初にアプリケーションのプロジェクトを作成する。 プロジェクトを作成するには
１．Visual Basic 又は Visual C#で FolderExplorer と謂う名前の新しい WPF アプリケーションプロジ ェクトを作成する。
W
① Visual Studio 2012 RC を起動する。
② [ファイル] メニューの [新規作成] をポイントし、[プロジェクト] をクリックする。 [新しいプロジェクト] ダイアログボックスが表示される。
③ [インストールされたテンプレート] ペインで、Visual Basic 又は Visual C#を展開し、 [Windows] を選択する。 ④ 中央のペインの上で、ドロップダウンリストからターゲットフレームワークを選択する。 ⑤ 中央のペインで、[WPF アプリケーション] テンプレートをクリックする。 ⑥ [名前] ボックスにプロジェクトの名前を指定する。 ⑦ [場所] ボックスに、プロジェクトを保存するフォルダーを指定する。 ⑧ [OK] をクリックする。
WPF Designer for Visual Studio が開き、プロジェクトの MainWindow が表示される。 ２．デザインビューでウィンドウを選択する。
WPF Designer for Visual Studio では、マウスジェスチャやキーボードショートカットを使用して、 要素を選択したり移動したり出来る。要素を選択する方法は複数有る。例えば、Tab キーを使って コントロール間を移動する、カーソルを XAML ビューのコントロールタグ上に置く、デザイナー の下部に有るタグナビゲーターを使用する、[ドキュメントアウトライン] ウィンドウを使用する、
等の方法で個々のコントロールを選択出来る。選択されて居るコントロールの位置は、マウス又は 矢印キーで調整出来る。 デザイン画面上で要素を選択するには ・デザインビューでデザイン画面にフォーカスが有る状態で、目的の要素が選択される迄Tab キー を押す。 Shift キーを押し乍 Tab キーを押すと、逆方向に進む。 ・XAML ビューで、カーソルを要素の開始タグ、又は、終了タグの上へ移動する。 ・要素がタグナビゲーターに表示されて居れば、其れをクリックする。 ・[ドキュメントアウトライン] ウィンドウで要素をクリックする。 ・デザイナー内で現在選択されて居る要素の親を選択するには、Esc キーを押す。 ・操作の精度を上げるには、領域を拡大してクリック可能な領域を追加する。 デザイン画面上で複数のコントロールを選択するには ・デザインビューで、目的の総てのコントロールが囲まれる様にマウスをドラッグして四角形の選 択範囲を作成する。 ・デザインビューで、Ctrl キー又は Shift キーを押し乍、目的のコントロールを 1 個宛クリックす る。キーボード丈を使ってデザイン画面上の複数のコントロールを選択する方法は無い。 ・[ドキュメントアウトライン] ウィンドウで、Ctrl キーを押し乍、目的のコントロールをクリック する。Ctrl キーを押し乍 Space キーを押して、複数のコントロールを選択する事も出来る。Esc キーを押すと、複数の選択項目が1 個の選択項目に縮小される。 選択されて居るコントロールをデザイナー内で移動するには ・マウスの左ボタンを押した儘、選択されて居るコントロールを目的の位置迄ドラッグする。 ・選択されて居るコントロールがGrid、DockPanel、StackPanel 等のパネルの場合は、左上に表 示される移動ハンドルを使用してパネルを移動する。 ・矢印キーを押して、選択されて居るコントロールの位置を調整する。 ・移動ではなく切り取りと貼り付けが必要な場合も有る。
３．[プロパティ] ウィンドウで、Title プロパティの値を Folder Explorer に設定する。 ■ レイアウトの作成
レイアウトは、アプリケーションのメインウィンドウでのコントロールの配置を定義する。此処では、 アプリケーションのコントロールが含まれるレイアウト要素を作成する方法を示す。
レイアウトを作成するには １．ウィンドウ上のルートGrid コントロールを選択する。 ２．グリッドに2 個目の行を追加する。詳細に付いては、「方法 : グリッドに行と列を追加する」（ドキ ュメント内）を参照され度い。 ３．グリッドに2 個目の列を追加する。 ■ レイアウトへのコントロールの追加 レイアウトを定義すれば、此処にコントロールを配置出来る。 レイアウトにコントロールを追加するには １．[ツールボックス] から、TreeView コントロールをグリッドの最初のセルにドラッグする。 ２．[ツールボックス] から、ListView コントロールを、グリッドの最初の行と 2 個目の列を占めるセ ルにドラッグする。 ３．[ツールボックス] から、ListView コントロールを、グリッドの 2 個目の行と 2 個目の列を占める セルにドラッグする。 ■ レイアウト関連のプロパティの設定 此処では、コントロールのレイアウト関連のプロパティを設定する方法を示す。各コントロールのプロ パティを設定すれば、レイアウトは最終的なアプリケーションの図と粗同じに成る。 レイアウト関連のプロパティを設定するには １．TreeView コントロールを選択する。 ２．以下に示す様に、[プロパティ] ウィンドウで、次のプロパティを設定する。 プロパティ 値 Grid.ColumnSpan 1 Grid.RowSpan 2 Height Auto HorizontalAlignment Stretch Margin 0,0,0,0 VerticalAlignment Stretch Width Auto TreeView コントロールは、最初のグリッド列に収まり、2 つのグリッド行を占めるサイズに成る。 ３．両方の ListView コントロールを選択する。 ４．以下に示す様に、[プロパティ] ウィンドウで、次のプロパティを設定する。
プロパティ 値 Grid.ColumnSpan 1 Grid.RowSpan 1 Height Auto HorizontalAlignment Stretch Margin 0,0,0,0 VerticalAlignment Stretch Width Auto ListView コントロールは、各グリッドセルに収まるサイズに成る。 ５．[ドキュメントアウトライン] ウィンドウを開く。 [ドキュメントアウトライン] ウィンドウは、XAML ドキュメントを階層形式で参照する場合に役 立つ。[ドキュメントアウトライン] ウィンドウでは、XAML 要素のプレビューや削除を行う事が 出来る。 ドキュメントアウトラインウィンドウを開くには、[表示] メニューの [其の他のウィンドウ] をポ イントし、[ドキュメントアウトライン] をクリックする（ショートカットキーの Ctrl + Alt + T で も可能）。 ６．グリッドの ColumnDefinitions ノードを展開する。 ７．最初のColumnDefinition 項目を選択する。
８．[プロパティ] ウィンドウで、Width プロパティを * に設定する。 ９．[ドキュメントアウトライン] ウィンドウで、2 番目の ColumnDefinition を選択する。 Ａ．[プロパティ] ウィンドウで、Width プロパティを 2* に設定する。 列のサイズが変更され、1 番目の列はウィンドウ幅の 3 分の 1、2 番目の列はウィンドウ幅の 3 分 の2 を占める様に成る。 Ｂ．[ドキュメントアウトライン] ウィンドウで、グリッドの RowDefinitions ノードを展開する。 Ｃ．最初のRowDefinition 項目を選択する。 Ｄ．[プロパティ] ウィンドウで、Height プロパティを * に設定する。 Ｅ．[ドキュメントアウトライン] ウィンドウで、2 番目の RowDefinition を選択する。 Ｆ．[プロパティ] ウィンドウで、Height プロパティを * に設定する。 行のサイズが変更され、各行がウィンドウの高さの半分を占める様に成る。 Ｇ．ソリューションをビルドして実行する。 Ｈ．ウィンドウのサイズを変更して、TreeView コントロール及び ListView コントロールのサイズが動 的に変わる事を確認する。 ■ データソースの作成 FolderExplorer アプリケーションのデータソースは Folder と謂う名前のクラスで有る。此のクラスは、 シンプルなモデルのファイルシステムを提供する。各Folder インスタンスが SubFolders コレクション とFiles コレクションを持つ。 データソースを作成するには １．Folder と謂う名前の新しいクラスを FolderExplorer プロジェクトに追加する。 プロジェクトに追加出来るファイルの種類は、プロジェクトの作成に使用されたプロジェクトテン
プレート及びプロジェクトが対象とする.NET Framework のバージョンに依り決まる。例えば、 Visual Basic プロジェクトテンプレートを使用して作成したプロジェクトには、新しい.vb ファイ ルを追加出来るが、Visual C++プロジェクトテンプレートを使用して作成したプロジェクトには、 新しい.vb ファイルは追加出来ない。亦、.NET Framework の新しいバージョン用に設計された項 目テンプレートは、以前のバージョンを対象とするプロジェクト用のテンプレートの一覧には表示 されない。 １．ソリューションエクスプローラーで、項目を追加するプロジェクトを選択する。 ２．[プロジェクト] メニューの [新しい項目の追加] をクリックする。 ３．[カテゴリ] ペインで、カテゴリを選択する。 ４．[テンプレート] ペインで項目テンプレートを選択する（此処では、クラス）。 ５．[開く] をクリックする（Folder と謂う名前を付ける）。 ２．此の Folder ソースコードファイルの内容を、次のコードに置き換える。 Visual Basic Imports System Imports System.IO Imports System.Linq Imports System.Collections.Generic Imports System.Collections.ObjectModel Imports System.Text
Public Class Folder
Private _folder As DirectoryInfo
Private _subFolders As ObservableCollection(Of Folder) Private _files As ObservableCollection(Of FileInfo)
Public Sub New() Me.FullPath = "c:¥" End Sub 'New
Public ReadOnly Property Name() As String Get
Return Me._folder.Name End Get
End Property
Public Property FullPath() As String Get
Return Me._folder.FullName End Get
Set
If Directory.Exists(value) Then
Else
Throw New ArgumentException("must exist", "fullPath") End If
End Set End Property
ReadOnly Property Files() As ObservableCollection(Of FileInfo) Get
If Me._files Is Nothing Then
Me._files = New ObservableCollection(Of FileInfo) Dim fi As FileInfo() = Me._folder.GetFiles()
Dim i As Integer For i = 0 To fi.Length - 1 Me._files.Add(fi(i)) Next i End If Return Me._files End Get End Property
ReadOnly Property SubFolders() As ObservableCollection(Of Folder) Get
If Me._subFolders Is Nothing Then Try
Me._subFolders = New ObservableCollection(Of Folder) Dim di As DirectoryInfo() = Me._folder.GetDirectories() Dim i As Integer
For i = 0 To di.Length - 1
Dim newFolder As New Folder() newFolder.FullPath = di(i).FullName Me._subFolders.Add(newFolder) Next i Catch ex As Exception System.Diagnostics.Trace.WriteLine(ex.Message) End Try End If Return Me._subFolders End Get End Property End Class Visual C# using System; using System.IO; using System.Linq; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Text;
namespace FolderExplorer {
public class Folder {
private DirectoryInfo _folder;
private ObservableCollection<Folder> _subFolders; private ObservableCollection<FileInfo> _files; public Folder() { this.FullPath = @"c:¥"; }
public string Name { get { return this._folder.Name; } }
public string FullPath { get { return this._folder.FullName; } set { if (Directory.Exists(value)) {
this._folder = new DirectoryInfo(value); }
else {
throw new ArgumentException("must exist", "fullPath"); }
} }
public ObservableCollection<FileInfo> Files {
get {
if (this._files == null) {
this._files = new ObservableCollection<FileInfo>(); FileInfo[] fi = this._folder.GetFiles();
for (int i = 0; i < fi.Length; i++) { this._files.Add(fi[i]); } } return this._files; } }
public ObservableCollection<Folder> SubFolders {
get {
if (this._subFolders == null) {
this._subFolders = new ObservableCollection<Folder>(); DirectoryInfo[] di = this._folder.GetDirectories();
for (int i = 0; i < di.Length; i++) {
Folder newFolder = new Folder(); newFolder.FullPath = di[i].FullName; this._subFolders.Add(newFolder); } } return this._subFolders; } } } } ※ コードの入力が終われば、アセンブリを生成する為に、ビルドして置く。 ■ データソースへの接続 WPF コ ン ト ロ ー ル は 、 デ ー タ バ イ ン デ ィ ン グ に 依 り デ ー タ ソ ー ス と 接 続 す る 。 此 処 で は 、 ObjectDataProvider を宣言し、バインドする方法を示す。 データソースに接続するには １．WPF デザイナで MainWindow.xaml を開く。
２．XAML ビューで、別の xmlns 割り当てに依り、次の XAML を <Window> タグに挿入する。詳細 に付いては、「方法 : 名前空間を XAML にインポートする」を参照され度い。
xmlns:my="clr-namespace:FolderExplorer"
XAML <Window.Resources> <ObjectDataProvider x:Key="RootFolderDataProvider" > <ObjectDataProvider.ObjectInstance> <my:Folder FullPath="c:¥"/> </ObjectDataProvider.ObjectInstance> </ObjectDataProvider> <HierarchicalDataTemplate
DataType = "{x:Type my:Folder}"
ItemsSource = "{Binding Path=SubFolders}"> <TextBlock Text="{Binding Path=Name}" /> </HierarchicalDataTemplate>
</Window.Resources>
４．<TreeView> タグを次の XAML に置き換える。
XAML
<TreeView Grid.ColumnSpan="1" Grid.RowSpan="2" Margin="0,0,0,0" Name="treeView1" > <TreeViewItem ItemsSource="{Binding Path=SubFolders,
Source={StaticResource RootFolderDataProvider}}" Header="Folders" /> </TreeView>
■ コントロールのプロパティのバインディング
コントロールのプロパティを別のコントロールにバインドして、自動プロパティ更新を有効にする。 コントロールのプロパティをバインドするには
１．XAML ビューで、両方の <ListView> タグを次の XAML に置き換える。
XAML <ListView Name="listView1" ItemsSource="{Binding Path=SelectedItem.SubFolders, ElementName=treeView1, Mode=OneWay}" Grid.Column="1" Grid.RowSpan="1" /> <ListView Name="listView2" ItemsSource="{Binding Path=SelectedItem.Files, ElementName=treeView1, Mode=OneWay}" Grid.Column="1" Grid.Row="1" /> ２．ソリューションをビルドして実行する。
３．フォルダーアイテムを展開し、C: ドライブのフォルダーを表示する。 ４．サブフォルダーをクリックし、2 個の ListView コントロールの内容を確認して観て欲しい。 サブフォルダーは、上のListView コントロールに表示され、ファイルは、下の ListView コントロール に表示される。 http://msdn.microsoft.com/ja-jp/library/bb546972(v=vs.110).aspx http://msdn.microsoft.com/ja-jp/library/ee649089(v=vs.110).aspx
■ 方法：グリッドに行と列を追加する ■
Windows Presentation Foundation（WPF）の Grid コントロールでは、グリッドベースのレイアウト を作成する事に依り、コントロールの位置を素早く簡単に決定したり調整したり出来る。デザイン時に、 WPF Designer で Grid コントロールに行と列を追加出来る。既定では、新しい行と列は Star サイズ変 更を使用する。 ※ 行や列にコンテンツを追加する前に行や行のサイズを Auto に設定すると、此の行や列はデザイナー に表示されない。此の為、正しい行や列にコントロールを配置する事が難しく成る。此れ以降、此 の様な動作を回避するには、作業中はスターサイズ変更を使用し、作業の終了時にAuto に変更する。 此処では、Grid に行と列を追加する 3 つの方法を示す。グリッドから行と列を削除する事も出来る。 詳細に付いては、「方法 : グリッドから行と列を削除する」（ドキュメント内）を参照され度い。 ■ デザイナーの使用 WPF Designer で Grid コントロールを選択すると、レールが上側と左側に表示される。此のレールを 使用して、Grid に直接行と列を追加出来る。XAML ビューは、新しい行と列で自動的に更新される。 ※ FlowDirection プロパティが RightToLeft に設定されて居る場合、行のレールは Grid の右側に表示
される。 デザイナーを使用してグリッドに行を追加するには １．WPF Designer で、Grid コントロールを選択する。 ２．サイドレールの外側の縁の上にポインターを置く。ポインターが十字カーソルに変わり、行が追加 される位置を示すグリッド線が表示される。 ３．レールをクリックして行を設定する。 グリッド線が其の場所に固定され、グリッド線インジケーターがグリッド線の端のレール上に表示 される。 ※ グリッド内のグリッド線、又は、レール内のグリッド線インジケーターをドラッグする事に依 り、行のサイズを調整出来る。 ４．(省略可能) 追加する行が複数有る場合は、手順 2 と手順 3 を繰り返す。 デザイナーを使用してグリッドに列を追加するには １．WPF Designer で、Grid コントロールを選択する。 ２．上部レールの上端の上にポインターを置く。ポインターが十字カーソルに変わり、列が追加される 位置を示すグリッド線が表示される。 ３．レールをクリックして、列を設定する。
グリッド線が其の場所に固定され、グリッド線インジケーターがグリッド線の端のレール上に表示 される。 ※ グリッド内のグリッド線、又は、レール内のグリッド線インジケーターをドラッグする事に依 り、列のサイズを調整出来る。 ４．(省略可能) 追加する列が複数有る場合は、手順 2 と手順 3 を繰り返す。 ■ コレクションエディターの使用 コレクションエディターを使用して、Grid に行と列を追加する事も出来る。コレクションエディターを 使用して行と列を構成すると、デザインビューとXAML ビューが自動的に更新される。 コレクションエディターを使用してグリッドに行を追加するには １．WPF Designer で、Grid コントロールを選択する。 ２．[プロパティ] ウィンドウで RowDefinitions プロパティを見付け、プロパティの値列の省略記号ボ タンをクリックする。 [コレクションエディター] ダイアログボックスが表示される。 ３．[追加] をクリックし、新しい行を追加する。 ４．(省略可能) 行のプロパティを設定する。 ５．(省略可能) 追加する行が複数有る場合は、手順 3 と手順 4 を繰り返す。 ６．[OK] をクリックして [コレクションエディター] を閉じ、WPF Designer に戻る。 コレクションエディターを使用してグリッドに列を追加するには １．WPF Designer で、Grid コントロールを選択する。 ２．[プロパティ] ウィンドウで ColumnDefinitions プロパティを見付け、プロパティの値列の省略記 号ボタンをクリックする。 [コレクションエディター] ダイアログボックスが表示される。 ３．[追加] をクリックし、新しい列を追加する。 ４．(省略可能) 列のプロパティを設定する。 ５．(省略可能) 追加する列が複数有る場合は、手順 3 と手順 4 を繰り返す。 ６．[OK] をクリックして [コレクションエディター] を閉じ、WPF Designer に戻る。
■ XAML エディターの使用 XAML に直接入力する事に依り、Grid に行と列を追加する事も出来る。デザインビューは、新しい行 と列で自動的に更新される。 XAML エディターを使用してグリッドに行を追加するには １．XAML エディターで、Grid 要素を見付ける。 ２．Grid 要素の子として Grid.RowDefinitions 要素を追加する。コードは、次の様に成る。 XAML <Grid> <Grid.RowDefinitions> </Grid.RowDefinitions> </Grid> ３．RowDefinition 要素を追加する。例を次に示す。 XAML <Grid.RowDefinitions> <RowDefinition Height="100" /> <RowDefinition Height="Auto" /> <RowDefinition Height="*" /> <RowDefinition Height="5*" /> </Grid.RowDefinitions> XAML エディターを使用してグリッドに列を追加するには １．XAML エディターで、Grid 要素を見付ける。 ２．Grid 要素の子として Grid.ColumnDefinitions 要素を追加する。コードは、次の様に成る。 XAML <Grid> <Grid.ColumnDefinitions> </Grid.ColumnDefinitions> </Grid> ３．ColumnDefinition 要素を追加する。例を次に示す。 XAML <Grid.ColumnDefinitions> <ColumnDefinition Width="100" /> <ColumnDefinition Width="Auto" /> <ColumnDefinition Width="*" /> <ColumnDefinition Width="5*" /> </Grid.ColumnDefinitions>
■ 方法：グリッドから行と列を削除する ■
Windows Presentation Foundation（WPF）の Grid コントロールでは、グリッドベースのレイアウト を作成する事に依り、コントロールの位置を簡単に決定したり調整したり出来る。デザイン時に、WPF Designer for Visual Studio で Grid コントロールから行と列を削除出来る。
行や列を削除すると、其の行や列に合ったコントロールを再配置する必要が有る。其れには、影響を受 けるコントロールのGrid.Row プロパティや Grid.Column プロパティを変更する。 此処では、Grid から行と列を削除する 3 つの方法に付いて説明する。グリッドに行と列を追加する方 法の詳細に付いては、「方法 : グリッドに行と列を追加する」（前述）を参照され度い。 ■ デザイナーの使用 デザインビューでは、Grid コントロールから既存の行や列を削除出来る。 デザイナーを使用してグリッドから行と列を削除するには １．WPF Designer で、少なく共 2 つの列や 2 つの行を持つ Grid コントロールを選択する。 ２．グリッドレールのグリッド線インジケーター上にポインターを移動する。 グリッド線インジケーターがオレンジ色に変わり、マウスポインターが変わって再配置を示す。 ３．グリッド線インジケーターをグリッドの外にドラッグする。 クリックすると、グリッド線とグリッド線インジケーターが赤色に変わる。グリッドの外にドラッ グすると、マウスポインターが変わって、削除を示す [X] が表示される。 ４．マウスのボタンを離す。 グリッド線と、其れに対応する行や列が削除される。残りの行と列のプロパティは、適切に更新さ れる。 ■ コレクションエディターの使用 コレクションエディターを使用して Grid から行と列を削除出来る。コレクションエディターを使用し て行と列を構成すると、デザインビューと XAML ビューが自動的に更新される。 コレクションエディターを使用してグリッドから行を削除するには １．WPF Designer で、Grid コントロールを選択する。 ２．[プロパティ] ウィンドウで RowDefinitions プロパティを見付け、プロパティの値列の省略記号ボ タンをクリックする。 [コレクションエディター] ダイアログボックスが表示される。
３．左側のペインで、削除するRowDefinition をクリックする。 ４．[項目を削除する] をクリックし、行を削除する。 ５．(省略可能) 削除する行が複数有る場合は、手順 3 と手順 4 を繰り返す。 ６．[OK] をクリックして [コレクションエディター] を閉じ、WPF Designer に戻る。 コレクションエディターを使用してグリッドから列を削除するには １．WPF Designer で、Grid コントロールを選択する。 ２．[プロパティ] ウィンドウで ColumnDefinitions プロパティを見付け、プロパティの値列の省略記 号ボタンをクリックする。 [コレクションエディター] ダイアログボックスが表示される。 ３．左側のペインで、削除するColumnDefinition をクリックする。 ４．[項目を削除する] をクリックし、列を削除する。 ５．(省略可能) 削除する列が複数有る場合は、手順 3 と手順 4 を繰り返す。 ６．[OK] をクリックして [コレクションエディター] を閉じ、WPF Designer に戻る。 ■ XAML エディターの使用 XAML エディターで行や列を削除する事に依り、手動で Grid から行と列を削除する事も出来る。デザ インビューは自動的に更新される。 XAML エディターを使用してグリッドから行と列を削除するには １．XAML エディターで、行と列が含まれる Grid 要素を見付ける。例を次に示す。 XAML <Grid> <Grid.RowDefinitions> <RowDefinition Height="100" /> <RowDefinition Height="Auto" /> <RowDefinition Height="*" /> <RowDefinition Height="5*" /> </Grid.RowDefinitions> <Grid.ColumnDefinitions> <ColumnDefinition Width="100" /> <ColumnDefinition Width="Auto" /> <ColumnDefinition Width="*" /> <ColumnDefinition Width="5*" /> </Grid.ColumnDefinitions> </Grid> ２．不要になった行と列を削除する。
FrameworkElement.Width（Height）プロパティ （WPF）
要素の幅（高さ）の値（Double の値）を取得・設定する。 Double 0.0 以上の Double 型の値の文字列表現。
此の値は、device-independent unit (1/96th inch) 単位として解釈される。 文字列には、小数点を明示的に含める必要は無い（1.0 は 1 と表記しても良い）。 qualifiedDouble 上記の double 型の値に、単位宣言文字列 px、in、cm、pt の孰れかを後に続け
た物。
px（既定値）は device-independent units (1/96th inch per unit) で有る。 in はインチで有る（1in=96px）。
cm はセンチメートルで有る（1 cm=(96/2.54) px）。 pt はポイントで有る（1pt=(96/72) px）。
Auto 自動サイズ変更を有効にする。
此のプロパティは、幅情報（高さ情報）を指定するFrameworkElement の 3 つの書き込み可能なプロ パティの内の1 つで有る。他の 2 つは、MinWidth と MaxWidth（MinHeight と MaxHeight）で有る。 此等の値の間に競合が発生した場合は、先ずMinWidth（MinHeight）、次に MaxWidth（MaxHeight） を適用し、此の2 つが範囲内に有る時は、最後に Width（Height）を適用して実際の幅を決定する。 此のプロパティの戻り値は、常に設定値と同じで有る。此れに対し、ActualWidth（ActualHeight）の 値は異なる場合が有る。先ず、何等かの理由で推奨サイズがレイアウトに依って拒否される場合が有る。 亦、レイアウトシステム其の物が、プロパティシステムに依るWidth（Height）の設定に対して非同期 で動作する為、特定のサイズ設定プロパティの変更が未だ処理されて居ない場合も有る。 Height プロパティは、此の要素が他の要素内の子要素で有る場合は、値を設定しても、実際には推奨 値にしか成らない。其の値は、レイアウトシステムや親要素の特定のレイアウトロジックに依って、強 制力の無い入力としてレイアウトプロセスで使用される。実際問題として、FrameworkElement は殆 ど常に他の要素の子要素に成って居る。此れは、Window で Height を設定する場合でも同じで有る （Window 場合、其の値は、基に成るアプリケーションモデルで、アプリケーションをホストする Hwnd を作成する基本的な描画の前提が確立される時に使用される）。 Double 型の値を受け入れる事が出来る丈で無く、此のプロパティは Double.NaN にする事も出来る。 コードで自動サイズ変更動作を指定する場合に此の値を使用する。XAML では、値を文字列 "Auto"（大 文字/小文字の区別無し）に設定して自動サイズ変更動作を有効にする。自動サイズ変更動作では、要素 の幅（高さ）は、利用可能な最大の幅（高さ）に成る。但し、特定のコントロールで既定のテーマスタ イルに依って既定値が指定される場合も多く、其の場合は自動サイズ変更動作は（改めて有効にしない 限り）無効に成る。 Double 型の値に対する値の制約は、ValidateValueCallback 機構に依って適用される。無効な値を設 定しようとすると、実行時例外がスローされる。 検証チェックに加えて、レイアウトシステムに依って適用されるWidth（Height）には非決定性の上限 値が有る（此れは、Single.MaxValue より大きいが Double.MaxValue より小さい、非常に大きな値で 有る）。此の上限値を超えると、要素は描画されず、例外もスローされない。表示可能な最大サイズを 大きく超える値をWidth（Height）に設定しては成らない。此の非決定性の上限値を超える可能性が有 る。
FrameworkElement.HorizontalAlignment プロパティ （WPF） 此の要素が親要素（パネルコントロールや項目コントロール等）の一部と成る場合に適用される水平方 向の配置の特性を取得・設定する。 HorizontalAlignment 列挙体 メンバー名 説明 Left 親要素のレイアウトスロットの左側に配置される様に指定する。 Center 親要素のレイアウトスロットの中央に配置される様に指定する。 Right 親要素のレイアウトスロットの右側に配置される様に指定する。 Stretch 親要素のレイアウトスロット全体に引き伸ばして配置される様に指定する。 要素のHeight プロパティと Width プロパティを明示的に設定すると、レイアウト時に此等の測定値が 優先されて、HorizontalAlignment を Stretch に設定した場合の通常の効果が取り消される。 HorizontalAlignment は、サブクラス化された要素（特に、コントロール）内で異なる値に設定される 事が良く有る。此れは、一般に、既定値を設定する為の異なるメタデータを持つ場合、又は、此の依存 関係プロパティ値を異なる値に設定する既定のスタイルが適用されて居る場合に発生する。例えば、 Label は FrameworkElement から直接 HorizontalAlignment を継承するが、Label コントロールの HorizontalAlignment の見掛け上の既定値は Left で有る。此れは、スタイルのコントロールテンプレ ート内で、此の値がLabel の既定のスタイルの範囲にリセットされた為で有る。
Canvas は絶対配置に基づいて居る為、レイアウトを構成する際に HorizontalAlignment を使用しない。 亦、Label は、Label や其の派生クラスに依って継承されると、此の依存関係プロパティの既定値を Left に再定義する。 FrameworkElement.VerticalAlignment プロパティ （WPF） 此の要素が親要素（パネルコントロールや項目コントロール等）の一部と成る場合に適用される水平方 向（垂直方向）の配置の特性を取得・設定する。 VerticalAlignment 列挙体 メンバー名 説明 Top 子要素を、親のレイアウトスロットの上端に揃えて配置する様に指定する。 Center 子要素を、親のレイアウトスロットの中央に揃えて配置する様に指定する。 Bottom 子要素を、親のレイアウトスロットの下端に揃えて配置する様に指定する。 Stretch 子要素を、親のレイアウトスロット全体に引き伸ばす様に指定する。 要素のHeight プロパティと Width プロパティを明示的に設定すると、レイアウト時に此等の測定値が 優先されて、此のプロパティをStretch に設定した場合の通常の効果が取り消される。 VerticalAlignment は、サブクラス化された要素（特に、コントロール）内で異なる値に設定される事 が良く有る。此れは、一般に、既定値を設定する為の異なるメタデータを持つ場合、又は、此の依存関 係プロパティ値を異なる値に設定する既定のスタイルが適用されて居る場合に発生する。例えば、 ComboBoxItem は FrameworkElement から直接 VerticalAlignment を継承するが、ComboBoxItem コントロールのVerticalAlignment の見掛け上の既定値は Center で有る。此れは、スタイルのコント ロールテンプレート内で、此の値が ComboBoxItem の既定のスタイルの範囲にリセットされた為で有 る。 Canvas は絶対配置に基づいて居る為、レイアウトを構成する際に VerticalAlignment を使用しない。 亦、ComboBoxItem は、ComboBoxItem や其の派生クラスに依って継承されると、此のプロパティの 既定値をCenter に再定義する。
FrameworkElement.Margin プロパティ （WPF） 要素の外側の余白を取得・設定する。 此の余白は、此の要素と、レイアウトでユーザーインターフェイス（UI）が作成される時に隣接する他 の要素との間の領域で有る。共有要素はピア要素（共通の親コントロールのコレクションに含まれる他 の要素等）の場合も有れば、此の要素の親の場合も有る。 Margin は、余白を非対称に設定出来る様に、数値ではなく Thickness 構造体として設定される。 Thickness 構造体自体が文字列の型変換をサポートして居る為、XAML 属性構文でも非対称の Margin を指定出来る。 ゼロ以外の余白は、要素レイアウトのActualWidth と ActualHeight の外側の領域に適用される。 余白はレイアウトの兄弟要素の間で加算される。例えば、隣接する2 つの要素の隣接部の余白が孰れも 30 に設定されて居た場合、其の要素間の領域は 60 単位に成る。 通常、余白が設定されて居る要素では、割り当てられた四角形の領域が其の要素（余白+コンテンツ） に対して小さ過ぎる場合でも、指定されて居るMargin のサイズは制限されない。代わりに要素のコン テンツの領域が、レイアウトの計算時に制限される。コンテンツの制限が0 に達しない限り、余白が制 限される事は無い。 Grid.RowSpan 添付プロパティ （WPF） Grid 内で子コンテンツが幾つの行に跨って表示されるかを示す値を取得・設定する。 Grid 内の行は、RowDefinition 要素を使用して定義される。 プロパティ値の型は、System.Int32 で、既定値は 1 で有る。 Grid.ColumnSpan 添付プロパティ （WPF） Grid 内で子コンテンツが幾つの列に跨って表示されるかを示す値を取得・設定する。 プロパティ値の型は、System.Int32 で、既定値は 1 で有る。 Grid 内の列は、ColumnDefinition 要素を使用して定義される。
ObservableCollection(Of T) クラス （.NET Framework）
項目が追加、削除された時、又は、リスト全体が更新された時に通知を提供する動的なデータコレクシ ョンを表す（System.Collections.ObjectModel 名前空間）。
項目が追加、削除、変更、移動された場合、又は、リスト全体が更新された時に、CollectionChanged イベントが発生し、亦、プロパティ値が変更された時に、PropertyChanged イベントが発生する。
