DataGridViewCell.ContextMenuStrip Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.