DataGridViewLinkColumn Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Представляет столбец ячеек, которые содержат ссылки в элементе управления DataGridView.

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")>]
type DataGridViewLinkColumn = class
    inherit DataGridViewColumn

Public Class DataGridViewLinkColumn
Inherits DataGridViewColumn

Наследование

Object

DataGridViewElement

DataGridViewBand

DataGridViewColumn

DataGridViewLinkColumn

Атрибуты

ToolboxBitmapAttribute

Примеры

В следующем примере кода задаются свойства для DataGridViewLinkColumn. Этот пример является частью более крупного примера, доступного в DataGridViewComboBoxColumn разделе обзора класса.

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 для логического размещения ячеек, которые реагируют на щелчки пользователем. Класс DataGridViewLinkColumn аналогичен классу , DataGridViewButtonColumn но предоставляет другой пользовательский интерфейс, который может быть более подходящим в определенных ситуациях, например при отображении URL-адреса, хранящегося в таблице базы данных.

Чтобы отобразить один и тот же текст ссылки для каждой ячейки UseColumnTextForLinkValue , задайте для свойства значение true , а для Text свойства — нужный текст ссылки.

Объект DataGridViewLinkColumn имеет связанный объект DataGridViewLinkCell в каждом DataGridViewRow , который пересекает его.

Режим сортировки по умолчанию для этого типа столбца — NotSortable.

Чтобы ответить на щелчки ссылки пользователя, обработайте DataGridView.CellContentClick событие . Событие также можно использовать для реагирования DataGridView.CellClick на щелчки в любом месте ячейки.

Примечания для тех, кто наследует этот метод

При наследовающем DataGridViewLinkColumn от и добавлении новых свойств в производный класс обязательно переопределите Clone() метод , чтобы скопировать новые свойства во время операций клонирования. Необходимо также вызвать метод базового класса Clone() , чтобы свойства базового класса копировались в новую ячейку.

Конструкторы

DataGridViewLinkColumn()

Инициализирует новый экземпляр класса DataGridViewLinkColumn.

Свойства

