入力の概要(WPF)　MSDNのドキュメントの和訳

Keyboard Input Event Example

次の例では、左矢印キーが押されるのに聞き耳をたてます。Buttonを持つStackPanelが作成されます。左矢印キーが押されるのに聞き耳をたてるために、イベント・ハンドラは、Buttonインスタンスに添付されます。

例の最初のセクションは、StackPanelとButtonを作成して、KeyDownのためにイベント・ハンドラを添付します。

<StackPanel>
  <Button Background="AliceBlue"
          KeyDown="OnButtonKeyDown"
          Content="Button1"/>
</StackPanel>

// UI要素を作成します。
StackPanel keyboardStackPanel = new StackPanel();
Button keyboardButton1 = new Button();

// Button上にプロパティを設定します。
keyboardButton1.Background = Brushes.AliceBlue;
keyboardButton1.Content = "Button 1";

// ButtonをStackPanelに添付します。
keyboardStackPanel.Children.Add(keyboardButton1);

// イベントハンドラを添付します。
keyboardButton1.KeyDown += new KeyEventHandler(OnButtonKeyDown);

２つ目のセクションは、コードで記述され、イベント・ハンドラを定義します。左矢印キーが押され、Buttonがキーボードのフォーカスを持っているとき、ハンドラが実行され、ButtonのBackground色が、変更されます。キーが押されたが、左矢印キーではない場合、ButtonのBackground色は、元の色に戻ります。

private void OnButtonKeyDown(object sender, KeyEventArgs e)
{
    Button source = e.Source as Button;
    if (source != null)
    {
        if (e.Key == Key.Left)
        {
            source.Background = Brushes.LemonChiffon;
        }
        else
        {
            source.Background = Brushes.AliceBlue;
        }
    }
}

以下の例では、マウス・ポインタが、Buttonに重なるとき、ButtonのBackground色が、変更されます。マウスが、Buttonから離れるとき、Background色が復元されます。

例の最初のセクションでは、StackPanelとButtonコントロールを作成します。そして、MouseEnterとMouseLeaveイベントのために、Buttonにイベント・ハンドラを添付します。

<StackPanel>
  <Button Background="AliceBlue"
          MouseEnter="OnMouseExampleMouseEnter"
          MouseLeave="OnMosueExampleMouseLeave">Button
          
  </Button>
</StackPanel>

// UI要素を作成します。
StackPanel mouseMoveStackPanel = new StackPanel();
Button mouseMoveButton = new Button();

// Button上にプロパティを設定します。
mouseMoveButton.Background = Brushes.AliceBlue;
mouseMoveButton.Content = "Button";

// ButtonをStackPanelに添付します。
mouseMoveStackPanel.Children.Add(mouseMoveButton);

// イベントハンドラを添付します。
mouseMoveButton.MouseEnter += new MouseEventHandler(OnMouseExampleMouseEnter);
mouseMoveButton.MouseLeave += new MouseEventHandler(OnMosueExampleMouseLeave);

例の２つ目のセクションでは、コードで記述され、イベント・ハンドラを定義します。マウスが、Buttonに重なるとき、ButtonのBackground色は、SlateGrayに変更されます。マウスが、Buttonから離れるとき、ButtonのBackground色は、AliceBlueに変更されます。

private void OnMouseExampleMouseEnter(object sender, MouseEventArgs e)
{
    // Buttonにイベントのソースをキャストします。
    Button source = e.Source as Button;

    // ソースが、Buttonである場合。
    if (source != null)
    {
        source.Background = Brushes.SlateGray;
    }
}
private void OnMosueExampleMouseLeave(object sender, MouseEventArgs e)
{
    // Buttonにイベントのソースをキャストします。
    Button source = e.Source as Button;

    // ソースが、Buttonである場合。
    if (source != null)
    {
        source.Background = Brushes.AliceBlue;
    }
}

Prerequisites

あなたは、タッチに反応するアプリケーションを開発するために、以下のコンポーネントを必要とします。

• Visual Studio 2010.
• Windows 7.
• Windows Touchをサポートするタッチスクリーンのようなデバイス

タッチについて説明するとき、次の用語が使用されます。

