HeaderPlacement プロパティ

ヘッダーを表示するかどうか、またどのように表示するかを指定します。

シンタックス

Visual Basic

'宣言
 
Public Property HeaderPlacement As HeaderPlacement

C#

public HeaderPlacement HeaderPlacement {get; set;}

解説

デフォルトでは、UltraGrid はバンドの区切り毎にヘッダーを繰り返します。つまり、前の表示行が異なるバンドに属する場合、その表示行に列ヘッダーが表示されます。たとえば、複数バンド階層で行を展開した場合、同じバンドの兄弟行にもヘッダーが表示されます。このヘッダーの繰り返しは画面領域の浪費につながる場合があります。この機能を使用すると、異なるヘッダー配置スタイルを指定して列ヘッダーの繰り返しを最小限に減らすことができます。

UltraGridLayout.ViewStyle が SingleBand に設定されているか、UltraGridLayout.ViewStyleBand が Horizontal に設定されている場合、このプロパティは効果をもちません。これらの表示スタイルの性質上、ヘッダーは常に繰り返しなしになります (最上部に固定されます)。したがって、これらの表示スタイルが有効な場合、このプロパティは無効になります。デフォルトでは、これらの表示スタイルは有効ではありません。

また、ヘッダー配置は印刷時には有効ですが、Excel へのエクスポート時には有効ではありません。

使用例

Visual Basic

Imports Infragistics.Shared
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinGrid

  Private Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button1.Click
      ' Get the band to hide the headers in.
      Dim band As UltraGridBand = Me.ultraGrid1.DisplayLayout.Bands(0)

      ' You can hide the column headers by setting ColHeadersVisible to false. By
      ' default, column headers are visible.
      band.ColHeadersVisible = False

      ' You can hide the group headers by setting GroupHeadersVisible to false. By
      ' default, group headers are visible.
      band.GroupHeadersVisible = False

      ' You can also show the band header which by default is hidden by setting 
      ' the HeaderVisible property to true.
      band.HeaderVisible = True

      ' You can also set the caption of the band header.
      band.Header.Caption = "Customers Table"

      ' You can also set the apperance of the band header using Appearance property 
      ' off the header.
      band.Header.Appearance.BackColor = Color.DarkBlue
      band.Header.Appearance.ForeColor = Color.LightYellow

      ' You can use the HeaderPlacement property to specify how headers are displayed.
      band.Override.HeaderPlacement = HeaderPlacement.FixedOnTop

  End Sub

C#

using Infragistics.Shared;
using Infragistics.Win;
using Infragistics.Win.UltraWinGrid;
using System.Diagnostics;

private void button1_Click(object sender, System.EventArgs e)
{
	// Get the band to hide the headers in.
	UltraGridBand band = this.ultraGrid1.DisplayLayout.Bands[0];

	// You can hide the column headers by setting ColHeadersVisible to false. By
	// default, column headers are visible.
	band.ColHeadersVisible = false;

	// You can hide the group headers by setting GroupHeadersVisible to false. By
	// default, group headers are visible.
	band.GroupHeadersVisible = false;

	// You can also show the band header which by default is hidden by setting 
	// the HeaderVisible property to true.
	band.HeaderVisible = true;

	// You can also set the caption of the band header.
	band.Header.Caption = "Customers Table";

	// You can also set the apperance of the band header using Appearance property 
	// off the header.
	band.Header.Appearance.BackColor = Color.DarkBlue;
	band.Header.Appearance.ForeColor = Color.LightYellow;

	// You can use the HeaderPlacement property to specify how headers are displayed.
	band.Override.HeaderPlacement = HeaderPlacement.FixedOnTop;
}