MESCIUS InputMan for ASP.NET 10.0J
非推奨メンバ

InputMan for ASP.NET 3.0J以降では、新機能の搭載に伴いInputMan for .NET 2.0J Web Forms Edition以前のバージョンから多くの仕様変更が行われています。また、10.0Jにおいても7.0J以前のバージョンからいくつかの仕様変更が行われています。
そのため、新機能の実装に不要となるメンバが存在しますが、これらのメンバは非推奨(Obsolete)メンバとして、互換性のために残されています。旧バージョンから移行したプロジェクトでこれら非推奨メンバが使用されていても、エラーは発生せずに旧バージョンと同様に動作します。ここでは、旧機能(非推奨メンバ)と新機能の対応表を示します。

  • 非推奨メンバが使用されていると、ビルド時に[警告]が表示されますが、動作上の問題はありません。

8.0J以降で非推奨となったメンバ一覧
描画スタイル

コントロールの描画方法が、クライアント側のOSやブラウザに合わせたスタイルになったため、各コントロールの以下のプロパティが非推奨となり、これらのプロパティの設定も無効となります。

  • ControlEffectプロパティ
  • XPThemeプロパティ
また、これらのプロパティが参照する以下の列挙体も非推奨となりました。
  • GrapeCity.Web.Input.Core.ControlEffect 列挙体
  • GrapeCity.Web.Input.Core.XPTheme 列挙体
ウォーターマーク機能

ウォーターマークが表示できるようになったため、マスク、日付時刻、日付、時刻、数値、コンボの各コントロールから参照される書式設定を行うクラスの一部のプロパティやコンストラクタが非推奨になりました。

MaskFormatクラス

マスクコントロールのFormatプロパティおよび コンボコントロールのFormatプロパティが参照するMaskFormatクラスは以下のメンバが非推奨となりました。

非推奨メンバ 10.0Jでの機能
 NonFocusNull GcMask.Watermarkプロパティが参照するWatermarkBaseクラスのDisplayNullプロパティ
 Null GcMask.Watermarkプロパティが参照するWatermarkBaseクラスのNullプロパティ
 MaskFormat コンストラクタ(String, String, String)  MaskFormat コンストラクタ(String)

DateFormatクラス

日付時刻および日付コントロールのFormatプロパティが参照するDateFormatクラスは以下のメンバが非推奨となりました。

非推奨メンバ 10.0Jでの機能
 EmptyEra GcDateTime.Watermarkプロパティが参照するDateWatermarkクラスのEmptyEraプロパティ
 Null GcDateTime.Watermarkプロパティが参照するDateWatermarkクラスのNullプロパティ
 DateFormat コンストラクタ(String, String, String)  DateFormat コンストラクタ(String)

DateDisplayFormatクラス

日付時刻および日付コントロールのDisplayFormatプロパティが参照するDateDisplayFormatクラスは以下のメンバが非推奨となりました。

非推奨メンバ 10.0Jでの機能
 EmptyEra GcDateTime.Watermarkプロパティが参照するDateWatermarkクラスのDisplayEmptyEraプロパティ
 Null GcDateTime.Watermarkプロパティが参照するDateWatermarkクラスのDisplayNullプロパティ
 DateDisplayFormat コンストラクタ(String, String, String)  DateDisplayFormat コンストラクタ(String)

TimeFormatクラス

時刻コントロールのFormatプロパティが参照するTimeFormatクラスは以下のメンバが非推奨となりました。

非推奨メンバ 10.0Jでの機能
 Null GcTime.Watermarkプロパティが参照するWatermarkBaseクラスのNullプロパティ
 TimeFormat コンストラクタ(String, String)  TimeFormat コンストラクタ(String)

TimeDisplayFormatクラス

時刻コントロールのDisplayFormatプロパティが参照するTimeDisplayFormatクラスは以下のメンバが非推奨となりました。

非推奨メンバ 10.0Jでの機能
 Null GcTime.Watermarkプロパティが参照するWatermarkBaseクラスのDisplayNullプロパティ
 TimeDisplayFormat コンストラクタ(String, String)  TimeDisplayFormat コンストラクタ(String)

NumberFormatクラス

数値コントロールのFormatプロパティが参照するNumberFormatクラスは以下のメンバが非推奨となりました。

非推奨メンバ 10.0Jでの機能
 Null GcNumber.Watermarkプロパティが参照するNumberWatermarkクラスのNullプロパティ
 Zero GcNumber.Watermarkプロパティが参照するNumberWatermarkクラスのZeroプロパティ
 NumberFormat コンストラクタ(String, String, String, String, String, String, String)  NumberFormat コンストラクタ(String, String, String, String, String)

NumberDisplayFormatクラス

