DataGridViewCell.ContextMenuStrip Propriedade

  • Referência

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Obtém ou define o menu de atalho associado à célula.

public:
 virtual property System::Windows::Forms::ContextMenuStrip ^ ContextMenuStrip { System::Windows::Forms::ContextMenuStrip ^ get(); void set(System::Windows::Forms::ContextMenuStrip ^ value); };
public virtual System.Windows.Forms.ContextMenuStrip ContextMenuStrip { get; set; }
public virtual System.Windows.Forms.ContextMenuStrip? ContextMenuStrip { get; set; }
member this.ContextMenuStrip : System.Windows.Forms.ContextMenuStrip with get, set
Public Overridable Property ContextMenuStrip As ContextMenuStrip

Valor da propriedade

ContextMenuStrip

O ContextMenuStrip associado à célula.

Comentários

Essa propriedade indica o menu de atalho que normalmente é exibido quando o usuário clica com o botão direito do mouse na célula.

Quando a DataGridView propriedade de controle DataSource é definida ou sua VirtualMode propriedade é true, obter o valor da ContextMenuStrip propriedade gera o CellContextMenuStripNeeded evento do controle e retorna o valor da DataGridViewCellContextMenuStripNeededEventArgs.ContextMenuStrip propriedade conforme especificado no manipulador de eventos. Se não houver manipuladores para o evento, obter o valor da ContextMenuStrip propriedade retornará o valor especificado anteriormente ou seu valor padrão de null.

Lidar com o CellContextMenuStripNeeded evento é útil principalmente ao trabalhar com grandes quantidades de dados para evitar penalidades de desempenho ao definir o valor da célula ContextMenuStrip para várias células. Para obter mais informações, consulte Práticas recomendadas para colocação em escala do controle DataGridView dos Windows Forms.

Alterar essa propriedade gera o CellContextMenuStripChanged evento na propriedade DataGridView, se houver.

Você também pode especificar menus de atalho para linhas individuais em vez de células individuais definindo a propriedade de linha ContextMenuStrip ou tratando o DataGridView evento do RowContextMenuStripNeeded controle. A configuração da propriedade de célula ContextMenuStrip substitui a configuração da propriedade de linha ContextMenuStrip e o CellContextMenuStripNeeded evento substitui o RowContextMenuStripNeeded evento e a configuração da propriedade de linha ContextMenuStrip . No entanto, você pode especificar null um menu de atalho de célula para impedir que um menu de atalho de linha seja substituído.

Aplica-se a

Confira também