• タッチは、Windows 7によって認識されるユーザー入力の一種です。通常、タッチは、タッチスクリーン上に、指を置くことによって開始されます。デバイスが、指の位置と動きをマウス入力として単に変換する場合、ラップトップ・コンピュータが、タッチをサポートしないのは、一般的であり、タッチパッドのような、デバイスに注意してください。
• マルチタッチは、同時に複数の位置で発生するタッチです。Windows 7とWPFは、マルチタッチをサポートしています。WPFの文書でタッチについて説明するたびに、概念は、マルチタッチに適用されます。
• 操作は、タッチが、オブジェクトに適用される、物理的な動作として解釈される場合、発生します。WPFでは、操作イベントは、入力を平行移動、展開、または回転操作として解釈します。
• タッチ・デバイスは、タッチスクリーン上の1本の指のような、タッチ入力を作り出す、デバイスを示します。

Controls that Respond to Touch

次のコントロールは、コントロール上で、スクロールして表示されるコンテンツがある場合、指でドラッグすることでスクロールできます。

• ComboBox
• ContextMenu
• DataGrid
• ListBox
• ListView
• MenuItem
• TextBox
• ToolBar
• TreeView

ScrollViewerは、あなたが、タッチのパンが、水平、垂直、両方有効、両方無効かどうかを指定できる、ScrollViewer.PanningMode添付プロパティを定義します。ユーザーが、タッチスクリーンから指を離したとき、ScrollViewer.PanningDecelerationプロパティは、スクロールが、どれくらい速く失速するかを指定します。ScrollViewer.PanningRatio添付プロパティは、オフセット操作を変換するスクロール・オフセットの比率を指定します。

Touch Events

基底クラス、UIElement、UIElement3D、ContentElementは、あなたが、あなたのアプリケーションが、タッチに反応するために、購読できるイベントを定義します。タッチ・イベントは、あなたのアプリケーションが、タッチをオブジェクトの操作以外の何かとして解釈する場合、役に立ちます。たとえば、ユーザーが、1本以上の指で描画できるアプリケーションは、タッチ・イベントを購読します。

3つのクラスは全て、定義するクラスに関係なく、同じように動作する以下のイベントを定義します。

• TouchDown
• TouchMove
• TouchUp
• TouchEnter
• TouchLeave
• PreviewTouchDown
• PreviewTouchMove
• PreviewTouchUp
• GotTouchCapture
• LostTouchCapture

キーボードとマウス・イベントのように、タッチ・イベントは、ルーティング・イベントです。Previewで始めるイベントは、トンネリング・イベントで、Touchで始まるイベントは、バブリング・イベントです。ルーティング・イベントの詳細については、Routedイベントの概要を参照してください。あなたが、これらのイベントを処理するとき、GetTouchPointやGetIntermediateTouchPointsメソッドを呼び出すことで、あなたは、要素と相対的な入力の位置を取得できます。

タッチ・イベント間の相互作用を理解するために、ユーザーが、要素に1本の指を置き、要素内で指を動かすシナリオを考えます。続いて、要素から、指を持ち上げます。次の図は、バブリング・イベントの実行を示しています。（簡単にするため、トンネリング・イベントは省略されています）。

次のリストは、前の図のイベントの順序を説明します。

• ユーザーが、要素に指を置くと、TouchEnterイベントが1回発生します。
• TouchDownイベントは、1回発生します。
• ユーザーが、要素内で指を動かすと、TouchMoveイベントが複数回発生します。
• ユーザーが、要素から指を離したとき、TouchUpイベントが、1回発生します。
• TouchLeaveイベントは、1回発生します。
• 2本以上の指が使用されるとき、イベントは、それぞれの指で発生します。

Manipulation Events

ユーザーが、アプリケーションで、オブジェクトを操作できる場合、UIElementクラスは、操作イベントを定義します。単にタッチの位置を伝えるタッチ・イベントとは異なり、操作イベントは、入力をどのように判断するかを伝えます。操作には、移動、拡大、回転の3つの種類があります。次のリストは、操作の3つの種類を、どのように呼び出すかを説明します。

• オブジェクトに指を置き、指をタッチスクリーン上で動かして、移動操作を呼び出します。これは、通常、オブジェクトを移動します。
• オブジェクトに2本の指を置き、指を互いに近づけたり離したりして、拡大操作を呼び出します。これは、通常、オブジェクトの大きさを変更します。
• オブジェクトに2本の指を置き、指を互いの周りで回転させて、回転操作を呼び出します。これは、通常、オブジェクトを回転します。

複数の種類の操作が、同時に発生する場合があります。

