MESCIUS PlusPak for Windows Forms 12.0J 移行ガイド
InputMan for .NET からの移行

ここでは、InputMan for .NET 1.0J/2.0J/3.0J/4.0J Windows Forms Ed. からの移行について説明します。

概要

InputMan の旧バージョンの以下のコンポーネント/コントロールは、InputMan for Windows Forms 5.0J 以降は InputMan ではなく PlusPak で提供されます。これらのコンポーネント/コントロールとは互換性は保持されているため、参照情報や名前空間を PlusPak のものに書き換えることで 12.0J で同等の機能を使用することが可能です。

PlusPak で提供されるコンポーネント/コントロール

PlusPak で提供されるコンポーネント/コントロールは以下のとおりです。

InputMan のファンクションキーコントロールは、PlusPak のクラシックファンクションキーコントロール(GcClassicFunctionKey)に移行されます。

移行手順

InputMan の旧バージョンで作成されたプロジェクトを PlusPak の 12.0J で使用するためには、移行ツールによる移行作業が必要です。

PlusPak の移行ツールの手順については「移行ツールの使い方」を参照してください。

なお、InputMan で提供されるコントロールの移行に関する詳細は、InputMan に含まれる「移行ガイド」を参照してください。

アセンブリの置換

移行ツールによって *.vbproj または *.csproj に含まれるアセンブリの参照設定は次のように変更されます。

変更前 変更後
GrapeCity.Win.Input, Version=1.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=dbe4120289f9fd8a InputMan と共有する情報のため変更/削除されません。
GrapeCity.Framework.v12, Version=1.2.yyyy.mmdd, Culture=neutral, PublicKeyToken=dbe4120289f9fd8a
GrapeCity.Win.Input.v20, Version=2.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.v30, Version=3.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.v40, Version=4.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
(なし) GrapeCity.Framework.PlusPak.v44, Version=4.4.48XX.2017, Culture=neutral, PublicKeyToken=fdd90f5c44b73170
(なし) GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
(なし) GrapeCity.Win.PlusPak.Calendar.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
(Calendar コントロールを使用している場合)
(なし) GrapeCity.Win.FunctionKey.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
(FunctionKey コントロールを使用している場合)

Version(yyyy.mmdd および XX の部分)は、製品のリリース時期によって変化します。

ライセンス情報

移行ツールによって licenses.licx に含まれるコントロールのライセンス情報は次のように変更されます。

変更前 変更後
バルーンチップコンポーネント
GrapeCity.Win.Input.BalloonTip, GrapeCity.Win.Input.v40, Version=4.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128 GrapeCity.Win.Components.GcBalloonTip, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
電卓コントロール
GrapeCity.Win.Input.Calculator, GrapeCity.Win.Input, Version=1.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=dbe4120289f9fd8a GrapeCity.Win.Calculations.GcCalculator, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
GrapeCity.Win.Input.Calculator, GrapeCity.Win.Input.v12, Version=1.2.yyyy.mmdd, Culture=neutral, PublicKeyToken=dbe4120289f9fd8a
GrapeCity.Win.Input.Calculator, GrapeCity.Win.Input.v20, Version=2.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.Calculator, GrapeCity.Win.Input.v30, Version=3.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.Calculator, GrapeCity.Win.Input.v40, Version=4.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
カレンダーコントロール
GrapeCity.Win.Input.Calendar, GrapeCity.Win.Input, Version=1.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=dbe4120289f9fd8a GrapeCity.Win.Calendar.GcCalendar, GrapeCity.Win.PlusPak.Calendar.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
GrapeCity.Win.Input.Calendar, GrapeCity.Win.Input.v12, Version=1.2.yyyy.mmdd, Culture=neutral, PublicKeyToken=dbe4120289f9fd8a
GrapeCity.Win.Input.Calendar, GrapeCity.Win.Input.v20, Version=2.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.Calendar, GrapeCity.Win.Input.v30, Version=3.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.Calendar, GrapeCity.Win.Input.v40, Version=4.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
コンテナコントロール
GrapeCity.Win.Input.Container, GrapeCity.Win.Input, Version=1.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=dbe4120289f9fd8a GrapeCity.Win.Containers.GcContainer, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
GrapeCity.Win.Input.Container, GrapeCity.Win.Input.v12, Version=1.2.yyyy.mmdd, Culture=neutral, PublicKeyToken=dbe4120289f9fd8a
GrapeCity.Win.Input.Container, GrapeCity.Win.Input.v20, Version=2.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.Container, GrapeCity.Win.Input.v30, Version=3.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.Container, GrapeCity.Win.Input.v40, Version=4.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
ファンクションキーコントロール
GrapeCity.Win.Input.FunctionKey, GrapeCity.Win.Input.v20, Version=2.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128 GrapeCity.Win.Bars.GcFunctionKey, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
GrapeCity.Win.Input.FunctionKey, GrapeCity.Win.Input.v30, Version=3.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
GrapeCity.Win.Input.FunctionKey, GrapeCity.Win.Input.v40, Version=4.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128
キーロックコンポーネント
GrapeCity.Win.Input.KeyLock, GrapeCity.Win.Input.v30, Version=3.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128 GrapeCity.Win.Components.GcKeyLock, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243
GrapeCity.Win.Input.KeyLock, GrapeCity.Win.Input.v40, Version=4.0.yyyy.mmdd, Culture=neutral, PublicKeyToken=c3bd7c1dccef5128

