MESCIUS 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 からの移行にあたっては下記の制限事項や注意点があります。

関連トピック

 

 


© MESCIUS inc. All rights reserved.