DataGridViewCell.BorderWidths メソッド

.NET Framework クラス ライブラリ リファレンス

DataGridViewCell.BorderWidths メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

すべてのセル マージンの幅を表す Rectangle を返します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 BorderWidths ( _
    advancedBorderStyle As DataGridViewAdvancedBorderStyle _
) As Rectangle

Visual Basic (使用法)

Dim advancedBorderStyle As DataGridViewAdvancedBorderStyle
Dim returnValue As Rectangle

returnValue = Me.BorderWidths(advancedBorderStyle)

C#

protected virtual Rectangle BorderWidths (
    DataGridViewAdvancedBorderStyle advancedBorderStyle
)

C++

protected:
virtual Rectangle BorderWidths (
    DataGridViewAdvancedBorderStyle^ advancedBorderStyle
)

J#

protected Rectangle BorderWidths (
    DataGridViewAdvancedBorderStyle advancedBorderStyle
)

JScript

protected function BorderWidths (
    advancedBorderStyle : DataGridViewAdvancedBorderStyle
) : Rectangle

パラメータ

advancedBorderStyle

マージンを計算する対象の DataGridViewAdvancedBorderStyle。

戻り値
すべてのセル マージンの幅を表す Rectangle。

解説

セル境界線の既定の幅は 1 ピクセルです。次の DataGridViewAdvancedCellBorderStyle 値を使用して、境界線の幅を変更します。

• None 値は、0 ピクセルの幅を表します。

• OutsetDouble 値または InsetDouble 値は、既定の幅を 1 ピクセル増加します。

また、セルを所有している行に対して DividerHeight プロパティが設定されると、四角形の高さが DividerHeight の値だけ増加します。セルを所有している行に対して DividerWidth プロパティが設定されると、四角形の幅が DividerWidth の値だけ増加されます。

使用例

DataGridViewCell クラスの BorderWidths メソッドを使用して、セルの使用可能な描画領域を確認する方法を次のコード例に示します。次のコード例は、「方法 : Windows フォーム DataGridView コントロールのボタン列にあるボタンを無効にする」で示されている例の一部です。

Visual Basic

Protected Overrides Sub
 Paint(ByVal graphics As Graphics, _
    ByVal clipBounds As Rectangle, ByVal
 cellBounds As Rectangle, _
    ByVal rowIndex As Integer,
 _
    ByVal elementState As DataGridViewElementStates,
 _
    ByVal value As Object,
 ByVal formattedValue As Object,
 _
    ByVal errorText As String,
 _
    ByVal cellStyle As DataGridViewCellStyle,
 _
    ByVal advancedBorderStyle As DataGridViewAdvancedBorderStyle,
 _
    ByVal paintParts As DataGridViewPaintParts)

    ' The button cell is disabled, so paint the border,  
    ' background, and disabled button for the cell.
    If Not Me.enabledValue
 Then

        ' Draw the background of the cell, if specified.
        If (paintParts And DataGridViewPaintParts.Background)
 = _
            DataGridViewPaintParts.Background Then

            Dim cellBackground As New
 SolidBrush(cellStyle.BackColor)
            graphics.FillRectangle(cellBackground, cellBounds)
            cellBackground.Dispose()
        End If

        ' Draw the cell borders, if specified.
        If (paintParts And DataGridViewPaintParts.Border)
 = _
            DataGridViewPaintParts.Border Then

            PaintBorder(graphics, clipBounds, cellBounds, cellStyle, _
                advancedBorderStyle)
        End If

        ' Calculate the area in which to draw the button.
        Dim buttonArea As Rectangle = cellBounds
        Dim buttonAdjustment As Rectangle =
 _
            Me.BorderWidths(advancedBorderStyle)
        buttonArea.X += buttonAdjustment.X
        buttonArea.Y += buttonAdjustment.Y
        buttonArea.Height -= buttonAdjustment.Height
        buttonArea.Width -= buttonAdjustment.Width

        ' Draw the disabled button.                
        ButtonRenderer.DrawButton(graphics, buttonArea, _
            PushButtonState.Disabled)

        ' Draw the disabled button text. 
        If TypeOf Me.FormattedValue
 Is String Then
            TextRenderer.DrawText(graphics, CStr(Me.FormattedValue),
 _
                Me.DataGridView.Font, buttonArea, SystemColors.GrayText)
        End If

    Else
        ' The button cell is enabled, so let the base class 
        ' handle the painting.
        MyBase.Paint(graphics, clipBounds, cellBounds, rowIndex,
 _
            elementState, value, formattedValue, errorText, _
            cellStyle, advancedBorderStyle, paintParts)
    End If
End Sub

C#

protected override void Paint(Graphics graphics
,
    Rectangle clipBounds, Rectangle cellBounds, int rowIndex,
    DataGridViewElementStates elementState, object value,
    object formattedValue, string errorText,
    DataGridViewCellStyle cellStyle,
    DataGridViewAdvancedBorderStyle advancedBorderStyle,
    DataGridViewPaintParts paintParts)
{
    // The button cell is disabled, so paint the border,  
    // background, and disabled button for the cell.
    if (!this.enabledValue)
    {
        // Draw the cell background, if specified.
        if ((paintParts & DataGridViewPaintParts.Background)
 ==
            DataGridViewPaintParts.Background)
        {
            SolidBrush cellBackground =
                new SolidBrush(cellStyle.BackColor);
            graphics.FillRectangle(cellBackground, cellBounds);
            cellBackground.Dispose();
        }

        // Draw the cell borders, if specified.
        if ((paintParts & DataGridViewPaintParts.Border) ==
            DataGridViewPaintParts.Border)
        {
            PaintBorder(graphics, clipBounds, cellBounds, cellStyle,
                advancedBorderStyle);
        }

        // Calculate the area in which to draw the button.
        Rectangle buttonArea = cellBounds;
        Rectangle buttonAdjustment =
            this.BorderWidths(advancedBorderStyle);
        buttonArea.X += buttonAdjustment.X;
        buttonArea.Y += buttonAdjustment.Y;
        buttonArea.Height -= buttonAdjustment.Height;
        buttonArea.Width -= buttonAdjustment.Width;

        // Draw the disabled button.                
        ButtonRenderer.DrawButton(graphics, buttonArea,
            PushButtonState.Disabled);

        // Draw the disabled button text. 
        if (this.FormattedValue is String)
 
        {
            TextRenderer.DrawText(graphics,
                (string)this.FormattedValue
,
                this.DataGridView.Font,
                buttonArea, SystemColors.GrayText);
        }
    }
    else
    {
        // The button cell is enabled, so let the base class 
        // handle the painting.
        base.Paint(graphics, clipBounds, cellBounds, rowIndex
,
            elementState, value, formattedValue, errorText,
            cellStyle, advancedBorderStyle, paintParts);
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridViewCell クラス
DataGridViewCell メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewCellBorderStyle
DataGridViewAdvancedCellBorderStyle 列挙体