VP EXPORT TO BLOB
VP EXPORT TO BLOB ( vpAreaName : Text ; paramObj : Object )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| vpAreaName | Text | -> | 4D View Pro フォームオブジェクト名 |
| paramObj | Object | -> | 書き出しのオプション |
説明
VP EXPORT TO BLOB コマンドは、vpAreaName で指定した 4D View Pro エリアの 4D View Pro ドキュメントを、paramObj で指定したとおりに 4D.Blob に書き出します。 エクスポートされた Blob は、コールバックを通して利用可能です。 4D View Pro エリアを Blob でエクスポートおよびインポートすることは高速で、メモリ効率に優れています。 エクスポートされた Blob は、コールバックを通して利用可能です。 4D View Pro エリアを Blob でエクスポートおよびインポートすることは高速で、メモリ効率に優れています。
paramObj には、複数のプロパティを渡せます:
| プロパティ | 型 | 説明 |
|---|---|---|
| formula | 4D.Function | (必須) 書き出しが完了した際に呼び出されるコールバックメソッド名。 (必須) 書き出しが完了した際に呼び出されるコールバックメソッド名。 コールバックメソッド (フォーミュラ) の渡し方 を参照ください。 |
| includeAutoMergedCells | Boolean | 自動的に結合されたセルを含めるかどうか。デフォルトは false。 |
| includeBindingSource | Boolean | バインドされたソースを含めるかどうか。デフォルトは true。 |
| includeCalcModelCache | Boolean | 計算の追加データを含めるか。 計算の追加データを含めるか。 ファイルを開く速さに影響する場合があります。デフォルトは false。 |
| includeEmptyRegionCells | Boolean | 使用されるデータレンジの外側の空白セル (データがない、またはスタイルだけのセル) を含めるかどうか。デフォルトは true。 |
| includeFormulas | Boolean | フォーミュラを含めるかどうか。デフォルトは true。 |
| includeStyles | Boolean | スタイルを含めるかどうか。デフォルトは true。 |
| includeUnusedNames | Boolean | 使用されていないカスタム名を含めるかどうか。デフォルトは true。 |
| saveAsView | Boolean | 書き出される値にフォーマット文字列を適用するかどうか。デフォルトは false。 |
コールバックメソッドでは、以下のパラメーターを使用することができます:
| 引数 | 型 | 説明 | |
|---|---|---|---|
| param1 | text | 4D View Pro オブジェクト名 | |
| param2 | 4D.Blob | エクスポートされた Blob | |
| param3 | object | コマンドの paramObj 引数への参照 | |
| param4 | object | メソッドから返されるステータスメッセージを格納したオブジェクト | |
| .success | boolean | 書き出しに成功した場合は true 、それ以外の場合は false | |
| .errorCode | integer | エラーコード。 | |
| .errorMessage | text | エラーメッセージ。 |
例題
VP EXPORT TO BLOB コマンドは非同期です。 エクスポートの結果を取得するには、コールバックメソッド (この例では VPBlobCallback という名前) を作成する必要があります。 エクスポートの結果を取得するには、コールバックメソッド (この例では VPBlobCallback という名前) を作成する必要があります。
// VPドキュメントをエクスポート
VP EXPORT TO BLOB("ViewProArea"; {formula: Formula(VPBlobCallback)})
// VPBlobCallback メソッド
#DECLARE($area : Text; $data : 4D.Blob; $parameters : Object; $status : Object)
var $myEntity : cs.myTableEntity
If ($status.success)
// ドキュメントをテーブルに保存します
$myEntity:=ds.myTable.new()
$myEntity.blob:=$data
$myEntity.save()
End if