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 で提供されるコンポーネント/コントロールは以下のとおりです。
BalloonTip(バルーンチップコンポーネント)
Calculator(電卓コントロール)
Calendar(カレンダーコントロール)
Container(コンテナコントロール)
FunctionKey(ファンクションキーコントロール)
KeyLock(キーロックコンポーネント)
InputMan のファンクションキーコントロールは、PlusPak のクラシックファンクションキーコントロール(GcClassicFunctionKey)に移行されます。
InputMan の旧バージョンで作成されたプロジェクトを PlusPak の 12.0J で使用するためには、移行ツールによる移行作業が必要です。
上記の PlusPak で提供されるコントロールのみを利用しているプロジェクト
PlusPak の移行ツールのみを実行します。
InputMan で提供されるコントロールも含んでいるプロジェクト
PlusPak の移行ツールの他に InputMan の移行ツールを実行する必要があります。
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 のメンバーに変換されます。
CalculatorShortcutCollection
EditButtons
MathButtons
MemoryButtons
MemoryStatus
NumericButtons
ResetButtons
Output
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 からの移行にあたっては下記の制限事項や注意点があります。
カレンダーコントロールの FocusDate、MaxDate および MinDate など DateTimeEx 構造体の値を設定するプロパティでは、PlusPak や InputMan の移行ツールでは移行できない場合があります。ビルドエラーが発生した場合には、設定値を GrapeCity.Win.Calendar.DateTimeEx クラスに変更する必要があります。
' 変更前 'Calendar1.FocusDate = New GrapeCity.Win.Input.DateTimeEx(New Date(2000, 4, 1, 0, 0, 0, 0)) ' InputManの移行ツールを実行した場合 'Calendar1.FocusDate = New GrapeCity.Win.Input.Interop.DateTimeEx(New Date(2000, 4, 1, 0, 0, 0, 0)) ' 変更後 Calendar1.FocusDate = New GrapeCity.Win.Calendar.DateTimeEx(New Date(2000, 4, 1, 0, 0, 0, 0))
// 変更前 //calendar1.FocusDate = new GrapeCity.Win.Input.DateTimeEx(new DateTime(2000, 4, 1, 0, 0, 0, 0)); // InputManの移行ツールを実行した場合 //calendar1.FocusDate = new GrapeCity.Win.Input.Interop.DateTimeEx(new DateTime(2000, 4, 1, 0, 0, 0, 0)); // 変更後 calendar1.FocusDate = new GrapeCity.Win.Calendar.DateTimeEx(new DateTime(2000, 4, 1, 0, 0, 0, 0));
BalloonTipInfo の構造体で一部移行できないものがあります。PlusPak の製品ヘルプにあるリファレンスを参照して手動で修正してください。
PlusPak の旧バージョンの移行ツールでプロジェクトを移行した場合に、以下のデザインアセンブリが参照設定に追加されることがあります。参照設定にこれらのデザインアセンブリは不要であるため、参照に設定されている場合には手動で削除してください。
GrapeCity.Win.PlusPak.Calendar.Design.v110
GrapeCity.Win.FunctionKey.Design.v110