DataGridViewImageCell Класс

Определение

Пространство имен:: System.Windows.Forms

Сборка:: System.Windows.Forms.dll

Исходный код:: DataGridViewImageCell.cs

Исходный код:: DataGridViewImageCell.cs

Исходный код:: DataGridViewImageCell.cs

Исходный код:: DataGridViewImageCell.cs

Исходный код:: DataGridViewImageCell.cs

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Отображает рисунок в элементе DataGridView управления.

public ref class DataGridViewImageCell : System::Windows::Forms::DataGridViewCell

public class DataGridViewImageCell : System.Windows.Forms.DataGridViewCell

type DataGridViewImageCell = class
    inherit DataGridViewCell

Public Class DataGridViewImageCell
Inherits DataGridViewCell

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

DataGridViewElement

DataGridViewCell
DataGridViewImageCell

Примеры

В следующем примере кода показано, как изменить изображение в ячейке изображения с помощью DataGridViewCell. Этот пример кода является частью более крупного примера, приведенного в разделе "Практическое руководство. Работа с столбцами изображений в элементе управления DataGridView в Windows Forms".

void dataGridView1_CellClick( Object^ sender, DataGridViewCellEventArgs^ e )
{
   if ( turn->Equals( gameOverString ) )
   {
      return;
   }

   DataGridViewImageCell^ cell = dynamic_cast<DataGridViewImageCell^>(dataGridView1->Rows[ e->RowIndex ]->Cells[ e->ColumnIndex ]);
   if ( cell->Value == blank )
   {
      if ( IsOsTurn() )
      {
         cell->Value = o;
      }
      else
      {
         cell->Value = x;
      }

      ToggleTurn();
   }

   if ( IsAWin( cell ) )
   {
      turn->Text = gameOverString;
   }
}

private void dataGridView1_CellClick(object sender,
    DataGridViewCellEventArgs e)
{

    if (turn.Text.Equals(gameOverString)) { return; }

    DataGridViewImageCell cell = (DataGridViewImageCell)
        dataGridView1.Rows[e.RowIndex].Cells[e.ColumnIndex];

    if (cell.Value == blank)
    {
        if (IsOsTurn())
        {
            cell.Value = o;
        }
        else
        {
            cell.Value = x;
        }
        ToggleTurn();
    }
    if (IsAWin())
    {
        turn.Text = gameOverString;
    }
}

Private Sub dataGridView1_CellClick(ByVal sender As Object, _
    ByVal e As DataGridViewCellEventArgs) _
    Handles dataGridView1.CellClick

    If turn.Text.Equals(gameOverString) Then Return

    Dim cell As DataGridViewImageCell = _
        CType(dataGridView1.Rows(e.RowIndex). _
            Cells(e.ColumnIndex), DataGridViewImageCell)
    If (cell.Value Is blank) Then
        If IsOsTurn() Then
            cell.Value = o
        Else
            cell.Value = x
        End If
        ToggleTurn()
        ToolTip(e)
    End If
    If IsAWin() Then
        turn.Text = gameOverString
    End If
End Sub

Класс DataGridViewImageCell — это специализированный тип, используемый DataGridViewCell для отображения Image или объекта Iconв зависимости от значения ValueIsIcon свойства. Как правило, ReadOnly свойство объекта DataGridViewImageCell задано, чтобы true указать, что пользователь не может изменить содержимое ячейки.

Тип DataGridViewImageColumn столбца, специализированный для хранения ячеек этого типа. По умолчанию инициализируется DataGridViewImageColumn.CellTemplate в новое DataGridViewImageCell. Чтобы шаблонировать ячейки в столбце после существующего DataGridViewImageCell, задайте свойству столбца CellTemplate значение ячейки, используемой в качестве шаблона.

Свойства, связанные с ячейками столбца, являются оболочками для аналогичных именованных свойств ячейки шаблона. Изменение значений свойств ячейки шаблона повлияет только на ячейки на основе шаблона, добавляемого после изменения. Однако изменение значений свойств, связанных с ячейками столбца, при необходимости обновит ячейку шаблона и все остальные ячейки в столбце и обновит отображение столбца.

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

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

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

