DataGridViewLinkColumn クラス

定義

DataGridView コントロール内のリンクを格納するセルの列を表します。Represents a column of cells that contain links in a DataGridView control.

public ref class DataGridViewLinkColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn.bmp")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
type DataGridViewLinkColumn = class
    inherit DataGridViewColumn
Public Class DataGridViewLinkColumn
Inherits DataGridViewColumn
継承
属性

次のコード例では、DataGridViewLinkColumnのプロパティを設定します。The following code example sets properties on a DataGridViewLinkColumn. この例は、DataGridViewComboBoxColumn クラスの概要に関するトピックで使用できるより大きな例の一部です。This example is part of a larger example available in the DataGridViewComboBoxColumn class overview topic.

private:
    void AddLinkColumn()
    {
        DataGridViewLinkColumn^ links = gcnew DataGridViewLinkColumn();

        links->UseColumnTextForLinkValue = true;
        links->HeaderText = ColumnName::ReportsTo.ToString();
        links->DataPropertyName = ColumnName::ReportsTo.ToString();
        links->ActiveLinkColor = Color::White;
        links->LinkBehavior = LinkBehavior::SystemDefault;
        links->LinkColor = Color::Blue;
        links->TrackVisitedState = true;
        links->VisitedLinkColor = Color::YellowGreen;

        DataGridView1->Columns->Add(links);
    }
private void AddLinkColumn()
{
    DataGridViewLinkColumn links = new DataGridViewLinkColumn();

    links.UseColumnTextForLinkValue = true;
    links.HeaderText = ColumnName.ReportsTo.ToString();
    links.DataPropertyName = ColumnName.ReportsTo.ToString();
    links.ActiveLinkColor = Color.White;
    links.LinkBehavior = LinkBehavior.SystemDefault;
    links.LinkColor = Color.Blue;
    links.TrackVisitedState = true;
    links.VisitedLinkColor = Color.YellowGreen;

    DataGridView1.Columns.Add(links);
}
Private Sub AddLinkColumn()

    Dim links As New DataGridViewLinkColumn()
    With links
        .UseColumnTextForLinkValue = True
        .HeaderText = ColumnName.ReportsTo.ToString()
        .DataPropertyName = ColumnName.ReportsTo.ToString()
        .ActiveLinkColor = Color.White
        .LinkBehavior = LinkBehavior.SystemDefault
        .LinkColor = Color.Blue
        .TrackVisitedState = True
        .VisitedLinkColor = Color.YellowGreen
    End With
    DataGridView1.Columns.Add(links)
End Sub

注釈

DataGridViewLinkColumn クラスは、ユーザーのクリックに応答するセルを論理的にホストするために使用する、DataGridViewColumn クラスの特殊な型です。The DataGridViewLinkColumn class is a specialized type of the DataGridViewColumn class used to logically host cells that respond to user clicks. DataGridViewLinkColumn クラスは DataGridViewButtonColumn クラスに似ていますが、データベーステーブルに格納されている URL を表示するなど、特定の状況でより適切なユーザーエクスペリエンスが提供されます。The DataGridViewLinkColumn class is similar to the DataGridViewButtonColumn class but provides a different user experience that may be more appropriate in certain situations, such as displaying a URL stored in a database table.

すべてのセルに同じリンクテキストを表示するには、UseColumnTextForLinkValue プロパティを true に設定し、Text プロパティを目的のリンクテキストに設定します。To display the same link text for every cell, set the UseColumnTextForLinkValue property to true and set the Text property to the desired link text.

DataGridViewLinkColumn には、それと交差するすべての DataGridViewRow に関連付けられた DataGridViewLinkCell があります。A DataGridViewLinkColumn has an associated DataGridViewLinkCell in every DataGridViewRow that intersects it.

この列の種類の既定の並べ替えモードは NotSortableです。The default sort mode for this column type is NotSortable.

ユーザーリンクのクリックに応答するには、DataGridView.CellContentClick イベントを処理します。To respond to user link clicks, handle the DataGridView.CellContentClick event. DataGridView.CellClick イベントを使用して、セル内の任意の場所でのクリックに応答することもできます。You can also use the DataGridView.CellClick event to respond to clicks anywhere in the cell.

注意 (継承者)

