4D Doc Center : GET DOCUMENT ICON

4D v14.3

GET DOCUMENT ICON


GET DOCUMENT ICON ( docPath ; icon {; size} )

引数	型	説明
docPath	文字	アイコンを取得するドキュメントのパスまたは名前、または空の文字列の場合標準のファイルを開くダイアログ
icon	ピクチャー	ピクチャ変数またはフィールド
size	倍長整数	返されたピクチャのサイズ(ピクセルで)

説明

GET DOCUMENT ICONコマンドは、filePathに渡した名前または完全なパス名を持つドキュメントのアイコンを4Dのピクチャ変数またはフィールドiconに返します。filePath はあらゆるタイプのファイル (実行ファイル、ドキュメント、ショートカットまたは別名など) またはフォルダを指定します。

filePathには、完全なドキュメントのパス名が含まれていなければなりません。あるいはドキュメント名または相対パス名を渡すこともできます。しかしこの場合、ドキュメントはカレントのワーキングディレクトリに存在していなければなりません (通常、データベースストラクチャファイルを含んでいるフォルダ) 。

空の文字列をfilePathに渡すと、標準的なファイルを開くダイアログボックスが表示され、ユーザは読み込むファイルを選択することができます。ダイアログボックスが受け入れられると、Documentシステム変数は選択されたファイルの完全なパス名を格納します。

4Dのピクチャフィールドまたは変数をiconに渡します。コマンドが実行されるとこの引数にはファイル (PICTフォーマット) のアイコンが返されます。

任意の引数sizeによって、返されたアイコンのサイズをピクセルで設定できます。この値は、実際にアイコンを含む正方形の両方の側面の長さを表します。通常アイコンは32x32ピクセル(大きいアイコン) または16x16ピクセル(小さいアイコン) で定義されます。0を渡したり、この引数を省略する場合、使用できる最大のアイコンが返されます。