移行ツールの機能

移行ツールは,指导の无花果ファイルを読み取り,等価の应用设计师のコンポーネントとレイアウトをMLAPPファイル内に自動生成することによって,アプリの変換に役立ちます。指导のコールバックコードとその他のユーザー定義関数は,MLAPPファイルにコピーされます。この半自動コード変換では移行レポートも作成され,必要とされる手動のコード更新に関するアクションが提案されます。このツールの機能の一部を以下の表に示します。

コールバックコード

指导スタイルのコールバックコードをアプリの应用程序UI设计师のコンポーネントに対応させるために,移行ツールはconvertToGUIDECallbackArgumentsという関数を使用します。この関数は,软件设计师のコールバック引数を,コードに必要な指导スタイルのコールバック引数に変換します。関数convertToGUIDECallbackArgumentsは,移行された各コールバック関数の先頭に追加されます。この関数は应用设计师のコールバック引数应用程序および事件を取り,指导スタイルのコールバック引数hObject、eventdataおよび处理を返します。以下に例を示します。

hObjectは,コールバックの実行対象のオブジェクトのハンドルです。指导アプリのコンポーネントがUIControlオブジェクトまたはButtonGroupオブジェクトであった場合,hObjectはUIControlPropertiesConverterオブジェクトまたはButtonGroupPropertiesConverterオブジェクトへのハンドルです。これらのオブジェクトは,指导スタイルのコードが应用设计师のコールバック関数内で機能するように作成されています。

通常、eventdataは空ですが,コールバックイベントに関する特定の情報を格納する構造体にすることもできます。

处理は,“标签”プロパティの値セットのある,UI图の移行済みの子コンポーネントを格納する構造体です。指导アプリでUIControlオブジェクトであった子コンポーネントは,移行後のアプリでUIControlPropertiesConverterオブジェクトになります。同様に子ButtonGroupオブジェクトは,移行後のアプリでButtonGroupPropertiesConverterオブジェクトになります。

UIControlPropertiesConverterオブジェクトおよびButtonGroupPropertiesConverterオブジェクトは,指导スタイルのコードと应用设计师のコンポーネントおよびコールバックとの間でアダプターのように機能します。UIControlPropertiesConverterオブジェクトは,指导アプリでUIControlオブジェクトであったコンポーネントごとに作成されます。これらのコンバーターオブジェクトは,移行したアプリ内で应用程序UI设计师のコンポーネントに関連付けられます。コンバーターオブジェクトには,指导アプリにあった元のUIControlと同じプロパティおよび値がありますが,それらは関連付けられている应用程序UI设计师のコンポーネントに適用されます。

同様に,指导のButtonGroupオブジェクトについては,で程序设计师ButtonGroupPropertiesConverterオブジェクトが作成されます。このオブジェクトを使用すると,SelectedObjectプロパティをUIControlPropertiesConverterオブジェクトに設定できます。これにより,ボタン グループのSelectionChangedFcnコールバックロジックが機能します。

特別な考慮事項

場合によっては,アプリの移行の前後に特別な手順が必要です。次の表に,特別な手順や手動でのコード更新が必要となる一般的なシナリオとコーディングパターンを示します。この表は,包括的なリストを意図していません。

函数out = MyGUIDEApp(varargin) app = MyMigratedApp(varargin{:});= app.UIFigure;结束

指导アプリで,actxcontrolなどの関数を使用してサードパーティコンポーネントが統合されている場合は,使用Java和ActiveX的MATLAB应用程序推荐を参照してください。

新規機能の追加または应用设计师のコードスタイルを完全採用するための補足情報

程序设计师と指导では,コードの構造,コールバックの構文,そしてUIコンポーネントへのアクセスとデータ共有のための手法に違いがあります。移行後のアプリに应用设计师の新しい機能を追加する場合,または应用设计师のコードのスタイルと規則を使用するようにアプリを更新する場合に,これらの違いを理解していると役立ちます。次の表は,これらの違いの一部をまとめています。