あなたが、操作に、オブジェクトを反応させるとき、あなたは、オブジェクトに慣性があるように見せかけることができます。これは、あなたのオブジェクトに物理的な世界をシミュレートさせることができます。たとえば、あなたが、テーブル越しに、本を押すとき、あなたが、本を十分強く押す場合、あなたが、それを離した後も継続して動き続けます。WPFでは、ユーザーの指が、オブジェクトを離した後に、操作イベントを発生させることにより、この動作をシミュレートできます。

ユーザーが、オブジェクトを移動、サイズ変更、回転できるアプリケーションを、どのように作成するかに関する情報については、Walkthroughを参照してください。：あなたの最初のタッチ・アプリケーションを作成する。

UIElementは、次の操作イベントを定義します。

• ManipulationStarting
• ManipulationStarted
• ManipulationDelta
• ManipulationInertiaStarting
• ManipulationCompleted
• ManipulationBoundaryFeedback

デフォルトでは、UIElementは、これらの操作イベントを受け取りません。UIElement上で操作イベントを受け取るために、UIElement.IsManipulationEnabledを、trueに設定します。

The Execution Path of Manipulation Events

ユーザーが、オブジェクトを「投げる」シナリオを考えます。ユーザーはオブジェクトに指を置き、タッチスクリーン上で、指を短い距離だけ移動します。続いて、移動中に、指を持ち上げます。この結果、オブジェクトは、ユーザーの指の下に移動します。そして、ユーザーが、指を離した後も動き続けます。

次の図は、操作イベントの実行パスとそれぞれのイベントに関する重要な情報を示しています。

操作イベント

次のリストは、前の図のイベントの順序を説明します。

1. ManipulationStartingイベントは、ユーザーが、オブジェクトに指を置いたときに発生します。とりわけ、このイベントは、ManipulationContainerプロパティを設定することができます。その後のイベントでは、操作の位置は、ManipulationContainerに相対的です。ManipulationStarting以外のイベントでは、このプロパティは、読み込み専用です。そのため、ManipulationStartingイベントは、あなたが、このプロパティを設定することができる唯一の時間です。
2. 次に、ManipulationStartedイベントが発生します。このイベントは、操作の開始点を知らせます。
3. ManipulationDeltaイベントは、ユーザーの指がタッチスクリーン上を移動するとき、複数回発生します。ManipulationDeltaEventArgsクラスのDeltaManipulationのプロパティは、操作が、移動、拡大、変形と解釈されるかどうかを知らせます。これは、あなたが、オブジェクトを操作するほとんどの作業を実行する場所です。
4. ユーザーの指が、オブジェクトとの接触を失ったとき、ManipulationInertiaStartingイベントが、発生します。このイベントにより、慣性の操作中の減速を指定できます。ここれは、選択した場合、オブジェクトが、異なる物理空間や属性をエミュレートできるようにするためです。たとえば、あなたのアプリケーションが、物理的な世界のアイテムを表す2つのオブジェクトを持っており、１つは、もう一方より重いと仮定します。あなたは、重いオブジェクトを、軽いオブジェクトよりも速く減速させることができます。
5. ManipulationDeltaイベントは、慣性が発生すると複数回発生します。ユーザーの指が、タッチスクリーン上を移動するとき、そして、WPFが、慣性をシミュレートするとき、このイベントが、発生することに注意してください。言い換えると、ManipulationDeltaが、ManipulationInertiaStartingイベントの前後で、発生します。ManipulationDeltaEventArgs.IsInertialプロパティは、ManipulationDeltaイベントが、慣性中に発生するかどうかにかかわらず、知らせます。そのため、その値に依存して、そのプロパティを確認し、さまざまな動作を実行できます。
6. 操作と慣性が終了したとき、ManipulationCompletedイベントが、発生します。つまり、すべてのManipulationDeltaイベントが発生した後、操作が、完了したことを通知するために、ManipulationCompletedイベントが、発生します。

UIElementは、ManipulationBoundaryFeedbackイベントを定義します。このイベントが、ReportBoundaryFeedbackメソッドが、ManipulationDeltaイベントで呼び出されるとき、発生します。ManipulationBoundaryFeedbackイベントは、アプリケーションを有効にします。あるいは、オブジェクトが、境界に到達したとき、視覚的なフィードバックを提供するコンポーネント。たとえば、Windowクラスは、その端が遭遇するとき、ウィンドウのわずかな移動を引き起こすために、ManipulationBoundaryFeedbackイベントを取り扱います。