数値コントロールのDisplayFormatプロパティが参照するNumberDisplayFormatクラスは以下のメンバが非推奨となりました。

非推奨メンバ 10.0Jでの機能
 DisplayNull GcNumber.Watermarkプロパティが参照するNumberWatermarkクラスのDisplayNullプロパティ
 DisplayZero GcNumber.Watermarkプロパティが参照するNumberWatermarkクラスのDisplayZeroプロパティ
 NumberDisplayFormat コンストラクタ(String, String, String, String, String, String, String)  NumberDisplayFormat コンストラクタ(String, String, String, String, String)
ファンクションキーコントロール

ファンクションキーのスタイルを設定するテンプレート機能が削除されたため、以下のメソッドと関連する列挙体が非推奨になりました。

  • GrapeCity.Web.Input.IMFunctionKey.GcFunctionKey.LoadTemplate メソッド
  • GrapeCity.Web.Input.IMFunctionKey.Templates 列挙体
3.0J以降で非推奨となったメンバ一覧
Shortcutsプロパティ

各コントロールに付与できるショートカット機能は、2.0Jまで各クラスのShortcutsプロパティとして提供されていましたが、 3.0J以降ではショートカットエクステンダとして提供されています。
これにより、下記の各クラスが搭載するShortcutsプロパティおよび電卓コントロールのショートカットキー機能は、ショートカットエクステンダに置き換わります。

コントロール クラス メンバ
テキストコントロール  GrapeCity.Web.Input.IMEdit.GcTextBox  Shortcuts
マスクコントロール  GrapeCity.Web.Input.IMMask.GcMask  Shortcuts
日付時刻コントロール
(日付コントロール)
 GrapeCity.Web.Input.IMDate.GcDateTime  Shortcuts
 GrapeCity.Web.Input.IMDate.DropDownCalendar  Shortcuts
数値コントロール  GrapeCity.Web.Input.IMNumber.GcNumber  Shortcuts
 GrapeCity.Web.Input.IMNumber.DropDownCalculator  Shortcuts
コンボコントロール  GrapeCity.Web.Input.IMCombo.GcComboBox  Shortcuts
リストコントロール  GrapeCity.Web.Input.IMList.GcListBox  Shortcuts
カレンダーコントロール  GrapeCity.Web.Input.IMCalendar.GcCalendar  Shortcuts
電卓コントロール  GrapeCity.Web.Input.IMCalculator.GcCalculator  Shortcuts
 GrapeCity.Web.Input.IMCalculator.CalculatorShortcutCollection 全メンバ
汎用クラス  GrapeCity.Web.Input.Core.ShortcutCollection 全メンバ
コンボコントロール

コンボコントロールのリストボックスでは、画像、内容、説明の3つだけではなく、3.0J以降で無制限のマルチカラムに対応したことで、大きく仕様が変更されました。 各非推奨メンバに対応する新機能は以下のとおりです。

GcComboBoxクラス

非推奨メンバ 10.0Jでの機能
 DefaultImageIndex ListBoxプロパティが参照するListBoxクラスのDefaultImageIndexプロパティ
 DescriptionMember ListBox.Columnsプロパティが参照するListColumnクラスのDataPropertyNameプロパティ
 DescriptionWidth ListBox.Columnsプロパティが参照するListColumnクラスのWidthプロパティ
 DisplayMember ListBox.Columnsプロパティが参照するListColumnクラスのDataPropertyNameプロパティ
 DropDownAlign ListBoxプロパティが参照するListBoxクラスのAlignプロパティ
 DropDownFont ListBoxプロパティが参照するListBoxクラスのFontプロパティ
 ItemHeight ListBoxプロパティが参照するListBoxクラスのItemHeightプロパティ
 ItemTip ListBoxプロパティが参照するListBoxクラスのItemTipプロパティ
 ListBoxStyle ListBoxプロパティが参照するListBoxクラスのShowItemImageプロパティ
 MaxDropDownItems ListBoxプロパティが参照するListBoxクラスのMaxItemsプロパティ
 OverflowTip ListBoxプロパティが参照するListBoxクラスのOverflowTipプロパティ
 ScrollBarMode ListBoxプロパティが参照するListBoxクラスのScrollBarModeプロパティ
 SelectedValue ComboItem[SelectedIndex].SubItem[2].Valueプロパティ
 ShowScrollBar ListBoxプロパティが参照するListBoxクラスのScrollBarsプロパティ
 SortBy ListBoxプロパティが参照するListBoxクラスのSortColumnIndexプロパティ
 SortOrder ListBox.Columnsプロパティが参照するListColumnクラスのSortOrderプロパティ
 StatusBar ListBoxプロパティが参照するListBoxクラスのStatusBarプロパティ
 ValueMember ListBox.Columnsプロパティが参照するListColumnクラスのDataPropertyNameプロパティ
 FindString  FindString
 ResetDescriptionMember 該当なし
 ResetDisplayMember 該当なし
 ResetValueMember 該当なし
 DescriptionMemberChanged 該当なし
 DisplayMemberChanged 該当なし
 SelectedValueChanged 該当なし
 ValueMemberChanged 該当なし

