SetDocumentUserText
SetDocumentUserTextコマンドは、Rhino .3dmファイルにテキスト情報を付加します。この情報は、キー/値形式に格納されます。情報を取り出すには、GetDocumentUserTextコマンドを使用します。
この情報は、.NETプラグインやVisualBasicスクリプトを使用しても付加できます。この情報は、.NETプラグインやVisualBasicのスクリプトで簡単にアクセス可能です。
ファイルにユーザーテキストキーを追加するには
- キーをタイプします。
- 値をタイプします。
ファイルに非表示のユーザーテキストキーを追加するには
- キーを最初に「.」（ピリオド）を付けてタイプします。
- 値をタイプします。
メモ: 非表示のキーは、ドキュメントのプロパティ > ドキュメントユーザーテキストとドキュメントユーザーテキストパネルには表示されません。
ファイルからユーザーテキストキーを削除するには
- 既存のキーをタイプします。
- ""（2つの二重引用符）を値としてタイプします。
GetDocumentUserTextコマンドは、SetDocumentUserTextコマンドでアタッチされたテキスト情報を取り出します。この情報は、.NETプラグインやVisualBasicスクリプトを使用しても取り出せます。
DocumentTextコマンドは、ドキュメントのユーザーテキストを管理するドキュメントユーザーテキストパネルを開きます。
ドキュメントユーザーテキストパネル
検索
検索ボックスに入力すると、タイプされたテキストをキーまたは値に含むユーザーテキストのみが表示されます。
キー
ユーザーテキストキーの名前です。
値
ユーザーテキストキーの値です。
例 | |
|---|
キー | 値 |
|---|
パーツ名 | X-Joint |
パーツ番号 | XJT-20-584 |
仕入先 | Krypton Metals, Inc. |
マテリアル | チタン |
重量(kg) | 20 |
参照: Rhinoでの命名規則
アイコンは、キーがテキストフィールド関数によって駆動されていることを示します。
- テキストフィールドを編集するには、 アイコンをダブルクリックします。
キー | 値 | |
Number | 5 | |
Area | 20 |
|
ツールバー
新規作成
3dmファイルにユーザーテキストキーを追加します。非表示のキーを追加するには、キーの最初に「.」（ピリオド）を付けます。
非表示のキーは、ドキュメントのプロパティ > ドキュメントユーザーテキストとドキュメントユーザーテキストパネルには表示されません。
テキストフィールド
現在のドキュメントまたはオブジェクトから情報を取り出します。
削除
3dmファイルから選択されたユーザーテキストキーを削除します。
非表示のキーを削除するには、SetDocumentUserTextコマンドを使用してください。
インポート
.3dm、.csvまたは.txtファイルから現在の3dmファイルにユーザーテキストキーを読み込みます。
エクスポート
現在の3dmファイルのユーザーテキストキーを.csvまたは.txtファイルに保存します。
右クリックコンテクストメニュー
キーと値をコピー
選択されたキーと値をクリップボードにコピーします。
キーと値をペースト
値とキーをクリップボードからペーストします。
キーと値をすべてのレイアウトにペースト
クリップボードに格納されているキーと値をそれぞれのレイアウトにペーストします。
- ユーザーテキストは、オブジェクト、レイアウト、ドキュメントのプロパティ間でコピー、ペーストすることができます。
- 属性ユーザーテキストは、ドキュメントユーザーテキストやレイアウトユーザーテキストに<キー>:<オブジェクト名>|<値>の形式でペーストされます。オブジェクトに名前がない場合、<オブジェクト名>はオブジェクトのGUIDで置き換えられます。
- キーと値をすべてのレイアウトにペーストは、既存のキーの値をオーバーライドしません。
