DataGridViewLinkColumn.UseColumnTextForLinkValue プロパティ

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

DataGridViewLinkColumn.UseColumnTextForLinkValue プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

Text プロパティ値がリンク テキストとして表示されるかどうかを示す値を取得または設定します。

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

Visual Basic (宣言)

Public Property UseColumnTextForLinkValue As
 Boolean

Visual Basic (使用法)

Dim instance As DataGridViewLinkColumn
Dim value As Boolean

value = instance.UseColumnTextForLinkValue

instance.UseColumnTextForLinkValue = value

C#

public bool UseColumnTextForLinkValue { get;
 set; }

C++

public:
property bool UseColumnTextForLinkValue {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_UseColumnTextForLinkValue ()

/** @property */
public void set_UseColumnTextForLinkValue (boolean
 value)

JScript

public function get UseColumnTextForLinkValue
 () : boolean

public function set UseColumnTextForLinkValue
 (value : boolean)

プロパティ値
Text プロパティ値がリンク テキストとして表示される場合は true。セルの FormattedValue プロパティ値がリンク テキストとして表示される場合は false。既定値は false です。

例外

例外の種類	条件
InvalidOperationException	CellTemplate プロパティの値が null 参照 (Visual Basic では Nothing) です。

解説

このプロパティを取得または設定すると、CellTemplate プロパティによって返されるオブジェクトの UseColumnTextForLinkValue プロパティを取得または設定できます。このプロパティを設定すると、列に含まれるすべてのセルの UseColumnTextForLinkValue プロパティも設定され、列の表示が更新されます。各セルの指定した値をオーバーライドするには、列の値を設定してからセルの値を設定します。

使用例

各セルの FormattedValue プロパティ (この場合は従業員の上司の従業員 ID) がテキスト リンクとして表示されるようにこのプロパティを設定する方法を次のコード例に示します。リンクを選択した後、選択先は上司の名前に移動します。

Visual Basic

Private Sub AddLinkColumn()

    Dim links As New DataGridViewLinkColumn()
    With links
        .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

C#

private void AddLinkColumn()
{
    DataGridViewLinkColumn links = new DataGridViewLinkColumn();

    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);
}

C++

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

        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);
    }

プラットフォーム

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

参照

関連項目
DataGridViewLinkColumn クラス
DataGridViewLinkColumn メンバ
System.Windows.Forms 名前空間
DataGridView クラス
DataGridViewLinkColumn.Text プロパティ
DataGridViewCell.FormattedValue プロパティ
DataGridViewLinkColumn.CellTemplate プロパティ
DataGridViewLinkCell クラス
DataGridViewLinkCell.UseColumnTextForLinkValue プロパティ