DataGridViewCell.ContextMenuStrip Właściwość

Definicja

Pobiera lub ustawia menu skrótów skojarzone z komórką.Gets or sets the shortcut menu associated with the cell.

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; }
member this.ContextMenuStrip : System.Windows.Forms.ContextMenuStrip with get, set
Public Overridable Property ContextMenuStrip As ContextMenuStrip

Wartość właściwości

ContextMenuStrip skojarzona z komórką.The ContextMenuStrip associated with the cell.

Uwagi

Ta właściwość wskazuje menu skrótów, które jest zwykle wyświetlane, gdy użytkownik kliknie prawym przyciskiem myszy komórkę.This property indicates the shortcut menu that is typically displayed when the user right-clicks the cell.

Gdy właściwość DataSource formantu DataGridView jest ustawiona lub jej Właściwość VirtualMode jest true, pobieranie wartości właściwości ContextMenuStrip wywołuje zdarzenie CellContextMenuStripNeeded formantu i zwraca wartość właściwości DataGridViewCellContextMenuStripNeededEventArgs.ContextMenuStrip, jak określono w obsłudze zdarzeń.When the DataGridView control DataSource property is set or its VirtualMode property is true, getting the value of the ContextMenuStrip property raises the CellContextMenuStripNeeded event of the control and returns the value of the DataGridViewCellContextMenuStripNeededEventArgs.ContextMenuStrip property as specified in the event handler. Jeśli nie ma żadnych programów obsługi dla zdarzenia, uzyskanie wartości właściwości ContextMenuStrip Zwraca określoną wcześniej wartość lub jej wartość domyślną null.If there are no handlers for the event, getting the value of the ContextMenuStrip property returns the previously specified value or its default value of null.

Obsługa CellContextMenuStripNeededgo zdarzenia jest szczególnie przydatna podczas pracy z dużymi ilościami danych, aby uniknąć kar za wydajność podczas ustawiania komórki ContextMenuStrip wartości dla wielu komórek.Handling the CellContextMenuStripNeeded event is primarily useful when working with large amounts of data to avoid performance penalties when setting the cell ContextMenuStrip value for multiple cells. Aby uzyskać więcej informacji, zobacz najlepsze rozwiązania dotyczące skalowania Windows Forms formantu DataGridView.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Zmiana tej właściwości wywołuje zdarzenie CellContextMenuStripChanged w DataGridViewbędącym właścicielem, jeśli taki istnieje.Changing this property raises the CellContextMenuStripChanged event on the owning DataGridView, if one exists.

Możesz również określić menu skrótów dla pojedynczych wierszy, a nie pojedyncze komórki, ustawiając właściwość wiersza ContextMenuStrip lub obsługując zdarzenie RowContextMenuStripNeeded formantu DataGridView.You can also specify shortcut menus for individual rows rather than individual cells by setting the row ContextMenuStrip property or handling the DataGridView control's RowContextMenuStripNeeded event. Ustawienie właściwości ContextMenuStrip komórki zastępuje ustawienie właściwości wiersz ContextMenuStrip, a zdarzenie CellContextMenuStripNeeded zastępuje zarówno zdarzenie RowContextMenuStripNeeded, jak i wiersz ContextMenuStrip ustawienia właściwości.The cell ContextMenuStrip property setting overrides the row ContextMenuStrip property setting, and the CellContextMenuStripNeeded event overrides both the RowContextMenuStripNeeded event and the row ContextMenuStrip property setting. Można jednak określić null dla menu skrótów komórki, aby zapobiec zastąpieniu menu skrótów wierszy.You can specify null for a cell shortcut menu, however, to prevent a row shortcut menu from being overridden.

Dotyczy

Zobacz też