作成日: 2016/03/02 最終更新日: 2016/03/02
文書種別
使用方法
詳細
C1TextBoxコントロール、およびC1Input.GrapeCity.EditorsのReadingStringOutputクラスを用いて、漢字のフリガナを取得することができます。
ReadingStringOutputは、フリガナの出力動作を制御するために用意されたクラスです。最初にこのクラスのインスタンスを作成し、そのTargetプロパティを用いて、出力されるフリガナを受け取るターゲットコントロール※(例:C1TextBox1)を指定します。またOutputModeプロパティで、フリガナの挿入位置(追記/上書き)を指定します。
※ターゲットコントロールは、「Text」または「Value」という名前のパブリックプロパティを持ち、さらに、1 つの文字列型プロパティが有効である必要があります。
次に、2番目のC1TextBoxコントロール(例:C1TextBox2)のImeSetReadingStringOutputメソッドを使用して、前述のReadingStringOutPutのインスタンスをこのC1TextBoxコントロールに関連付けます。
以上により、C1TextBox2に漢字を入力するとフリガナが生成され、ターゲットに指定したC1TextBox1に表示されます。
なおこのとき、C1TextBox2コントロールのImeSetKanaModeメソッドを用いて、フリガナをひらがな/全角カタカナ/半角カタカナのいずれの形式で出力するかを指定することができます。
フォームに2個のC1TextBoxコントロールを貼り付け、以下のコードを記載して、動作をご確認ください。
◎サンプルコード(VB)
◎サンプルコード(C#)
【注記】
フリガナ取得機能は、.NET Framewok 4.0用コントロール(C1.Win.C1Input.4.dll)のみの機能です。.NET Framewok 2.0用コントロール(C1.Win.C1Input.2.dll)ではご利用いただけません。
ReadingStringOutputは、フリガナの出力動作を制御するために用意されたクラスです。最初にこのクラスのインスタンスを作成し、そのTargetプロパティを用いて、出力されるフリガナを受け取るターゲットコントロール※(例:C1TextBox1)を指定します。またOutputModeプロパティで、フリガナの挿入位置(追記/上書き)を指定します。
※ターゲットコントロールは、「Text」または「Value」という名前のパブリックプロパティを持ち、さらに、1 つの文字列型プロパティが有効である必要があります。
次に、2番目のC1TextBoxコントロール(例:C1TextBox2)のImeSetReadingStringOutputメソッドを使用して、前述のReadingStringOutPutのインスタンスをこのC1TextBoxコントロールに関連付けます。
以上により、C1TextBox2に漢字を入力するとフリガナが生成され、ターゲットに指定したC1TextBox1に表示されます。
なおこのとき、C1TextBox2コントロールのImeSetKanaModeメソッドを用いて、フリガナをひらがな/全角カタカナ/半角カタカナのいずれの形式で出力するかを指定することができます。
フォームに2個のC1TextBoxコントロールを貼り付け、以下のコードを記載して、動作をご確認ください。
◎サンプルコード(VB)
' かなモードを指定します(KatakanaHalfはフリガナを半角カタカナで出力します)。 C1TextBox2.ImeSetKanaMode(KanaMode.KatakanaHalf) ' フリガナの出力動作を制御するための ReadingStringOutput クラスのインスタンスを生成します。 Dim output As New ReadingStringOutput() ' 出力の受け取りに使用されるコントロールを指定します。 output.TargetControl = C1TextBox1 ' 出力モードを指定します(Replaceはフリガナを上書きするモードです)。 output.OutputMode = ReadingStringOutputMode.Replace ' ReadingStringOutput オブジェクトをコントロールに関連付けます。 C1TextBox2.ImeSetReadingStringOutput(output)
◎サンプルコード(C#)
// かなモードを指定します(KatakanaHalfはフリガナを半角カタカナで出力します)。 c1TextBox2.ImeSetKanaMode(KanaMode.KatakanaHalf); // フリガナの出力動作を制御するための ReadingStringOutput クラスのインスタンスを生成します。 ReadingStringOutput output = new ReadingStringOutput(); // 出力の受け取りに使用されるコントロールを指定します。 output.TargetControl = c1TextBox1; // 出力モードを指定します(Replaceはフリガナを上書きするモードです)。 output.OutputMode = ReadingStringOutputMode.Replace; // ReadingStringOutput オブジェクトをコントロールに関連付けます。 c1TextBox2.ImeSetReadingStringOutput(output);
【注記】
フリガナ取得機能は、.NET Framewok 4.0用コントロール(C1.Win.C1Input.4.dll)のみの機能です。.NET Framewok 2.0用コントロール(C1.Win.C1Input.2.dll)ではご利用いただけません。
旧文書番号
81579