バージョン

Layout プロパティ (UltraGridUIElement)

オブジェクトのレイアウトを決定するUltraGridLayoutオブジェクトを返します。このプロパティは実行時には読み取り専用です。
シンタックス
'宣言
 
Public ReadOnly Property Layout As UltraGridLayout
public UltraGridLayout Layout {get;}
解説

オブジェクトのLayoutプロパティは、オブジェクトの外観および動作に関連するさまざまなプロパティの設定を決めるLayoutオブジェクトへのアクセスに使用されます。Layoutオブジェクトを使用すると、グリッドの複数のレイアウトを保守し必要に応じて適用することが容易になります。グリッドのレイアウトはディスク、レジストリ、またはストレージ ストリームに保存して再度利用することもできます。

Layout オブジェクトには Appearance や Override のようなプロパティがあるため、Layout オブジェクトにはこれらのタイプのサブオブジェクトがあり、その設定もレイアウトの一部として含まれます。ただし実際に維持される情報は、これらのプロパティの設定がどのように割り当てられたかによって異なります。プロパティがLayoutオブジェクトの組み込みオブジェクトを使用して設定された場合、そのプロパティの設定はレイアウトの一部に含まれます。しかし、名前付きオブジェクトがコレクションからプロパティに割り当てられた場合、レイアウトにはコレクションへの参照のみが含まれ、名前付きオブジェクトの実際の設定は含まれません。(名前付きオブジェクトと組み込みオブジェクトの違いの概要については、Appearance プロパティをご覧ください。

たとえば、Layout オブジェクトの Appearance プロパティを使用して組み込みの Appearance オブジェクトの値を設定する場合は、次のようになります。

          UltraGrid1.DisplayLayout.Appearance.ForeColor = System.Drawing.Color.Blue
        

この設定 (この場合は ForeColor) はレイアウトの一部に含まれ、他のレイアウト データと共に保存、読み込み、および適用されます。一方、名前付きオブジェクトの設定を次のように UltraGridLayout の Appearance プロパティに適用する場合を考えてみます。

UltraGrid1.Appearances.Add "New1"

UltraGrid1.Appearances("New1").ForeColor = System.Drawing.Color.Blue

UltraGrid1.Layout.Appearance = UltraGrid1.Appearances("New1")

この場合、ForeColor の設定はレイアウトの一部として維持されません。その代わりレイアウトには "New1" Appearance オブジェクトへの参照が含まれ、レイアウトが適用されるときにそのオブジェクト内に存在する設定が使用されることになります。

デフォルトではレイアウトには Appearances コレクション全体のコピーが含まれるため、デフォルト設定を使用してレイアウトが保存および再利用された場合、オブジェクトの参照時にはオブジェクトは常にコレクション内に存在することになります。ただし、Layout オブジェクトの Load メソッドおよび Save メソッドを使用する際、レイアウトが適用されるときにコレクションが再作成されないようにすることも可能です。この場合、存在しないオブジェクトへの参照がレイアウトに含まれていれば、そのオブジェクトのプロパティのデフォルト設定が使用されます。

参照