Имя	Описание
DataGridViewImageCell()	Инициализирует новый экземпляр DataGridViewImageCell класса, настраивая его для использования со значениями ячеек, отличных от Icon объектов.
DataGridViewImageCell(Boolean)	Инициализирует новый экземпляр DataGridViewImageCell класса, при необходимости настраивая его для использования со значениями Icon ячеек.

Свойства

Имя	Описание
AccessibilityObject	Возвращает назначенный DataGridViewCell.DataGridViewCellAccessibleObject объекту DataGridViewCell. (Унаследовано от DataGridViewCell)
ColumnIndex	Возвращает индекс столбца для этой ячейки. (Унаследовано от DataGridViewCell)
ContentBounds	Возвращает ограничивающий прямоугольник, который заключает область содержимого ячейки. (Унаследовано от DataGridViewCell)
ContextMenuStrip	Возвращает или задает контекстное меню, связанное с ячейкой. (Унаследовано от DataGridViewCell)
DataGridView	Возвращает элемент управления, связанный с этим элементом DataGridView . (Унаследовано от DataGridViewElement)
DefaultNewRowValue	Возвращает значение по умолчанию, используемое при создании новой строки.
Description	Возвращает или задает текст, связанный с изображением.
Displayed	Возвращает значение, указывающее, отображается ли ячейка на экране. (Унаследовано от DataGridViewCell)
EditedFormattedValue	Возвращает текущее форматируемое значение ячейки независимо от того, находится ли ячейка в режиме редактирования и значение не зафиксировано. (Унаследовано от DataGridViewCell)
EditType	Возвращает тип размещенного элемента управления редактирования ячейки.
ErrorIconBounds	Возвращает границы значка ошибки для ячейки. (Унаследовано от DataGridViewCell)
ErrorText	Возвращает или задает текст, описывающий условие ошибки, связанное с ячейкой. (Унаследовано от DataGridViewCell)
FormattedValue	Возвращает значение ячейки в формате отформатированного для отображения. (Унаследовано от DataGridViewCell)
FormattedValueType	Возвращает тип отформатированного значения, связанного с ячейкой.
Frozen	Возвращает значение, указывающее, заморожена ли ячейка. (Унаследовано от DataGridViewCell)
HasStyle	Возвращает значение, указывающее, задано ли Style свойство. (Унаследовано от DataGridViewCell)
ImageLayout	Получает или задает макет графики для ячейки.
InheritedState	Возвращает текущее состояние ячейки, унаследованное от состояния строки и столбца. (Унаследовано от DataGridViewCell)
InheritedStyle	Возвращает стиль, применяемый к ячейке. (Унаследовано от DataGridViewCell)
IsInEditMode	Возвращает значение, указывающее, редактируется ли в данный момент эта ячейка. (Унаследовано от DataGridViewCell)
OwningColumn	Возвращает столбец, содержащий эту ячейку. (Унаследовано от DataGridViewCell)
OwningRow	Возвращает строку, содержащую эту ячейку. (Унаследовано от DataGridViewCell)
PreferredSize	Получает размер в пикселях прямоугольной области, в которой ячейка может поместиться. (Унаследовано от DataGridViewCell)
ReadOnly	Возвращает или задает значение, указывающее, можно ли изменять данные ячейки. (Унаследовано от DataGridViewCell)
Resizable	Возвращает значение, указывающее, можно ли изменить размер ячейки. (Унаследовано от DataGridViewCell)
RowIndex	Возвращает индекс родительской строки ячейки. (Унаследовано от DataGridViewCell)
Selected	Возвращает или задает значение, указывающее, выбрана ли ячейка. (Унаследовано от DataGridViewCell)
Size	Возвращает размер ячейки. (Унаследовано от DataGridViewCell)
State	Возвращает состояние пользовательского интерфейса элемента. (Унаследовано от DataGridViewElement)
Style	Возвращает или задает стиль ячейки. (Унаследовано от DataGridViewCell)
Tag	Возвращает или задает объект, содержащий дополнительные данные о ячейке. (Унаследовано от DataGridViewCell)
ToolTipText	Возвращает или задает текст подсказки, связанный с этой ячейкой. (Унаследовано от DataGridViewCell)
Value	Возвращает или задает значение, связанное с этой ячейкой. (Унаследовано от DataGridViewCell)
ValueIsIcon	Возвращает или задает значение, указывающее, отображает ли эта ячейка Icon значение.
ValueType	Возвращает или задает тип данных значений в ячейке.
Visible	Возвращает значение, указывающее, находится ли ячейка в строке или столбце, который был скрыт. (Унаследовано от DataGridViewCell)