ActiveLinkColor	Получает или задает цвет, применяемый для отображения активной ссылки в ячейках столбца.
AutoSizeMode	Возвращает или задает режим, в котором автоматически изменяется ширина столбца. (Унаследовано от DataGridViewColumn)
CellTemplate	Возвращает или задает шаблон, используемый для создания ячеек.
CellType	Возвращает тип времени выполнения шаблона ячеек. (Унаследовано от DataGridViewColumn)
ContextMenuStrip	Возвращает или задает контекстное меню для столбца. (Унаследовано от DataGridViewColumn)
DataGridView	Получает элемент управления DataGridView, связанный с данным элементом. (Унаследовано от DataGridViewElement)
DataPropertyName	Возвращает или задает имя того свойства данных или столбца базы данных в источнике данных, с которым связан столбец DataGridViewColumn. (Унаследовано от DataGridViewColumn)
DefaultCellStyle	Возвращает или задает стиль по умолчанию для ячеек столбца. (Унаследовано от DataGridViewColumn)
DefaultHeaderCellType	Получает или задает тип времени выполнения для ячейки заголовка по умолчанию. (Унаследовано от DataGridViewBand)
Displayed	Получает значение, показывающее, отображается ли диапазон на экране в данный момент. (Унаследовано от DataGridViewBand)
DisplayIndex	Возвращает или задает расположение столбца относительно столбцов, отображаемых в текущий момент. (Унаследовано от DataGridViewColumn)
DividerWidth	Возвращает или задает ширину (в пикселях) разделителя столбца. (Унаследовано от DataGridViewColumn)
FillWeight	Возвращает или задает значение, представляющее ширину столбца, находящегося в режиме заполнения, относительно ширины других столбцов элемента управления, находящихся в этом режиме. (Унаследовано от DataGridViewColumn)
Frozen	Возвращает или задает значение, указывающее, перемещается ли столбец, когда пользователь выполняет горизонтальную прокрутку элемента управления DataGridView. (Унаследовано от DataGridViewColumn)
HasDefaultCellStyle	Получает значение, показывающее, было ли установлено свойство DefaultCellStyle. (Унаследовано от DataGridViewBand)
HeaderCell	Возвращает или задает объект DataGridViewColumnHeaderCell, представляющий заголовок столбца. (Унаследовано от DataGridViewColumn)
HeaderCellCore	Получает или задает ячейку заголовка объекта DataGridViewBand. (Унаследовано от DataGridViewBand)
HeaderText	Возвращает или задает текст ячейки заголовка столбца. (Унаследовано от DataGridViewColumn)
Index	Получает относительную позицию диапазона в элементе управления DataGridView. (Унаследовано от DataGridViewBand)
InheritedAutoSizeMode	Возвращает или задает режим изменения размера, действующий для столбца. (Унаследовано от DataGridViewColumn)
InheritedStyle	Возвращает стиль ячейки, применяемый в текущий момент к столбцу. (Унаследовано от DataGridViewColumn)
IsDataBound	Возвращает значение, указывающее, связан ли столбец с источником данных. (Унаследовано от DataGridViewColumn)
IsRow	Получает значение, показывающее, представляет ли диапазон строку. (Унаследовано от DataGridViewBand)
LinkBehavior	Получает или задает значение, представляющее режим работы ссылок в ячейках столбца.
LinkColor	Получает или задает цвет, применяемый для отображения невыбранной ссылки в ячейках столбца.
MinimumWidth	Возвращает или задает наименьшую ширину столбца (в пикселях). (Унаследовано от DataGridViewColumn)
Name	Возвращает или задает имя столбца. (Унаследовано от DataGridViewColumn)
ReadOnly	Возвращает или задает значение, указывающее, может ли пользователь изменять ячейки столбца. (Унаследовано от DataGridViewColumn)
Resizable	Возвращает или задает значение, указывающее, возможно ли изменение размера столбца. (Унаследовано от DataGridViewColumn)
Selected	Получает или задает значение, показывающее, выделен ли диапазон в пользовательском интерфейсе. (Унаследовано от DataGridViewBand)
Site	Возвращает или задает подложку столбца. (Унаследовано от DataGridViewColumn)
SortMode	Возвращает или задает режим сортировки для столбца. (Унаследовано от DataGridViewColumn)
State	Получает состояние пользовательского интерфейса для элемента. (Унаследовано от DataGridViewElement)
Tag	Получает или задает объект, содержащий данные, связанные с диапазоном. (Унаследовано от DataGridViewBand)
Text	Получает или задает текст ссылки, отображаемый в ячейках столбца, если свойствоUseColumnTextForLinkValue имеет значение true.
ToolTipText	Возвращает или задает текст, используемый для подсказок. (Унаследовано от DataGridViewColumn)
TrackVisitedState	Получает или задает значение, указывающее, изменяется ли цвет ссылки после ее посещения.
UseColumnTextForLinkValue	Получает или задает значение, указывающее, отображается ли значение свойства Text в качестве текста ссылки.
ValueType	Возвращает или задает тип данных для значений в ячейках столбца. (Унаследовано от DataGridViewColumn)
Visible	Возвращает или задает значение, показывающее, видим ли столбец. (Унаследовано от DataGridViewColumn)
VisitedLinkColor	Получает или задает цвет, используемый для отображения уже посещенной ссылки.
Width	Возвращает или задает текущую ширину столбца. (Унаследовано от DataGridViewColumn)

Методы

Clone()	Создает точную копию этого столбца.
Dispose()	Освобождает все ресурсы, занятые модулем DataGridViewBand. (Унаследовано от DataGridViewBand)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые объектом DataGridViewBand, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DataGridViewColumn)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetPreferredWidth(DataGridViewAutoSizeColumnMode, Boolean)	Вычисляет оптимальную ширину столбца на основе указанных критериев. (Унаследовано от DataGridViewColumn)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
OnDataGridViewChanged()	Вызывается, когда диапазон связан с другим элементом управления DataGridView. (Унаследовано от DataGridViewBand)
RaiseCellClick(DataGridViewCellEventArgs)	Вызывает событие CellClick. (Унаследовано от DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Вызывает событие CellContentClick. (Унаследовано от DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Вызывает событие CellContentDoubleClick. (Унаследовано от DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Вызывает событие CellValueChanged. (Унаследовано от DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Вызывает событие DataError. (Унаследовано от DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Вызывает событие MouseWheel. (Унаследовано от DataGridViewElement)
ToString()	Возвращает строку, описывающую столбец.

События

Disposed

Происходит при удалении объекта DataGridViewColumn. (Унаследовано от DataGridViewColumn)

См. также раздел

• DataGridView
• DataGridViewColumn
• DataGridViewRow
• DataGridViewButtonColumn
• DataGridViewLinkCell
• SortMode
• CellContentClick
• CellClick
• UseColumnTextForLinkValue
• Text