DataGridViewLinkColumn から派生し、派生クラスに新しいプロパティを追加する場合は、Clone() メソッドをオーバーライドして、複製操作中に新しいプロパティをコピーするようにしてください。When you derive from DataGridViewLinkColumn and add new properties to the derived class, be sure to override the Clone() method to copy the new properties during cloning operations. また、基本クラスの Clone() メソッドを呼び出して、基底クラスのプロパティが新しいセルにコピーされるようにする必要があります。You should also call the base class's Clone() method so that the properties of the base class are copied to the new cell.

コンストラクター

DataGridViewLinkColumn()

DataGridViewLinkColumn クラスの新しいインスタンスを初期化します。Initializes a new instance of the DataGridViewLinkColumn class.

プロパティ

ActiveLinkColor

列のセル内のアクティブなリンクを表示するために使用する色を取得または設定します。Gets or sets the color used to display an active link within cells in the column.

AutoSizeMode

列の幅を自動的に調整するときに使用するモードを取得または設定します。Gets or sets the mode by which the column automatically adjusts its width.

(継承元 DataGridViewColumn)
CellTemplate

新しいセルの作成に使用するテンプレートを取得または設定します。Gets or sets the template used to create new cells.

CellType

セル テンプレートのランタイム型を取得します。Gets the run-time type of the cell template.

(継承元 DataGridViewColumn)
ContextMenuStrip

列のショートカット メニューを取得または設定します。Gets or sets the shortcut menu for the column.

(継承元 DataGridViewColumn)
DataGridView

この要素に関連付けられている DataGridView コントロールを取得します。Gets the DataGridView control associated with this element.

(継承元 DataGridViewElement)
DataPropertyName

DataGridViewColumn がバインドされている、データ ソース プロパティの名前またはデータベースの列の名前を取得または設定します。Gets or sets the name of the data source property or database column to which the DataGridViewColumn is bound.

(継承元 DataGridViewColumn)
DefaultCellStyle

列の既定のセル スタイルを取得または設定します。Gets or sets the column's default cell style.

(継承元 DataGridViewColumn)
DefaultHeaderCellType

既定のヘッダー セルのランタイム型を取得または設定します。Gets or sets the run-time type of the default header cell.

(継承元 DataGridViewBand)
Displayed

バンドが現在画面に表示されているかどうかを示す値を取得します。Gets a value indicating whether the band is currently displayed onscreen.

(継承元 DataGridViewBand)
DisplayIndex

現在表示されている列を基準とした列の表示順序を設定または取得します。Gets or sets the display order of the column relative to the currently displayed columns.

(継承元 DataGridViewColumn)
DividerWidth

列の区分線の幅 (ピクセル数) を取得または設定します。Gets or sets the width, in pixels, of the column divider.

(継承元 DataGridViewColumn)
FillWeight

列が、コントロール内の他の塗りつぶしモードの列の幅を基準とする塗りつぶしモードの場合、列の幅を表す値を取得または設定します。Gets or sets a value that represents the width of the column when it is in fill mode relative to the widths of other fill-mode columns in the control.

(継承元 DataGridViewColumn)
Frozen

ユーザーが DataGridView コントロールを水平方向にスクロールしたときに列が移動するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether a column will move when a user scrolls the DataGridView control horizontally.

(継承元 DataGridViewColumn)
HasDefaultCellStyle

DefaultCellStyle プロパティが設定されているかどうかを示す値を取得します。Gets a value indicating whether the DefaultCellStyle property has been set.

(継承元 DataGridViewBand)
HeaderCell

列ヘッダーを表す DataGridViewColumnHeaderCell を取得または設定します。Gets or sets the DataGridViewColumnHeaderCell that represents the column header.

(継承元 DataGridViewColumn)
HeaderCellCore

DataGridViewBand のヘッダー セルを取得または設定します。Gets or sets the header cell of the DataGridViewBand.

(継承元 DataGridViewBand)
HeaderText

列のヘッダー セルのキャプション テキストを取得または設定します。Gets or sets the caption text on the column's header cell.

(継承元 DataGridViewColumn)
Index

DataGridView コントロール内のバンドの相対位置を取得します。Gets the relative position of the band within the DataGridView control.

(継承元 DataGridViewBand)
InheritedAutoSizeMode

列に対して有効なサイズ変更モードを取得します。Gets the sizing mode in effect for the column.

(継承元 DataGridViewColumn)
InheritedStyle

列に現在適用されているセル スタイルを取得します。Gets the cell style currently applied to the column.

(継承元 DataGridViewColumn)
IsDataBound

列がデータ ソースにバインドされているかどうかを示す値を取得します。Gets a value indicating whether the column is bound to a data source.

(継承元 DataGridViewColumn)
IsRow