Методы

Имя	Описание
AdjustCellBorderStyle(DataGridViewAdvancedBorderStyle, DataGridViewAdvancedBorderStyle, Boolean, Boolean, Boolean, Boolean)	Изменяет стиль границы входной ячейки в соответствии с указанными критериями. (Унаследовано от DataGridViewCell)
BorderWidths(DataGridViewAdvancedBorderStyle)	Rectangle Возвращает значение, представляющее ширину всех полей ячейки. (Унаследовано от DataGridViewCell)
ClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли строка ячейки не совместно использоваться при щелчке ячейки. (Унаследовано от DataGridViewCell)
Clone()	Создает точную копию этой ячейки.
ContentClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли строка ячейки не совместно использоваться при щелчке содержимого ячейки. (Унаследовано от DataGridViewCell)
ContentDoubleClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли строка ячейки не совместно использоваться при двойном щелчке содержимого ячейки. (Унаследовано от DataGridViewCell)
CreateAccessibilityInstance()	Создает новый объект со специальными возможностями для объекта DataGridViewImageCell.
DetachEditingControl()	Удаляет элемент управления редактирования ячейки из DataGridViewэлемента управления . (Унаследовано от DataGridViewCell)
Dispose()	Освобождает все ресурсы, используемые параметром DataGridViewCell. (Унаследовано от DataGridViewCell)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые DataGridViewCell и при необходимости освобождает управляемые ресурсы. (Унаследовано от DataGridViewCell)
DoubleClickUnsharesRow(DataGridViewCellEventArgs)	Указывает, будет ли строка ячейки не совместно использоваться при двойном щелчке ячейки. (Унаследовано от DataGridViewCell)
EnterUnsharesRow(Int32, Boolean)	Указывает, будет ли родительская строка не совместно использоваться при перемещении фокуса в ячейку. (Унаследовано от DataGridViewCell)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetClipboardContent(Int32, Boolean, Boolean, Boolean, Boolean, String)	Извлекает форматируемое значение ячейки для копирования Clipboardв . (Унаследовано от DataGridViewCell)
GetContentBounds(Graphics, DataGridViewCellStyle, Int32)	Возвращает ограничивающий прямоугольник, который заключает область содержимого ячейки, которая вычисляется с помощью указанного Graphics и стиля ячейки.
GetContentBounds(Int32)	Возвращает ограничивающий прямоугольник, который заключает область содержимого ячейки с использованием стиля ячеек по умолчанию Graphics и ячейки, действующего в настоящее время для ячейки. (Унаследовано от DataGridViewCell)
GetEditedFormattedValue(Int32, DataGridViewDataErrorContexts)	Возвращает текущее форматируемое значение ячейки независимо от того, находится ли ячейка в режиме редактирования и значение не зафиксировано. (Унаследовано от DataGridViewCell)
GetErrorIconBounds(Graphics, DataGridViewCellStyle, Int32)	Возвращает ограничивающий прямоугольник, который заключает значок ошибки ячейки, если он отображается.
GetErrorText(Int32)	Возвращает строку, представляющую ошибку ячейки. (Унаследовано от DataGridViewCell)
GetFormattedValue(Object, Int32, DataGridViewCellStyle, TypeConverter, TypeConverter, DataGridViewDataErrorContexts)	Возвращает рисунок, как он будет отображаться в ячейке.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetInheritedContextMenuStrip(Int32)	Возвращает унаследованное контекстное меню для текущей ячейки. (Унаследовано от DataGridViewCell)
GetInheritedState(Int32)	Возвращает значение, указывающее текущее состояние ячейки, унаследованное от состояния строки и столбца. (Унаследовано от DataGridViewCell)
GetInheritedStyle(DataGridViewCellStyle, Int32, Boolean)	Возвращает стиль, применяемый к ячейке. (Унаследовано от DataGridViewCell)
GetPreferredSize(Graphics, DataGridViewCellStyle, Int32, Size)	Вычисляет предпочтительный размер ячейки в пикселях.
GetSize(Int32)	Возвращает размер ячейки. (Унаследовано от DataGridViewCell)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetValue(Int32)	Возвращает значение ячейки.
InitializeEditingControl(Int32, Object, DataGridViewCellStyle)	Инициализирует элемент управления, используемый для изменения ячейки. (Унаследовано от DataGridViewCell)
KeyDownUnsharesRow(KeyEventArgs, Int32)	Указывает, не используется ли родительская строка, если пользователь нажимает клавишу, пока фокус находится на ячейке. (Унаследовано от DataGridViewCell)
KeyEntersEditMode(KeyEventArgs)	Определяет, следует ли запускать режим редактирования на основе заданного ключа. (Унаследовано от DataGridViewCell)
KeyPressUnsharesRow(KeyPressEventArgs, Int32)	Указывает, будет ли строка не совместно использоваться, если нажатие клавиши при нажатии ячейки в строке имеет фокус. (Унаследовано от DataGridViewCell)
KeyUpUnsharesRow(KeyEventArgs, Int32)	Указывает, не используется ли родительская строка, когда пользователь освобождает ключ во время фокуса в ячейке. (Унаследовано от DataGridViewCell)
LeaveUnsharesRow(Int32, Boolean)	Указывает, будет ли строка не совместно использоваться при выходе фокуса из ячейки в строке. (Унаследовано от DataGridViewCell)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MouseClickUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка не совместно использоваться, если пользователь нажимает кнопку мыши, пока указатель находится в ячейке в строке. (Унаследовано от DataGridViewCell)
MouseDoubleClickUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка не совместно использоваться, если пользователь дважды щелкает ячейку в строке. (Унаследовано от DataGridViewCell)
MouseDownUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка не совместно использоваться, когда пользователь удерживает кнопку мыши, пока указатель находится в ячейке в строке. (Унаследовано от DataGridViewCell)
MouseEnterUnsharesRow(Int32)	Указывает, будет ли строка не совместно использоваться при перемещении указателя мыши по ячейке в строке. (Унаследовано от DataGridViewCell)
MouseLeaveUnsharesRow(Int32)	Указывает, будет ли строка не совместно использоваться, когда указатель мыши покидает строку. (Унаследовано от DataGridViewCell)
MouseMoveUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка не совместно использоваться при перемещении указателя мыши по ячейке в строке. (Унаследовано от DataGridViewCell)
MouseUpUnsharesRow(DataGridViewCellMouseEventArgs)	Указывает, будет ли строка не совместно использоваться, когда пользователь освобождает кнопку мыши, пока указатель находится в ячейке в строке. (Унаследовано от DataGridViewCell)
OnClick(DataGridViewCellEventArgs)	Вызывается при щелчке ячейки. (Унаследовано от DataGridViewCell)
OnContentClick(DataGridViewCellEventArgs)	Вызывается при щелчке содержимого ячейки. (Унаследовано от DataGridViewCell)
OnContentDoubleClick(DataGridViewCellEventArgs)	Вызывается при двойном щелчке содержимого ячейки. (Унаследовано от DataGridViewCell)
OnDataGridViewChanged()	Вызывается при DataGridView изменении свойства ячейки. (Унаследовано от DataGridViewCell)
OnDoubleClick(DataGridViewCellEventArgs)	Вызывается при двойном щелчке ячейки. (Унаследовано от DataGridViewCell)
OnEnter(Int32, Boolean)	Вызывается при перемещении фокуса в ячейку. (Унаследовано от DataGridViewCell)
OnKeyDown(KeyEventArgs, Int32)	Вызывается при нажатии клавиши символа, пока фокус находится на ячейке. (Унаследовано от DataGridViewCell)
OnKeyPress(KeyPressEventArgs, Int32)	Вызывается при нажатии клавиши, пока фокус находится на ячейке. (Унаследовано от DataGridViewCell)
OnKeyUp(KeyEventArgs, Int32)	Вызывается при освобождении ключа символа во время фокуса в ячейке. (Унаследовано от DataGridViewCell)
OnLeave(Int32, Boolean)	Вызывается при перемещении фокуса из ячейки. (Унаследовано от DataGridViewCell)
OnMouseClick(DataGridViewCellMouseEventArgs)	Вызывается, когда пользователь нажимает кнопку мыши, пока указатель находится в ячейке. (Унаследовано от DataGridViewCell)
OnMouseDoubleClick(DataGridViewCellMouseEventArgs)	Вызывается, когда пользователь дважды щелкает кнопку мыши, пока указатель находится в ячейке. (Унаследовано от DataGridViewCell)
OnMouseDown(DataGridViewCellMouseEventArgs)	Вызывается, когда пользователь удерживает кнопку мыши, пока указатель находится в ячейке. (Унаследовано от DataGridViewCell)
OnMouseEnter(Int32)	Вызывается, когда указатель мыши перемещается по ячейке. (Унаследовано от DataGridViewCell)
OnMouseLeave(Int32)	Вызывается, когда указатель мыши покидает ячейку. (Унаследовано от DataGridViewCell)
OnMouseMove(DataGridViewCellMouseEventArgs)	Вызывается, когда указатель мыши перемещается в ячейку. (Унаследовано от DataGridViewCell)
OnMouseUp(DataGridViewCellMouseEventArgs)	Вызывается, когда пользователь освобождает кнопку мыши, пока указатель находится в ячейке. (Унаследовано от DataGridViewCell)
Paint(Graphics, Rectangle, Rectangle, Int32, DataGridViewElementStates, Object, Object, String, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle, DataGridViewPaintParts)	Рисует текущий DataGridViewImageCell.
PaintBorder(Graphics, Rectangle, Rectangle, DataGridViewCellStyle, DataGridViewAdvancedBorderStyle)	Красит границу текущего DataGridViewCell. (Унаследовано от DataGridViewCell)
PaintErrorIcon(Graphics, Rectangle, Rectangle, String)	Закрашивает значок ошибки текущего DataGridViewCell. (Унаследовано от DataGridViewCell)
ParseFormattedValue(Object, DataGridViewCellStyle, TypeConverter, TypeConverter)	Преобразует значение, отформатированный для отображения в фактическое значение ячейки. (Унаследовано от DataGridViewCell)
PositionEditingControl(Boolean, Boolean, Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Задает расположение и размер элемента управления редактирования, размещенного ячейкой в элементе DataGridView управления. (Унаследовано от DataGridViewCell)
PositionEditingPanel(Rectangle, Rectangle, DataGridViewCellStyle, Boolean, Boolean, Boolean, Boolean)	Задает расположение и размер панели редактирования, размещенной ячейкой, и возвращает обычные границы элемента управления редактирования на панели редактирования. (Унаследовано от DataGridViewCell)
RaiseCellClick(DataGridViewCellEventArgs)	Вызывает событие CellClick. (Унаследовано от DataGridViewElement)
RaiseCellContentClick(DataGridViewCellEventArgs)	Вызывает событие CellContentClick. (Унаследовано от DataGridViewElement)
RaiseCellContentDoubleClick(DataGridViewCellEventArgs)	Вызывает событие CellContentDoubleClick. (Унаследовано от DataGridViewElement)
RaiseCellValueChanged(DataGridViewCellEventArgs)	Вызывает событие CellValueChanged. (Унаследовано от DataGridViewElement)
RaiseDataError(DataGridViewDataErrorEventArgs)	Вызывает событие DataError. (Унаследовано от DataGridViewElement)
RaiseMouseWheel(MouseEventArgs)	Вызывает событие MouseWheel. (Унаследовано от DataGridViewElement)
SetValue(Int32, Object)	Задает значение ячейки. (Унаследовано от DataGridViewCell)
ToString()	Возвращает строку, описывающую текущий объект.

Применяется к

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

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через