IMathInputControl

インク入力を解釈して数式として出力するためのメソッドを公開します。

コントロールを表示します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

Math Input Control が表示されていない場合に表示します。コントロールが既に表示されている場合は、コントロールを z オーダーの最前面に移動します。 SetPosition が呼び出されていない場合、Show はコントロールを画面の左上隅 (画面座標で (0, 0)) に表示します。 コントロールの幅と高さは最小値になります。

例

    HRESULT hr = CoInitialize(NULL);
    hr = g_spMIC.CoCreateInstance(CLSID_MathInputControl);
    hr = g_spMIC->EnableExtendedButtons(VARIANT_TRUE);
    hr = g_spMIC->Show();  
    

コントロールを非表示にします。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

コントロールが表示されているかどうかを判断します。

このメソッドは HRESULT を返します。有効な値には次の表の値が含まれますが、これらに限定されません。

コントロールの位置とサイズを取得します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

このメソッドは、コントロールが表示されていない場合でもコントロールのサイズと位置を返します。

コントロールの作成直後にこのメソッドを呼び出した場合は、コントロールの最小の幅と高さを返します。

コントロールの位置とサイズを変更します。

このメソッドは HRESULT を返します。有効な値には次の表の値が含まれますが、これらに限定されません。

このメソッドは、コントロールの表示状態にかかわらず呼び出すことができます。

パラメーターが有効でない場合でも、このメソッドは成功します。矩形がコントロールの最大許容サイズ (デスクトップウィンドウ) より大きい場合は、代わりに可能な最大サイズが使用されます。矩形がコントロールの最小サイズより小さい場合、またはインクと結果プレビューを保持できないほど小さい場合は、代わりに可能な最小サイズが使用されます。

このメソッドが S_FALSE を返した場合、GetPosition メソッドはコントロールの実際のサイズ情報を返します。

コントロールからすべてのインクを消去します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

ボタンまたは背景をカスタム描画するかどうかを設定します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

カスタム描画が有効な場合、ボタンまたは背景は少なくとも部分的に (場合によっては完全に) コンテナーによって描画されます。

ウィンドウの作成時にコントロールのキャプションとして使用される文字列を変更します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

インクを処理し、認識を実行します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

このメソッドは、コントロールが表示されている場合にのみ動作します。 インクがコントロールの現在のサイズを超え、かつ自動拡大が有効になっている場合、コントロールは入力に合わせて領域を確保しようとします。十分な領域を確保できない場合、インクは利用可能な最大サイズに収まるように比例して縮小されます。

このコントロールを所有するウィンドウを変更します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

Math Input Control は、常にそれを所有するウィンドウの前面に表示されます。

拡張されたコントロールボタンのセットを表示するかどうかを設定します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

既定では基本ボタンセットが表示されます。

基本ボタンセットには、Clear、Erase、Insert、Select and Correct、Write の各ボタンが含まれます。拡張ボタンセットには、基本セットに加えて Redo ボタンと Undo ボタンが含まれます。

次の画像は、拡張ボタンを有効にした Math Input Control を示しています。

例

    hr = g_spMIC->EnableExtendedButtons(VARIANT_TRUE);
  

プレビュー領域の高さをピクセル単位で取得します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

コントロールのサイズを手動で変更すると、結果プレビュー領域の高さに影響する場合があります。

プレビュー領域の高さをピクセル単位で変更します。

このメソッドは HRESULT を返します。有効な値には次の表の値が含まれますが、これらに限定されません。

プレビュー領域には、コントロールの現在の高さに応じてあらかじめ定義された最小サイズと最大サイズがあります。 このメソッドが S_FALSE を返した場合、GetPreviewHeight メソッドはコントロールの実際のサイズ情報を返します。

次の画像は、既定のプレビュー高さの Math Input Control を示しています。

例

    CComPtr<IMathInputControl> g_spMIC; // Math Input Control
        
    // プレビューの高さを設定します
    // 注: 先にコントロールを初期化しておく必要があります
    void CMath_Input_Control_testDlg::OnBnClickedSetPreviewAreaSize()
    {
      LONG height = 200;
      HRESULT hr = S_OK;
      hr = g_spMIC->SetPreviewHeight(height);
    }          
        

コントロールの現在の範囲を超えて入力が行われたときに、コントロールを自動的に拡大するかどうかを設定します。

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

自動拡大は既定で有効になっています。

認識エンジンが受け付けるカスタム数学関数の一覧に、新しい関数名の定義を追加します。

このメソッドは HRESULT を返します。有効な値には次の表の値が含まれますが、これらに限定されません。

この関数は、既定の辞書に存在しないカスタム数学関数を追加するために使用します。関数が関数辞書に追加されると、認識エンジンはその関数を読み取れるようになります。ただし、カスタム関数名は、筆記体では単語全体としてではなく 1 文字ずつしか認識されない場合があります。

認識エンジンが受け付けるカスタム数学関数の一覧から、関数名の定義を削除します。

このメソッドは HRESULT を返します。有効な値には次の表の値が含まれますが、これらに限定されません。

Math Input Control を起動するためのホバーターゲットに使用するアイコンを取得します。

このメソッドは HRESULT を返します。返される可能性のあるコードには次の表の値が含まれますが、これらに限定されません。

ホバーターゲットを実装する場合は、このアイコンを使用することを強く推奨します。 アイコンは .ico 形式で返され、システムの DPI (dots per inch) 設定に一致します。

アイコンは、幅と高さが固定された 32 ビット画像として提供されます。 96 DPI では、値は Width = 63、Height = 49 です。 その他の DPI では、これらの値はそれに応じて変更されます。 たとえば 144 DPI のシステムでは、Width = 63 * 144 / 96、Height = 49 *144 / 96 となります。 ホバーアイコンを取得したアプリケーションは、アイコンリソースを解放する責任があります。

例

CComPtr <IMathInputControl> g_spMIC; // Math Input Control

BOOL TestDlg::OnInitDialog(){
    
    HRESULT hr = CoInitialize(NULL);
    hr = g_spMIC.CoCreateInstance(CLSID_MathInputControl);

    CComPtr<IPictureDisp> hoverImage;
    CComPtr<IPicture> pictureHoverImage;  

    g_spMIC->GetHoverIcon(&hoverImage); 

    hoverImage.QueryInterface(&pictureHoverImage);

    short type;
    pictureHoverImage->get_Type(&type);
    
    if (type == PICTYPE_ICON){
        OLE_HANDLE oleHandle;
        hr = pictureHoverImage->get_Handle(&oleHandle);        

        this->SetIcon((HICON)oleHandle, true);
    }    
    
    return TRUE;
}