バンドが行を表すかどうかを示す値を取得します。Gets a value indicating whether the band represents a row.

(継承元 DataGridViewBand)
LinkBehavior

列のセル内のリンクの動作を表す値を取得または設定します。Gets or sets a value that represents the behavior of links within cells in the column.

LinkColor

列のセル内の非選択状態のリンクを表示するために使用する色を取得または設定します。Gets or sets the color used to display an unselected link within cells in the column.

MinimumWidth

列の最小幅をピクセル単位で取得または設定します。Gets or sets the minimum width, in pixels, of the column.

(継承元 DataGridViewColumn)
Name

列の名前を取得または設定します。Gets or sets the name of the column.

(継承元 DataGridViewColumn)
ReadOnly

ユーザーが列のセルを編集できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the user can edit the column's cells.

(継承元 DataGridViewColumn)
Resizable

列のサイズを変更できるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the column is resizable.

(継承元 DataGridViewColumn)
Selected

バンドが、選択されたユーザー インターフェイス (UI) 状態かどうかを示す値を取得または設定します。Gets or sets a value indicating whether the band is in a selected user interface (UI) state.

(継承元 DataGridViewBand)
Site

列のサイトを取得または設定します。Gets or sets the site of the column.

(継承元 DataGridViewColumn)
SortMode

列の並べ替えモードを取得または設定します。Gets or sets the sort mode for the column.

(継承元 DataGridViewColumn)
State

要素のユーザー インターフェイス (UI) の状態を取得します。Gets the user interface (UI) state of the element.

(継承元 DataGridViewElement)
Tag

バンドに関連付けられているデータを含むオブジェクトを取得または設定します。Gets or sets the object that contains data to associate with the band.

(継承元 DataGridViewBand)
Text

UseColumnTextForLinkValuetrue の場合に列のセルに表示されるリンク テキストを取得または設定します。Gets or sets the link text displayed in a column's cells if UseColumnTextForLinkValue is true.

ToolTipText

ツールヒントに使用されるテキストを取得または設定します。Gets or sets the text used for ToolTips.

(継承元 DataGridViewColumn)
TrackVisitedState

以前にリンク先に移動したことがある場合、リンクの色が変わるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the link changes color if it has been visited.

UseColumnTextForLinkValue

Text プロパティ値がリンク テキストとして表示されるかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the Text property value is displayed as the link text.

ValueType

列のセルの値のデータ型を取得または設定します。Gets or sets the data type of the values in the column's cells.

(継承元 DataGridViewColumn)
Visible

列を表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the column is visible.

(継承元 DataGridViewColumn)
VisitedLinkColor

以前にリンク先に移動したことのあるリンクを表示するために使用する色を取得または設定します。Gets or sets the color used to display a link that has been previously visited.

Width

列の現在の幅を取得または設定します。Gets or sets the current width of the column.

(継承元 DataGridViewColumn)

メソッド

Clone()

対象の列の同一コピーを作成します。Creates an exact copy of this column.

Dispose()

DataGridViewBand によって使用されているすべてのリソースを解放します。Releases all resources used by the DataGridViewBand.

(継承元 DataGridViewBand)
Dispose(Boolean)

DataGridViewBand によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the DataGridViewBand and optionally releases the managed resources.

(継承元 DataGridViewColumn)
Equals(Object)

指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判定します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)

指定した基準に基づいて、列の適切な幅を計算します。Calculates the ideal width of the column based on the specified criteria.

(継承元 DataGridViewColumn)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
OnDataGridViewChanged()

バンドが別の DataGridView に関連付けられている場合に呼び出されます。Called when the band is associated with a different DataGridView.

(継承元 DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)

CellClick イベントを発生させます。Raises the CellClick event.

(継承元 DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)

CellContentClick イベントを発生させます。Raises the CellContentClick event.

(継承元 DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)

CellContentDoubleClick イベントを発生させます。Raises the CellContentDoubleClick event.

(継承元 DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)

CellValueChanged イベントを発生させます。Raises the CellValueChanged event.

(継承元 DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)

DataError イベントを発生させます。Raises the DataError event.

(継承元 DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)

MouseWheel イベントを発生させます。Raises the MouseWheel event.

(継承元 DataGridViewElement)
ToString()

列を説明する文字列を取得します。Gets a string that describes the column.

イベント

Disposed

DataGridViewColumn が破棄されたときに発生します。Occurs when the DataGridViewColumn is disposed.

(継承元 DataGridViewColumn)

適用対象

こちらもご覧ください