Control.IsInputChar Method (System.Windows.Forms)

IsInputChar Method

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2010/.NET Framework 4

Other versions are also available for the following:

.NET Framework Class Library

Control..::.IsInputChar Method

Determines if a character is an input character that the control recognizes.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)

Syntax

Visual Basic

<UIPermissionAttribute(SecurityAction.InheritanceDemand, Window := UIPermissionWindow.AllWindows)> _
Protected Overridable Function IsInputChar ( _
    charCode As Char _
) As Boolean

[UIPermissionAttribute(SecurityAction.InheritanceDemand, Window = UIPermissionWindow.AllWindows)]
protected virtual bool IsInputChar(
    char charCode
)

Visual C++

[UIPermissionAttribute(SecurityAction::InheritanceDemand, Window = UIPermissionWindow::AllWindows)]
protected:
virtual bool IsInputChar(
    wchar_t charCode
)

[<UIPermissionAttribute(SecurityAction.InheritanceDemand, Window = UIPermissionWindow.AllWindows)>]
abstract IsInputChar : 
        charCode:char -> bool 
[<UIPermissionAttribute(SecurityAction.InheritanceDemand, Window = UIPermissionWindow.AllWindows)>]
override IsInputChar : 
        charCode:char -> bool

Parameters

charCode: Type: System..::.Char
The character to test.

Return Value

Type: System..::.Boolean
true if the character should be sent directly to the control and not preprocessed; otherwise, false.

Remarks

Call the IsInputChar method to determine whether the character specified by the charCode parameter is an input character that the control wants. This method is called during window message preprocessing to determine whether the specified input character should be preprocessed or sent directly to the control. If IsInputChar returns true, the specified character is sent directly to the control. If IsInputChar returns false, the specified character is preprocessed and only sent to the control if it is not consumed by the preprocessing phase. The preprocessing of a character includes checking whether the character is a mnemonic of another control.

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET Framework Security

UIPermission
for all windows for inheriting classes to call this method. Associated enumeration: AllWindows value of UIPermissionWindow.

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Control Class

System.Windows.Forms Namespace

IsInputKey