InkEdit.Recognizer プロパティ

2008-10-28

InkEdit コントロールによって使用される Recognizer オブジェクトを取得または設定します。

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

構文

'宣言
<BrowsableAttribute(False)> _
Public Property Recognizer As Recognizer
'使用
Dim instance As InkEdit
Dim value As Recognizer

value = instance.Recognizer

instance.Recognizer = value

[BrowsableAttribute(false)]
public Recognizer Recognizer { get; set; }

[BrowsableAttribute(false)]
public:
property Recognizer^ Recognizer {
    Recognizer^ get ();
    void set (Recognizer^ value);
}

/** @property */
/** @attribute BrowsableAttribute(false) */
public Recognizer get_Recognizer()
/** @property */
/** @attribute BrowsableAttribute(false) */
public  void set_Recognizer(Recognizer value)

public function get Recognizer () : Recognizer
public function set Recognizer (value : Recognizer)

プロパティ値

型 : Microsoft.Ink.Recognizer
InkEdit コントロールによって使用される認識エンジン。

解説

返される既定の認識エンジンは、アクティブな入力ロケールの既定の認識エンジンです。アクティブな入力ロケールを選択するには、[コントロールパネル] の [地域と言語のオプション] の [言語] タブで [詳細] をクリックし、[既定の言語] を選択します。

このプロパティは、実行時にのみ使用できます。

このプロパティを変更するのは、Status プロパティが InkEditStatus 列挙値 Idle を返す場合だけにしてください。

擬似事実が InkEdit コントロールで使用される場合は、Recognizer プロパティの設定後に再適用する必要があります。

例

この例では、Recognizer オブジェクトにスペイン語を認識する機能がある場合、この機能を使用するように InkEdit コントロールの Recognizer プロパティを設定します。

If InkEditStatus.Idle = mInkEdit.Status Then
    Const LCID_Spanish As Integer = &HC0A
    ' get all the Recognizers
    Dim allR As Recognizers = New Recognizers()

    ' check each Recognizer
    For Each R As Recognizer In allR
        ' check each supported language of the Recognizer
        For Each LCID As Integer In R.Languages
            ' if the language == Spanish, change the Recognizer
            If LCID_Spanish = LCID Then
                mInkEdit.Recognizer = R
            End If
        Next
    Next

    ' display the name of the recognizer in the InkEdit control
    mInkEdit.Text = mInkEdit.Recognizer.Name + Environment.NewLine
End If

if (InkEditStatus.Idle == mInkEdit.Status)
{
    const int LCID_Spanish = 0x0C0A;
    // get all the Recognizers
    Recognizers allR = new Recognizers();

    // check each Recognizer
    foreach (Recognizer R in allR)
    {
        // check each supported language of the Recognizer
        foreach (int LCID in R.Languages)
        {
            // if the language == Spanish, change the Recognizer
            if (LCID_Spanish == LCID)
            {
                mInkEdit.Recognizer = R;
            }
        }
    }

    // display the name of the recognizer in the InkEdit control
    mInkEdit.Text = mInkEdit.Recognizer.Name + Environment.NewLine;
}