PenInputPanel.InputFailed イベント

使用されていません。PenInputPanel オブジェクトがユーザー入力を結合されたオブジェクトに挿入できるようになる前に入力のフォーカスが変化した場合に発生します。PenInputPanel は Microsoft.Ink.TextInput に置き換えられました。

名前空間 :  Microsoft.Ink
アセンブリ :  Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Event InputFailed As PenInputPanelInputFailedEventHandler
'使用
Dim instance As PenInputPanel
Dim handler As PenInputPanelInputFailedEventHandler

AddHandler instance.InputFailed, handler
public event PenInputPanelInputFailedEventHandler InputFailed
public:
 event PenInputPanelInputFailedEventHandler^ InputFailed {
    void add (PenInputPanelInputFailedEventHandler^ value);
    void remove (PenInputPanelInputFailedEventHandler^ value);
}
/** @event */
public void add_InputFailed (PenInputPanelInputFailedEventHandler value)
/** @event */
public void remove_InputFailed (PenInputPanelInputFailedEventHandler value)
JScript では、イベントは使用できません。

解説

イベント ハンドラは、このイベントについてのデータを格納している PenInputPanelInputFailedEventArgs 型の引数を受け取ります。

InputFailed イベントは、ユーザー入力が結合されたコントロールに挿入される前にフォーカスが変化した場合に発生します。たとえば、ユーザーが手書きパッドにインクを入力し、認識エンジンが完了する前に別のエディット コントロールをタップした場合、このイベントが発生します。

このイベントに渡されたウィンドウ ハンドルを使用することにより、このイベントが発生したときにテキストの手動入力を選択できます。

ms567738.alert_caution(ja-jp,VS.90).gif重要 :

Microsoft® Windows® XP Tablet PC Edition 2005 を使用すると、InputFailed イベントは適用されなくなります。テキストは、常にフォーカスが変化する前に挿入されます。

ms567738.alert_security(ja-jp,VS.90).gifセキュリティに関するメモ :

部分信頼で使用している場合、このイベントには PenInputPanel により必要とされるアクセス許可に加えて、SecurityPermissionFlag.AllFlags アクセス許可が必要です。「Security and Trust」を参照してください。

この C# の例では、2 つの PenInputPanel オブジェクト thePenInputPanel1 および thePenInputPanel2 を作成し、それらを TextBox コントロール textBox1 および textBox2 に結合します。この例では、PenInputPanelInputFailedEventHandler、InputFailed_Event を各 PenInputPanel オブジェクトに追加します。イベント ハンドラでは、フォーカスが変化した場合、その Text プロパティを設定することにより、テキストが前の TextBox コントロールで設定されます。

//...

// Declare PenInputPanel objects
PenInputPanel thePenInputPanel1;
PenInputPanel thePenInputPanel2;

public Form1()
{
    // Required for Windows Form Designer support
    InitializeComponent();

    // Create, and attach new PenInputPanels to a TextBox controls.
    thePenInputPanel1 = new PenInputPanel(textBox1);
    thePenInputPanel2 = new PenInputPanel(textBox2);

    // Add an InputFailed event handler to each PenInputPanel
    thePenInputPanel1.InputFailed +=
        new PenInputPanelInputFailedEventHandler(InputFailed_Event);

    thePenInputPanel2.InputFailed +=
        new PenInputPanelInputFailedEventHandler(InputFailed_Event);
}

//...

public void InputFailed_Event(object sender,
PenInputPanelInputFailedEventArgs e)
{
    // Make sure the object that generated
    // the event is a PenInputPanel object
    if (sender is PenInputPanel)
    {
        PenInputPanel theSenderPanel = (PenInputPanel)sender;

        // Set the text in the previous control
        theSenderPanel.AttachedEditControl.Text += e.Text;
    }
}

この Microsoft Visual Basic® .NET の例では、2 つの PenInputPanel オブジェクト thePenInputPanel1 および thePenInputPanel2 を作成し、それらを TextBox コントロール textBox1 および textBox2 に結合します。この例では、PenInputPanelInputFailedEventHandler、InputFailed_Event を各 PenInputPanel オブジェクトに追加します。イベント ハンドラでは、フォーカスが変化した場合、その Text プロパティを設定することにより、テキストが前の TextBox コントロールで設定されます。

'...

' Declare the PenInputPanel objects
Dim thePenInputPanel1 As PenInputPanel
Dim thePenInputPanel2 As PenInputPanel

Public Sub New()
    MyBase.New()

    'This call is required by the Windows Form Designer.
    InitializeComponent()

    ' Create and attach new PenInputPanels to a TextBox controls.
    thePenInputPanel1 = New PenInputPanel(TextBox1)
    thePenInputPanel2 = New PenInputPanel(TextBox2)

    ' Add an InputFailed event handler to each PenInputPanel
    AddHandler thePenInputPanel1.InputFailed, AddressOf InputFailed_Event
    AddHandler thePenInputPanel2.InputFailed, AddressOf InputFailed_Event
End Sub 'New

'...

Public Sub InputFailed_Event(ByVal sender As Object, ByVal e As _
                             PenInputPanelInputFailedEventArgs)
    ' Make sure the object that generated
    ' the event is a PenInputPanel object
    If TypeOf sender Is PenInputPanel Then
        Dim thePenInputPanel As PenInputPanel = CType(sender, PenInputPanel)

        ' Set the text in the previous control
        thePenInputPanel.AttachedEditControl.Text += e.Text
    End If
End Sub 'InputFailed_Event

プラットフォーム

Windows Vista

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 3.0

参照

参照

PenInputPanel クラス

PenInputPanel メンバ

Microsoft.Ink 名前空間

PenInputPanel.OnInputFailed