ComboItemクラス

非推奨メンバ 10.0Jでの機能
 Content  Text
 Description SubItemsプロパティが参照するSubItem[ListBox.DescriptionSubItemIndex].Valueプロパティ
 Value SubItemsプロパティが参照するSubItem[2].Valueプロパティ

ComboItemCollectionクラス

非推奨メンバ 10.0Jでの機能
 Add(String, String, String)  Add
 Insert(Int32, String, String, String)  Insert
リストコントロール

2.0Jで追加されたリストコントロールでは、画像、内容、説明の3つだけではなく、3.0J以降で無制限のマルチカラムに対応したことで、大きく仕様が変更されました。各非推奨メンバに対応する新機能は以下のとおりです。

GcListBoxクラス

非推奨メンバ 10.0Jでの機能
 ContentAutoFit Columnsプロパティが参照するListColumnクラスのAutoWidthプロパティ
 ContentHAlign ListItem.SubItemsが参照するSubItemクラスのContentHAlignプロパティ
 ContentVAlign ListItem.SubItemsが参照するSubItemクラスのContentVAlignプロパティ
 ContentWidth Columnsプロパティが参照するListColumnクラスのWidthプロパティ
 DescriptionAutoFit Columnsプロパティが参照するListColumnクラスのAutoWidthプロパティ
 DescriptionHAlign ListItem.SubItemsが参照するSubItemクラスのContentHAlignプロパティ
 DescriptionMember Columnsプロパティが参照するListColumnクラスのDataPropertyNameプロパティ
 DescriptionVAlign ListItem.SubItemsが参照するSubItemクラスのContentVAlignプロパティ
 DescriptionWidth Columnsプロパティが参照するListColumnクラスのWidthプロパティ
 DisplayMember Columnsプロパティが参照するListColumnクラスのDataPropertyNameプロパティ
 ListBoxStyle ShowItemImageプロパティとColumnsプロパティを使用
 ListHeader ListHeaderPaneプロパティとColumnsプロパティが参照するListColumnクラスのHeaderプロパティを使用
 SelectedValue ListItem[SelectedIndex].SubItem[2].Valueプロパティ
 SortBy  SortColumnIndex
 SortOrder Columnsプロパティが参照するListColumnクラスのSortOrderプロパティ
 ValueMember Columnsプロパティが参照するListColumnクラスのDataPropertyNameプロパティ
 FindString  FindString
 ResetDescriptionMember 該当なし
 ResetDisplayMember 該当なし
 ResetValueMember 該当なし
 DescriptionMemberChanged 該当なし
 DisplayMemberChanged 該当なし
 ValueMemberChanged 該当なし

ListHeader

非推奨メンバ 10.0Jでの機能
 AllowResize ColumnHeaderクラスのAllowResizeプロパティ
 BackColor ColumnHeaderクラスのBackColorプロパティ
 Clickable ColumnHeaderクラスのClickableプロパティ
 ContentText ColumnHeaderクラスのTextプロパティ
 DescriptionText ColumnHeaderクラスのTextプロパティ
 Font ListHeaderPaneクラスのFontプロパティ
 Height ListHeaderPaneクラスのHeightプロパティ
 SortIndicatorAlignment ColumnHeaderクラスのSortIndicatorAlignmentプロパティ
 TextHAlign ColumnHeaderクラスのContentHAlignプロパティ
 TextVAlign ColumnHeaderクラスのContentVAlignプロパティ
 Visible ListHeaderPaneクラスのVisibleプロパティ

ListItem

非推奨メンバ 10.0Jでの機能
 Content  Text
 Description SubItemsプロパティが参照するSubItem[List.DescriptionSubItemIndex].Valueプロパティ
 Value SubItemsプロパティが参照するSubItem[2].Valueプロパティ

ListItemCollection

非推奨メンバ 10.0Jでの機能
 Add(String, String, String)  Add
 Insert(Int32, String, String, String)  Insert
列挙体

コンボコントロールおよびリストコントロールの機能拡張により、下記の列挙体が非推奨メンバとなりました。

  • GrapeCity.Web.Input.Core.ListBoxStyle 列挙体
  • GrapeCity.Web.Input.Core.TargetMember 列挙体
関連トピック

 

 


© MESCIUS inc. All rights reserved.