PlusPak for Windows Forms 12.0J 移行ガイド > 旧バージョンからの移行 > TabPlus for .NET からの移行 |
ここでは、TabPlus for .NET 1.0J/2.0J からの移行について説明します。
PlusPak では TabPlus のコントロールと同じ名前空間は提供されていませんが、TabPlus との互換性は保持されています。TabPlus の参照情報や名前空間を PlusPak のものに書き換えることで、12.0J でも TabPlus のコントロールと同等の機能を使用することが可能です。
TabPlus の 1.0J/2.0J で作成されたプロジェクトを PlusPak の 12.0J で使用するためには、移行ツールによる移行作業が必要です。具体的な手順については「移行ツールの使い方」を参照してください。
移行ツールによって *.vbproj または *.csproj に含まれるアセンブリの参照設定は次のように変更されます。
変更前 | 変更後 |
---|---|
GrapeCity.Win.TabPlus.v10, Version=1.0.2005.609, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243 |
GrapeCity.Win.TabPlus.v20, Version=2.0.2006.515, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | |
(なし) | GrapeCity.Framework.PlusPak.v44, Version=4.4.48XX.2017, Culture=neutral, PublicKeyToken=fdd90f5c44b73170 |
Version(yyyy.mmdd および XX の部分)は、製品のリリース時期によって変化します。 |
移行ツールによって licenses.licx に含まれるコントロールのライセンス情報は次のように変更されます。
変更前 | 変更後 |
---|---|
拡張パネルコントロール | |
GrapeCity.Win.TabPlus.GCContainer, GrapeCity.Win.TabPlus.v20, Version=2.0.2006.515, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | GrapeCity.Win.Containers.GcContainer, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243 |
拡張フローレイアウトパネルコントロール | |
GrapeCity.Win.TabPlus.GCFlowLayoutContainer, GrapeCity.Win.TabPlus.v20, Version=2.0.2006.515, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | GrapeCity.Win.Containers.GcFlowLayoutContainer, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243 |
拡張ラベルコントロール | |
GrapeCity.Win.TabPlus.GCLabel, GrapeCity.Win.TabPlus.v10, Version=1.0.2005.609, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | GrapeCity.Win.Buttons.GcLabel, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243 |
GrapeCity.Win.TabPlus.GCLabel, GrapeCity.Win.TabPlus.v20, Version=2.0.2006.515, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | |
MDIタブコントロール | |
GrapeCity.Win.TabPlus.GCMdiTabControl, GrapeCity.Win.TabPlus.v20, Version=2.0.2006.515, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | GrapeCity.Win.Containers.GcMdiTabControl, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243 |
タブコントロール | |
GrapeCity.Win.TabPlus.GCTabControl, GrapeCity.Win.TabPlus.v10, Version=1.0.2005.609, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | GrapeCity.Win.Containers.GcTabControl, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243 |
GrapeCity.Win.TabPlus.GCTabControl, GrapeCity.Win.TabPlus.v20, Version=2.0.2006.515, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | |
GrapeCity.Win.TabPlus.GCTabPage, GrapeCity.Win.TabPlus.v10, Version=1.0.2005.609, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 | GrapeCity.Win.Containers.GcTabPage, GrapeCity.Win.PlusPak.v120, Version=12.0.48XX.2017, Culture=neutral, PublicKeyToken=63a9ba12b6923243 |
GrapeCity.Win.TabPlus.GCTabPage, GrapeCity.Win.TabPlus.v20, Version=2.0.2006.515, Culture=neutral, PublicKeyToken=572eb5b5bcc2c3b6 |
Version(yyyy.mmdd および XX の部分)は、製品のリリース時期によって変化します。 |
TabPlus のコントロールのクラスは、PlusPak では次の名前空間を利用します。
なお、拡張ラベルコントロール以外の関連クラスは、基本的に GrapeCity.Win.Containers 名前空間に変更されました。
TabPlus | PlusPak |
---|---|
拡張パネルコントロール | |
GrapeCity.Win.TabPlus.GCContainer | GrapeCity.Win.Containers.GcContainer |
拡張フローレイアウトパネルコントロール | |
GrapeCity.Win.TabPlus.GCFlowLayoutContainer | GrapeCity.Win.Containers.GcFlowLayoutContainer |
拡張ラベルコントロール | |
GrapeCity.Win.TabPlus.GCLabel | GrapeCity.Win.Buttons.GcLabel |
MDIタブコントロール | |
GrapeCity.Win.TabPlus.GCMdiTabControl | GrapeCity.Win.Containers.GcMdiTabControl |
タブコントロール | |
GrapeCity.Win.TabPlus.GCTabControl | GrapeCity.Win.Containers.GcTabControl |
GrapeCity.Win.TabPlus.GCTabPage | GrapeCity.Win.Containers.GcTabPage |
下記の汎用クラス、構造体、列挙体は新しい名前空間に変更されました。
TabPlus | PlusPak |
---|---|
GrapeCity.Win.TabPlus.XXX | GrapeCity.Win.Common.XXX |
Bevel EllipsisMode GradientEffect GradientDirection GradientStyle ImageAlign Margins PatternEffect PatternStyle TextEffect TextHAlign TextOrientation TextVAlign TextWrapMode |
TabPlus の以下のメンバー名は PlusPak で変更されました。
TabPlus | PlusPak |
---|---|
GrapeCity.Win.TabPlus.GCLabel.Margins | GrapeCity.Win.Buttons.GcLabel.Paddings |
PlusPak の一部のコントロールでは Margins プロパティが提供されているため、拡張ラベルコントロールの Margins プロパティは移行ツールでは変更されません。Margins プロパティは手動で Padding プロパティに変更する必要があります。また、名前空間は移行ツールで GrapeCity.Win.TabPlus.Margin から GrapeCity.Win.Common.Margins に変更されますが、Padding プロパティに変更した後で設定値を System.Windows.Forms.Padding クラスに変更する必要があります。
' 変更前 'Me.GcLabel1.Margins = New GrapeCity.Win.TabPlus.Margins(10, 5, 10, 5) ' 移行ツール実行後 'Me.GcLabel1.Margins = New GrapeCity.Win.Common.Margins(10, 5, 10, 5) ' 変更後 Me.GcLabel1.Padding = New System.Windows.Forms.Padding(10, 5, 10, 5)
// 変更前 //this.gcLabel1.Margins = new GrapeCity.Win.TabPlus.Margins(10, 5, 10, 5); // 移行ツール実行後 //this.gcLabel1.Margins = new GrapeCity.Win.Common.Margins(10, 5, 10, 5); // 変更後 this.gcLabel1.Padding = new System.Windows.Forms.Padding(10, 5, 10, 5);
TabPlus からの移行にあたっては下記の制限事項や注意点があります。
設計時に CommandIcons に画像を指定した場合、その情報はリソースファイル(.resx)にシリアル化して格納されるため移行後にエラーが発生します。エラーを回避するには、リソースファイルを開いて該当箇所をいったん削除してから設定し直してください。