Version(yyyy.mmdd および XX の部分)は、製品のリリース時期によって変化します。

名前空間の変更

InputMan のコントロールのクラスは、PlusPak では次の名前空間を利用します。

なお、関連クラスはそれぞれ本体クラスと同じ名前空間に変更されました。

InputMan PlusPak
バルーンチップコンポーネント
GrapeCity.Win.Input.BalloonTip GrapeCity.Win.Components.GcBalloonTip
電卓コントロール
GrapeCity.Win.Input.Calculator GrapeCity.Win.Calculations.GcCalculator
カレンダーコントロール
GrapeCity.Win.Input.Calendar GrapeCity.Win.Calendar.GcCalendar
コンテナコントロール
GrapeCity.Win.Input.Container GrapeCity.Win.Containers.GcContainer
ファンクションキーコントロール
GrapeCity.Win.Input.FunctionKey GrapeCity.Win.Bars.GcClassicFunctionKey
キーロックコンポーネント
GrapeCity.Win.Input.KeyLock GrapeCity.Win.Components.GcKeyLock
メンバーの変更

InputMan の以下のメンバー名は PlusPak で変更されました。

InputMan PlusPak
バルーンチップコンポーネント
メソッド GrapeCity.Win.Input.BalloonTip.GetBalloonTipInfo メソッド GrapeCity.Win.Components.GcBalloonTip.GetBalloonTipInformation
メソッド GrapeCity.Win.Input.BalloonTip.SetBalloonTipInfo メソッド GrapeCity.Win.Components.GcBalloonTip.SetBalloonTipInformation
クラス GrapeCity.Win.Input.BalloonTipInfo クラス GrapeCity.Win.Components.BalloonTipInformation
プロパティ GrapeCity.Win.Input.BalloonTipInfo.UseCaptionFont
削除されました。キャプションのフォントに CaptionFont プロパティを使用しない場合は CaptionFont プロパティを null に設定してください。
プロパティ GrapeCity.Win.Input.BalloonTipInfo.UseTextFont
削除されました。テキストのフォントに TextFont プロパティを使用しない場合は TextFon プロパティを null に設定してください。

バルーンチップコンポーネントの対象のメンバーは、移行ツールにより PlusPak のメンバーに変換されます。削除された UseCaptionFont、UseTextFont プロパティについては該当のコードがコメントアウトされます。

InputMan PlusPak
電卓コントロール
クラス GrapeCity.Win.Input.CalculatorShortcutCollection クラス GrapeCity.Win.Components.Calculations.CalculatorButtonMappingCollection
プロパティ GrapeCity.Win.Input.Calculator.Margins プロパティ GrapeCity.Win.Calculations.GcCalculator.Padding
プロパティ GrapeCity.Win.Input.Calculator.Text プロパティ GrapeCity.Win.Calculations.GcCalculator.OutputText
プロパティ GrapeCity.Win.Input.Calculator.TextHAlign プロパティ GrapeCity.Win.Calculations.GcCalculator.OutputTextAlign
プロパティ GrapeCity.Win.Input.Calculator.TextVAlign プロパティ GrapeCity.Win.Calculations.GcCalculator.OutputTextAlign
プロパティ GrapeCity.Win.Input.Calculator.EditButtons プロパティ GrapeCity.Win.Calculations.GcCalculator.Styles.EditButtons
プロパティ GrapeCity.Win.Input.Calculator.MathButtons プロパティ GrapeCity.Win.Calculations.GcCalculator.Styles.MathButtons
プロパティ GrapeCity.Win.Input.Calculator.MemoryButtons プロパティ GrapeCity.Win.Calculations.GcCalculator.Styles.MemoryButtons
プロパティ GrapeCity.Win.Input.Calculator.MemoryStatus プロパティ GrapeCity.Win.Calculations.GcCalculator.Styles.MemoryStatus
プロパティ GrapeCity.Win.Input.Calculator.NumericButtons プロパティ GrapeCity.Win.Calculations.GcCalculator.Styles.NumericButtons
プロパティ GrapeCity.Win.Input.Calculator.ResetButtons プロパティ GrapeCity.Win.Calculations.GcCalculator.Styles.ResetButtons
プロパティ GrapeCity.Win.Input.Calculator.Output プロパティ GrapeCity.Win.Calculations.GcCalculator.Styles.Output
プロパティ GrapeCity.Win.Input.Calculator.Shortcuts プロパティ GrapeCity.Win.Calculations.GcCalculator.ButtonMappings
イベント GrapeCity.Win.Input.Calculator.TextChanged イベント GrapeCity.Win.Calculations.GcCalculator.OutputTextChanged

