AlternatingRowsDefaultCellStyle プロパティ (GcMultiRow)

コントロールの交互行で使用される既定のセルスタイルを取得または設定します。台帳のような効果を作成する場合に使用します。

構文

Visual Basic (宣言)
C#

Public Property AlternatingRowsDefaultCellStyle As CellStyle

public CellStyle AlternatingRowsDefaultCellStyle {get; set;}

プロパティ値

コントロールの交互行で使用される既定のセルスタイルを表すCellStyle。台帳のような効果を作成する場合に使用します。

解説

奇数のインデックス番号を持つ行のセルでは、AlternatingRowsDefaultCellStyleプロパティで指定されたスタイルによって、DefaultCellStyleおよびRowsDefaultCellStyleで指定されたスタイルがオーバーライドされます。この既定の交互行スタイルは、Section.DefaultCellStyleプロパティおよびCell.Styleプロパティで指定されたスタイルによってオーバーライドされます。

このプロパティを取得するとき、プロパティにまだ一度もアクセスされていなければ、既定値を含むCellStyleが作成されます。そのため、多数の行についてこのプロパティを取得すると、パフォーマンスに影響が生じる場合があります。可能であれば、1つのCellStyleを使用して、複数の行のこのプロパティを設定してください。

使用例

次のサンプルコードは、このプロパティを使用してセルの外観をカスタマイズする方法を示します。このサンプルコードは、CellStyleクラスに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

void Form1_Load(object sender, EventArgs e)
{
    // All cell's will use default cell style.
    gcMultiRow1.RowsDefaultCellStyle.BackColor = Color.Black;
    gcMultiRow1.RowsDefaultCellStyle.ForeColor = Color.White;
    gcMultiRow1.RowsDefaultCellStyle.SelectionBackColor = Color.FromArgb(100, SystemColors.Highlight);
    gcMultiRow1.RowsDefaultCellStyle.TextAlign = MultiRowContentAlignment.MiddleRight;

    // The cell's in alternating Rows
    gcMultiRow1.AlternatingRowsDefaultCellStyle.GradientColors = new Color[] { Color.FromArgb(25, 25, 25), Color.FromArgb(75, 75, 75) };
    gcMultiRow1.AlternatingRowsDefaultCellStyle.GradientDirection = GradientDirection.Backward;
    gcMultiRow1.AlternatingRowsDefaultCellStyle.GradientStyle = GradientStyle.Horizontal;

    // Row header cells
    gcMultiRow1.RowsDefaultHeaderCellStyle.BackColor = Color.FromArgb(75, 75, 75);
    gcMultiRow1.RowsDefaultHeaderCellStyle.ForeColor = Color.White;

    // column header cells.
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.BackColor = Color.FromArgb(75, 75, 75);
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.ForeColor = Color.FromArgb(200, 200, 200);
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.TextAlign = MultiRowContentAlignment.MiddleCenter;
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.UseCompatibleTextRendering = MultiRowTriState.True;
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.TextEffect = TextEffect.SunkenLite;

    // All cells is specific row.
    gcMultiRow1.Rows[0].DefaultCellStyle.PatternColor = Color.Gray;
    gcMultiRow1.Rows[0].DefaultCellStyle.PatternStyle = MultiRowHatchStyle.BackwardDiagonal;
    gcMultiRow1.Rows[0].DefaultCellStyle.Font = new Font(Control.DefaultFont, FontStyle.Underline);

    // Change single cell
    gcMultiRow1[0, 0].Style.UseCompatibleTextRendering = MultiRowTriState.True;
    gcMultiRow1[0, 0].Style.TextAngle = 30;
    gcMultiRow1[0, 0].Style.Format = "#0.00%";
}

Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
    ' All cell's will use default cell style.
    gcMultiRow1.RowsDefaultCellStyle.BackColor = Color.Black
    gcMultiRow1.RowsDefaultCellStyle.ForeColor = Color.White
    gcMultiRow1.RowsDefaultCellStyle.SelectionBackColor = Color.FromArgb(100, SystemColors.Highlight)
    gcMultiRow1.RowsDefaultCellStyle.TextAlign = MultiRowContentAlignment.MiddleRight

    ' The cell's in alternating Rows
    gcMultiRow1.AlternatingRowsDefaultCellStyle.GradientColors = New Color() {Color.FromArgb(25, 25, 25), Color.FromArgb(75, 75, 75)}
    gcMultiRow1.AlternatingRowsDefaultCellStyle.GradientDirection = GradientDirection.Backward
    gcMultiRow1.AlternatingRowsDefaultCellStyle.GradientStyle = GradientStyle.Horizontal

    ' Row header cells
    gcMultiRow1.RowsDefaultHeaderCellStyle.BackColor = Color.FromArgb(75, 75, 75)
    gcMultiRow1.RowsDefaultHeaderCellStyle.ForeColor = Color.White

    ' column header cells.
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.BackColor = Color.FromArgb(75, 75, 75)
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.ForeColor = Color.FromArgb(200, 200, 200)
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.TextAlign = MultiRowContentAlignment.MiddleCenter
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.UseCompatibleTextRendering = MultiRowTriState.True
    gcMultiRow1.ColumnHeadersDefaultHeaderCellStyle.TextEffect = TextEffect.SunkenLite

    ' All cells is specific row.
    gcMultiRow1.Rows(0).DefaultCellStyle.PatternColor = Color.Gray
    gcMultiRow1.Rows(0).DefaultCellStyle.PatternStyle = MultiRowHatchStyle.BackwardDiagonal
    gcMultiRow1.Rows(0).DefaultCellStyle.Font = New Font(Control.DefaultFont, FontStyle.Underline)

    ' Change single cell
    gcMultiRow1(0, 0).Style.UseCompatibleTextRendering = MultiRowTriState.True
    gcMultiRow1(0, 0).Style.TextAngle = 30
    gcMultiRow1(0, 0).Style.Format = "#0.00%"
End Sub

参照

GcMultiRow クラス
 GcMultiRow メンバ