イメージを表示します。
説明
image はプログラミングには使用せずに、イメージをアプレットに組み込むためにドキュメント内で使用します。
source: url オブジェクトを使用して指定され、URL フォーマットを使用したイメージを表すファイル。
blocking?: イメージを非同期的にロードするか、あるいは同期的にロードするかを指定します。非同期的にロードする場合は、blocking を false (既定) に設定し、それ以外は true に設定します。
ignore-exceptions?: イメージの取得あるいは表示に問題が発生した場合に、例外を設定するかまたは警告しないで無視するかを指定します。
既定では、 ignore-exceptions? は true であり、呼び出し元に例外は設定されません。このためアプレットが最後までロードされます。この場合、イメージのプレースホルダ —
— が表示されます。イメージがこのように表示される場合は、次のようなさまざまな問題が考えられますがこれらに限定されるわけではありません。：
ImageException がスローされます。ImageException によってイメージのロードに失敗したことはわかりますが、原因はわかりません。
— が表示されます。イメージがこのように表示される場合は、次のようなさまざまな問題が考えられますがこれらに限定されるわけではありません。：
- アクセス拒否
- ロードの失敗
- 不正または破損したイメージ データ
- イメージが存在しない
- ネットワークの問題
- 部分的なデータ転送
- セキュリティの問題
...: Graphic に設定することができるキーワード引数。たとえば、ユーザーは width および height キーワード引数を設定することができます。設定しない場合は、既定でソース ファイルで指定されているサイズになります。ユーザーはまた、イメージにアタッチされるイベント ハンドラを設定することもできます。
戻り値
予期されたイベント
例
| 例 | |
 | |
{image
source={url "curl://install/docs/default/images/adria.jpg"},
width=1in,
height=1in
}
|
注意事項
画像データは通常キャッシュされます。アプレットの中で同じ URL の画像が複数使用されている場合でも、画像は一度だけサーバから取得されることを意味します。もし画像データをキャッシュさせたくない場合は、以下の処理の内一つを選択してください。 :
- source の
Url.query が空でないことを確認する。 with-file-caching-style を使用する。
null でない source において、画像データがキャッシュされていると、blocking? と ignore-exceptions? は image の初回呼び出し時のみに使用されます。
サポートされる画像フォーマット以下の通りです。 :
- GIF, 1ビットの透過度を含むので、ピクセル単位で完全に透過または不透過にでき、またアニメーションGIFも含みます。Curl 言語では GIF ファイルを作成しないように制限がかけられています。
- JPG
- BMP, 1、4、8、24、または32 ビット深度を含みます。Curl 言語では、圧縮された BMP ファイルをサポートしていません。カラー チャネルがインタリーブされているイメージだけをロードします。独立したカラー プレーンのイメージはロードしません。Curl 言語では、ピクセルあたり 32 ビットで、圧縮なしの BMP ファイルを生成します。
- PPM
- PNG, は、8 ビット深度の透過度をサポートします。Curl RTE バージョン 6.0 以前で、Curl のアプレットで部分的な透過性を正しく表示するには、イメージを AntialiasedFrame または Canvas に配置し、AntialiasMixin.use-host-rendering? プロパティを false に設定します。もう1つの方法は、set-rendering-mode を呼び出して、アプレット全体で部分的な透過性を有効にします。
- TIFF, 複数イメージのファイルの最初のイメージのみ。追加のイメージにアクセスするには、
ImageData を使用します。
このオブジェクトは、"item"のスタイル ルールを記述することでスタイル化することが出来ます。