KeyEventArgs.SuppressKeyPress Свойство

Определение

Возвращает или задает значение, указывающее, следует ли передавать события нажатия клавиши базовому элементу управления.

public:
 property bool SuppressKeyPress { bool get(); void set(bool value); };
public bool SuppressKeyPress { get; set; }
member this.SuppressKeyPress : bool with get, set
Public Property SuppressKeyPress As Boolean

Значение свойства

Значение true, событие нажатия клавиши должно передаваться элементу управления; в противном случае — false.

Примеры

В следующем примере кода предотвращается попадание числовых клавиш в TextBox элемент управления с именем textBox1.

private void textBox1_KeyDown(object sender, KeyEventArgs e)
{
    if (e.KeyCode >= Keys.D0 && e.KeyCode <= Keys.D9 && e.Modifiers != Keys.Shift)
    {
        e.SuppressKeyPress = true;
    }
}
Private Sub TextBox1_KeyDown(ByVal sender As System.Object, _
    ByVal e As System.Windows.Forms.KeyEventArgs) Handles TextBox1.KeyDown
    
    If e.KeyCode >= Keys.D0 And e.KeyCode <= Keys.D9 And _
    e.Modifiers <> Keys.Shift Then
        e.SuppressKeyPress = True
    End If
End Sub

Комментарии

Это свойство можно назначить true в обработчике событий, например , KeyDown чтобы запретить ввод данных пользователем.

При установке SuppressKeyPress значения также присваивается значение Handledtrue.true

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

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