DataGridViewLinkColumn Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет столбец ячеек, содержащих ссылки в элементе DataGridView управления.
public ref class DataGridViewLinkColumn : System::Windows::Forms::DataGridViewColumn
[System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn.bmp")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
[System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)]
[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")]
public class DataGridViewLinkColumn : System.Windows.Forms.DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn.bmp")>]
type DataGridViewLinkColumn = class
inherit DataGridViewColumn
[<System.Diagnostics.CodeAnalysis.DynamicallyAccessedMembers(System.Diagnostics.CodeAnalysis.DynamicallyAccessedMemberTypes.PublicParameterlessConstructor)>]
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")>]
type DataGridViewLinkColumn = class
inherit DataGridViewColumn
[<System.Drawing.ToolboxBitmap(typeof(System.Windows.Forms.DataGridViewLinkColumn), "DataGridViewLinkColumn")>]
type DataGridViewLinkColumn = class
inherit DataGridViewColumn
Public Class DataGridViewLinkColumn
Inherits DataGridViewColumn
- Наследование
- Атрибуты
Примеры
В следующем примере кода задаются свойства для 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 для свойства нужный текст ссылки.
A 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 есть |
| 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) |