メインコンテンツ

move

出荷時の設定またはグループの移動あるいは名前の変更を記録

説明

move(upgrader,source,destination) は、出荷時の設定ツリーにおける出荷時の設定または設定グループの移動を記録します。関数 move を使用して、出荷時の設定またはグループの名前の変更を記録することもできます。ツールボックスの各バージョンについて、出荷時の設定ツリーへの変更を記録することにより、ユーザーがツールボックスの新しいバージョンにアップグレードするときに、設定の下位互換性の問題を確実に回避できるようになります。

すべて折りたたむ

matlab.settings.SettingsFileUpgrader オブジェクトを作成し、ツールボックスの 2 番目のバージョンにおける設定グループの移動を記録します。

mytoolbox の Version 2matlab.settings.SettingsFileUpgrader オブジェクトを作成します。

upgrader = matlab.settings.SettingsFileUpgrader('Version2');

設定グループ fontsmytoolbox 出荷時の設定グループから mytoolbox.mysettings グループへの移動を記録します。

move(upgrader,'mytoolbox.fonts','mytoolbox.mysettings.fonts');

matlab.settings.SettingsFileUpgrader オブジェクトを作成し、ツールボックスの 2 番目のバージョンにおける設定の名前の変更を記録します。

mytoolbox の Version 2matlab.settings.SettingsFileUpgrader オブジェクトを作成します。

upgrader = matlab.settings.SettingsFileUpgrader('Version2');

設定の名前 MySettingMyUpdatedSetting に変更したことと、その設定を mytoolbox グループから mytoolbox.mysettings グループに移動したことを記録します。

move(upgrader,'mytoolbox.MySetting','mytoolbox.mysettings.MyUpdatedSetting');

入力引数

すべて折りたたむ

設定ファイル アップグレーダー。matlab.settings.SettingsFileUpgrader オブジェクトとして指定します。

設定または設定グループのソース パス。文字ベクトルまたは string として指定します。設定またはグループのソースの絶対パスを指定します。これは、ツールボックスの出荷時の設定グループから開始し、設定またはグループの名前を含めます。

例: move(upgrader,'mytoolbox.MySetting','mytoolbox.MyUpdatedSetting');

設定または設定グループの保存先のパス。文字ベクトルまたは string スカラーとして指定します。設定またはグループの保存先の絶対パスを指定します。これは、ツールボックスの出荷時の設定グループから開始し、設定またはグループの名前を含めます。

例: move(upgrader,'mytoolbox.MySetting','mytoolbox.MyUpdatedSetting');

バージョン履歴

R2019b で導入