上記のメンバーのうち、以下のメンバーについては、移行ツールにより PlusPak のメンバーに変換されます。

Margins プロパティは手動で Padding プロパティに変更する必要があります。また、Padding プロパティに変更した後で設定値を System.Windows.Forms.Padding クラスに変更する必要があります。

' 変更前
'Me.Calculator1.Margins = New GrapeCity.Win.Input.Margins(10, 5, 10, 5)
' 変更後
Me.Calculator1.Padding = New System.Windows.Forms.Padding(10, 5, 10, 5)
// 変更前
//this.calculator1.Margins = new GrapeCity.Win.Input.Margins(10, 5, 10, 5);
// 変更後
this.calculator1.Padding = new System.Windows.Forms.Padding(10, 5, 10, 5);

Text プロパティは手動で OutputText プロパティに修正する必要があります。Text プロパティのままでもビルドエラーは発生しませんが正しく動作しません。

' 変更前
'Me.Calculator1.Text = "10000"
' 変更後
Me.Calculator1.OutputText = "10000"
// 変更前
//this.calculator1.Text = "10000";
// 変更後
this.calculator1.OutputText = "10000";

TextHAlign、TextVAlign プロパティは手動で OutputTextAlign プロパティに修正する必要があります。

' 変更前
'Me.Calculator1.TextHAlign = GrapeCity.Win.Input.AlignHorizontal.Center
'Me.Calculator1.TextVAlign = GrapeCity.Win.Input.AlignVertical.Middle
' 変更後
Me.Calculator1.OutputTextAlign = ContentAlignment.MiddleCenter
// 変更前
//this.calculator1.TextHAlign = GrapeCity.Win.Input.AlignHorizontal.Center;
//this.calculator1.TextVAlign = GrapeCity.Win.Input.AlignVertical.Middle;
// 変更後
this.calculator1.OutputTextAlign = ContentAlignment.MiddleCenter;

Shortcuts プロパティは手動で ButtonMappings プロパティに修正する必要があります。

' 変更前
'Dim CalculatorShortcutCollection1 As New GrapeCity.Win.Input.CalculatorShortcutCollection()
'Calculator1.Shortcuts = CalculatorShortcutCollection1
' 変更後
Dim CalculatorShortcutCollection1 As New GrapeCity.Win.Calculations.CalculatorButtonMappingCollection()
Calculator1.ButtonMappings = CalculatorShortcutCollection1
// 変更前
//GrapeCity.Win.Input.CalculatorShortcutCollection calculatorShortcutCollection1 = new GrapeCity.Win.Input.CalculatorShortcutCollection();
//calculator1.Shortcuts = calculatorShortcutCollection1;
// 変更後
GrapeCity.Win.Calculations.CalculatorButtonMappingCollection calculatorShortcutCollection1 = new GrapeCity.Win.Calculations.CalculatorButtonMappingCollection();
calculator1.ButtonMappings = calculatorShortcutCollection1;

TextChanged イベントは手動で OutputTextChanged イベントに修正する必要があります。TextChanged イベントのままでもビルドエラーは発生しませんが正しく動作しません。

' 変更前
'Private Sub Calculator1_TextChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Calculator1.TextChanged
' 変更後
Private Sub Calculator1_OutputTextChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Calculator1.OutputTextChanged
// 変更前
//this.calculator1.TextChanged += new System.EventHandler(this.calculator1_TextChanged);
//private void calculator1_TextChanged(object sender, EventArgs e)
// 変更後
this.calculator1.OutputTextChanged += new System.EventHandler(this.calculator1_OutputTextChanged);
private void calculator1_OutputTextChanged(object sender, EventArgs e)

以下の構造体は引数の順序が変更されました。手動で順序を変更する必要があります。

変更前 変更後
public Margins(int left, int right, int top, int bottom) public Margins(int left, int top, int right, int bottom)
制限事項と注意点

InputMan からの移行にあたっては下記の制限事項や注意点があります。

関連トピック

 

 


© MESCIUS inc. All rights reserved.