Control.ProcessCmdKey メソッド

.NET Framework クラス ライブラリ リファレンス

Control.ProcessCmdKey メソッド

コマンド キーを処理します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Protected Overridable Function
 ProcessCmdKey ( _
    ByRef msg As Message, _
    keyData As Keys _
) As Boolean

Visual Basic (使用法)

Dim msg As Message
Dim keyData As Keys
Dim returnValue As Boolean

returnValue = Me.ProcessCmdKey(msg, keyData)

C#

protected virtual bool ProcessCmdKey (
    ref Message msg,
    Keys keyData
)

C++

protected:
virtual bool ProcessCmdKey (
    Message% msg, 
    Keys keyData
)

J#

protected boolean ProcessCmdKey (
    /** @ref */ Message msg, 
    Keys keyData
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

msg

処理するウィンドウ メッセージを表す、参照渡しされた Message。

keyData

処理するキーを表す Keys 値の 1 つ。

戻り値
文字がコントロールによって処理された場合は true。それ以外の場合は false。

解説

このメソッドは、メッセージのプリプロセス中にコマンド キーを処理するために呼び出されます。コマンド キーは、通常の入力キーよりも常に優先されるキーです。コマンド キーの例として、アクセラレータ キーやメニューのショートカット キーがあります。このメソッドは、コマンド キーを処理したことを示す場合は true を返します。キーがコマンド キーではないことを示す場合は false を返します。このメソッドは、コントロールが Windows フォーム アプリケーション内で管理されるか、ActiveX コントロールとして管理される場合にだけ呼び出されます。

ProcessCmdKey メソッドは、まずコントロールに ContextMenu があるかどうかを確認し、コンテキスト メニューがある場合は、ContextMenu でコマンド キーを処理できるようにします。コマンド キーがメニューのショートカットでない場合、コントロールが親を持っていれば、キーは親の ProcessCmdKey メソッドに渡されます。最終的に、コマンド キーはコントロールの階層構造を "押し上げられる" ことになります。キー データは、キーと同時に修飾子キーが押された場合は、ユーザーが押したキーだけではなく、どの修飾子キーが押されたかも示します。修飾子キーには、Shift、Ctrl、Alt の各キーがあります。

継承時の注意 派生クラスで ProcessCmdKey メソッドをオーバーライドする場合、コントロールはキーを処理したことを示すために true を返す必要があります。コントロールによって処理されないキーの場合は、基本クラスの ProcessCmdKey メソッドを呼び出した結果が返されます。コントロールがこのメソッドをオーバーライドする必要はほとんどありません。

.NET Framework のセキュリティ

• UIPermission  (継承クラスのすべてのウィンドウでこのメソッドを呼び出すために必要なアクセス許可)。UIPermissionWindow の AllWindows 値 (関連する列挙体)。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Control クラス
Control メンバ
System.Windows.Forms 名前空間