ColHeaderLines プロパティ

列ヘッダー用に表示する行数を返すまたは設定します。

シンタックス

Visual Basic

'宣言
 
Public Property ColHeaderLines As Integer

C#

public int ColHeaderLines {get; set;}

解説

ColHeaderLines プロパティは、列ヘッダー内に表示できるテキストの行数を決定します。このプロパティの値を設定すると、列ヘッダーが実際に複数行を満たすのに十分なテキストを含むことができるかどうかにかかわらず、指定した行数が収まる列ヘッダーの高さが変更されます。このプロパティの最小値は 1 です。

ヘッダー キャプションを自動的に折り返して、その折り返されたヘッダー キャプションが収まるようにヘッダーの高さを変更する場合は、UltraGridOverride.WrapHeaderText を True に設定します。

行レイアウト機能を使用すると、ヘッダーの高さをピクセル単位で制御できます。詳細は UseRowLayout を参照してください。

使用例

Visual Basic

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

  Private Sub Button26_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles button26.Click

      Dim band As UltraGridBand = Me.ultraGrid1.DisplayLayout.Bands(0)

      ' Set a column's and group's headers' captions to a multi-line text.
      band.Columns(0).Header.Caption = "Line 1" & vbCrLf & "Line 2"

      ' Assuming you have added groups to the band, set first group's header's Caption 
      ' to a multiline text.
      band.Groups(0).Header.Caption = "Multiline" & vbCrLf & "Group Header"

      ' To accomodate the multiline captions, set the ColHeaderLines and 
      ' GroupHeaderLines to 2.
      band.ColHeaderLines = 2
      band.GroupHeaderLines = 2

  End Sub

C#

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

private void button26_Click(object sender, System.EventArgs e)
{

	UltraGridBand band = this.ultraGrid1.DisplayLayout.Bands[0];
 	
	// Set a column's and group's headers' captions to a multi-line text.
	band.Columns[0].Header.Caption = "Line 1\nLine 2";
	
	// Assuming you have added groups to the band, set first group's header's Caption 
	// to a multiline text.
	band.Groups[0].Header.Caption = "Multiline\nGroup Header";
 			
	// To accomodate the multiline captions, set the ColHeaderLines and 
	// GroupHeaderLines to 2.
	band.ColHeaderLines = 2;
	band.GroupHeaderLines = 2;

}