広告
新規作成日 2017-04-30
最終更新日
公式ドキュメントの和訳です。
原文「What's New in the Fusion 360 API」
原文作成日:2017-04-14
APIの変更
Changes in the API
- この更新には、コマンドを使用する方法を拡張する、いくつかの小さなコマンド拡張が含まれています。拡張は、doExecute、doExecutePreviewメソッドの追加とCommandオブジェクトのisAutoExecuteプロパティの追加です。今までに、そして、まだ、コマンドを、実行するとき、コマンドを作成するイベントを起動する、既定の動作があります。そして、あなたが、コマンド入力を作成する場合、ダイアログが表示されます。あなたが、入力を作成しない場合、続いて、コマンドが、行うことは何でも、行なう、コマンド実行イベントは、直ちに実行されます。あなたが、入力を作成する場合、続いて、ユーザーは、ダイアログと相互作用することができます。そして、それらが、ダイアログのOKボタンをクリックすると、続いて、実行イベントが、発生します。ダイアログを持っていないコマンドを、すぐに、実行しないことは、できませんでした。isAutoExecuteプロパティは、あなたが、コマンドが、自動的に実行する必要がある場合、ダイアログが無い場合を指定できます。既定では、これは、あなたが、次に、確かめる動作の結果、trueです。しかし、あなたが、それをfalseに設定する場合、続いて、ダイアログが、表示されないにもかかわらず、コマンドは、実行されたままになるでしょう。ダイアログが、表示されていない場合、ユーザーは、コマンドを実行することができません。それで、あなたは、コードを通じて、新しいdoExecuteメソッドを呼び出すことによって、それを行う必要があります。この結果、executeイベントが発生します。そして、コマンドは、一般に、それが実行するものは何でも行うことができます。また、あなたは、doExecutePreviewメソッドを呼び出すことができます。それは、結果として、executePreviewイベントが発生します。それで、コマンド結果のプレビューは、作成することができます。この新しい機能の理由は、あなたが、コマンド・ダイアログのパレットの代わりにできることです。あなたのコマンドが、ユーザーによって実行されるとき、あなたは、commandCreatedイベントで、isAutoExecuteをFalseに設定することができ、そして、パレットを表示することができます。ユーザーが、パレットと相互作用する、そして、あなたが、ユーザーに、現在の結果のプレビューを表示したいとき、あなたは、doExecutePreviewメソッドを呼び出し、そして、パレットで集められている、どんな情報でも渡すことができます。そして、グローバル変数を通して、executePreviewイベントにプレビューするために必要です。コマンドが、完了するとき、あなたは、実行イベントを発生されるために、doExecuteメソッドを呼び出すことができます。そして、コマンドの最終的な作業を実行します。
- StringValueCommandInput上の新しいisValueErrorプロパティは、StringValueCommandInputの現在の値が有効である場合、あなたが、指定できます。あなたが、このプロパティをtrueに設定する場合、Fusionは、ユーザーにそれが無効エントリであることを示すために、赤い入力のテキストを表示します。それをfalseに設定することは、既定の黒い色へ戻し、それを変更します。
- 2つの新しいメソッドは、Viewportブジェクトに追加されました。それらは、viewToScreenとscreenToViewメソッドです。これらは、画面空間とビューポート空間の間で点を変換します。これらは、マウス情報を取得するために、OSで、直接、動作するとき、そして、その次に、Fusionとその逆で、その情報を使用するために、特に役に立ちます。
- また、私たちは、報告された、いくつかの問題を追加して、修正しました。
- kkramer43YNCとcopypastestdの両方は、新しいPythonアドインの作成に関する問題を報告しました。それは、この更新で修正されました。ファイルに関する問題が、ありました。それは、以前のアップデートで提供されました。そして、いくつかの必要とされたファイルが、見つかりませんでした。
- subhransuBAD5Aは、カスタム・コマンドを無効にしようとすることに関する問題を報告しました。それは問題です。そして、この更新で修正されました。
- cadTPLWJは、歯車のいくつかの寸法で、平歯車サンプルに関する問題を報告しました。ルート・フィレットが、正しく作成されていませんでした。それは、この更新で修正されました。
新しいオブジェクト
New Objects
名前 | 解説 |
---|
新しいメソッド、プロパティとイベント
New Methods, Properties and Events
名前 | 解説 |
---|---|
Command.doExecute | 発生すると、executeイベントの結果として生じる、このコマンドを実行します。これは、ユーザーが、コマンド・ダイアログで「OK」ボタンをクリックするのと同じ効果です。そして、コマンド・ダイアログがないときに、最も役に立ちます。(コマンド入力は、作成されません)そして、isAutoExecuteプロパティは、Falseに設定されています。これは、あなたが、コードを通じて、コマンドを実行できます。 |
Command.doExecutePreview | 発生すると、このコマンドのexecutePreviewイベントを引き起こします。これは、コマンド・ダイアログがないときに、最も役に立ちます。(コマンド入力は、作成されません)そして、isAutoExecuteプロパティは、Falseに設定されています。これは、あなたが、コマンド入力を変更に依存する代わりに、作成されたプレビューを強制できます。 |
Command.isAutoExecute | このコマンドが、コマンド入力が、定義されていない場合、自動的に実行されるかどうかに関係なく、取得し、そして、設定します。コマンド入力は作成されている場合、このプロパティの値は、無視され、そして、コマンド・ダイアログは、表示されるでしょう。そして、ユーザーが、『OK』をクリックするとき、コマンドを実行します。コマンド入力が、定義されていない場合、そして、これは、Falseに設定されます。続いて、コマンドは、実行されませんが、実行中のままです。このプロパティの省略時の値は、trueです。そのため、コマンド入力が、定義されていない場合、コマンドは実行します。 |
StringValueCommandInput.isValueError | 表示されている現在の値が、有効かどうかを指定します。StringValueCommandInputは、どんな文字列でも有効です。しかし、あなたは、多くの基準を持っています。文字列は、あなたのアプリケーションで、有効にするために、そのために接続する必要があります。あなたは、検証するために、その入力は、「OK」ボタンが、有効にされるかどうかに関係なく、有効で制御されている、コマンドのvalidateInputsイベントを使用します。そして、また、あなたは、特定の値が正しくないことをユーザーに示すために、特定のStringValueCommandInputsオブジェクト上で、このプロパティを設定することができます。このプロパティが、trueのとき、Fusionは、ユーザーに、問題があることを示すために、テキストの色を赤に変更するでしょう。 |
Viewport.screenToView | 2D画面の点を、同等のビューポート座標に変換します。 |
Viewport.viewToScreen | 2Dのビューポートの点を、同等の画面の座標に変換します。 |
原文ヘルプ作成:
2017年4月14日金曜日午後5時29分
Tweet
広告