ManipulationBoundaryFeedbackイベントを除くすべての操作イベントで、イベント引数で、Cancelメソッドを呼び出すことにより、操作をキャンセルできます。あなたが、Cancelを呼び出すとき、操作イベントは、もはや発生しません。そして、タッチのために、マウス・イベントが、発生します。次の表は、操作が、キャンセルされる、そして、マウス・イベントが、発生する時の間の関係を説明しています。

あなたが、Cancelを呼び出す場合、操作が、inertiaであるとき、メソッドは、falseを返し、入力は、マウス・イベントを発生しないことに注意してください。

Keyboard Focus

キーボード・フォーカスは、キーボード入力を受け取っている、要素を参照します。デスクトップ全体に存在できる要素は、キーボード・フォーカスを持っている1つだけです。WPFでは、キーボード・フォーカスを持つ要素のIsKeyboardFocusedは、trueに設定されます。現在キーボード・フォーカスを持つ、静的KeyboardメソッドのFocusedElementは、要素を返します。

TextBoxのような、要素へのタブによって、あるいは、特定の要素でマウスをクリックすることによって、キーボード・フォーカスを取得できます。KeyboardクラスのFocusメソッドを使用することで、キーボード・フォーカスは、プログラム的に取得することもできます。フォーカスは、指定された要素にキーボード・フォーカスを与えようとします。Focusによって返される要素は、現在キーボード・フォーカスを持っている要素です。

要素が、キーボード・フォーカスを取得するために、FocusableプロパティとIsVisibleプロパティは、trueに設定する必要があります。Panelのような、いくつかのクラスは、デフォルトで、Focusableが、falseに設定されています。;この理由から、あなたが、その要素が、フォーカスを取得できるようにする場合、あなたは、このプロパティをtrueに設定する必要がある場合があります。

次の例は、Focusを使用して、Buttonにキーボード・フォーカスを設定します。アプリケーションの最初のフォーカスを設定するための推薦する場所は、Loadedイベント・ハンドラです。

private void OnLoaded(object sender, RoutedEventArgs e)
{
    // サンプルの最初のButtonに、キーボード・フォーカスを設定します。
    Keyboard.Focus(firstButton);
}

キーボード・フォーカスの詳細については、フォーカスの概要を参照してください。

Logical Focus

論理フォーカスは、フォーカス範囲で、FocusManager.FocusedElementを参照します。アプリケーション内で、論理フォーカスを持つ複数要素が、存在する必要がありますが、要素は、特定のフォーカス範囲に、論理フォーカスを持つ1つだけです。

フォーカス範囲は、そのスコープ内のFocusedElementを追跡する、コンテナ要素です。フォーカスが、フォーカス範囲から離れるとき、フォーカスした要素は、キーボード・フォーカスを失いますが、論理フォーカスを保持します。フォーカスが、フォーカス範囲に戻るとき、フォーカスした要素は、キーボード・フォーカスを取得します。これにより、複数のフォーカス・スコープ間で、キーボード・フォーカスを変更できますが、フォーカスが、返されるとき、フォーカス範囲の中のフォーカスした要素が、フォーカスした要素のままであることを保証します。

要素は、Extensible Application Markup Language (XAML)で、FocusManager添付プロパティIsFocusScopeを、trueに設定することにより、あるいは、コードで、SetIsFocusScopeメソッドを使用して、添付プロパティを設定することによって、フォーカス範囲に切り替えることができます。

次の例では、IsFocusScope添付プロパティを設定することで、StackPanelをフォーカス範囲にします。

<StackPanel Name="focusScope1" 
            FocusManager.IsFocusScope="True"
            Height="200" Width="200">
  <Button Name="button1" Height="50" Width="50"/>
  <Button Name="button2" Height="50" Width="50"/>
</StackPanel>

StackPanel focuseScope2 = new StackPanel();
FocusManager.SetIsFocusScope(focuseScope2, true);

デフォルトでフォーカス範囲であるWPFのクラスは、Window、Menu、ToolBar、ContextMenuです。

キーボード・フォーカスを持っている要素は、それが属するフォーカス範囲の論理フォーカスを持っています。;この理由から、Keyboardクラス上にFocusメソッドを持つ要素上のフォーカスを設定します。あるいは、基底要素クラスは、要素に、キーボード・フォーカスと論理フォーカスを与えようとします。

フォーカス範囲でフォーカスした要素を決定するために、GetFocusedElementを使用します。フォーカス範囲のフォーカスした要素を変更するために、SetFocusedElementを使用します。

論理フォーカスの詳細については、フォーカスの概要を参照してください。