image はプログラミングには使用せずに、イメージをアプレットに組み込むためにドキュメント内で使用します。

source: url オブジェクトを使用して指定され、URL フォーマットを使用したイメージを表すファイル。

blocking?: イメージを非同期的にロードするか、あるいは同期的にロードするかを指定します。非同期的にロードする場合は、blocking を false (既定) に設定し、それ以外は true に設定します。

ignore-exceptions?: イメージの取得あるいは表示に問題が発生した場合に、例外を設定するかまたは警告しないで無視するかを指定します。 既定では、 ignore-exceptions? は true であり、呼び出し元に例外は設定されません。このためアプレットが最後までロードされます。この場合、イメージのプレースホルダ — — が表示されます。イメージがこのように表示される場合は、次のようなさまざまな問題が考えられますがこれらに限定されるわけではありません。：

• アクセス拒否
• ロードの失敗
• 不正または破損したイメージ データ
• イメージが存在しない
• ネットワークの問題
• 部分的なデータ転送
• セキュリティの問題

ignore-exceptions? が false の場合は、例外がスローされます。非特権アプレットで例外がスローされた場合、内部でキャッチされ ImageException がスローされます。ImageException によってイメージのロードに失敗したことはわかりますが、原因はわかりません。

...: Graphicに設定することができるキーワード引数。たとえば、ユーザーは width および height キーワード引数を設定することができます。設定しない場合は、既定でソース ファイルで指定されているサイズになります。ユーザーはまた、イメージにアタッチされるイベント ハンドラを設定することもできます。

予期されたイベント

{image
    source={url "curl://install/docs/default/images/adria.jpg"},
    width=1in,
    height=1in
}

通常、イメージ データはキャッシュされます。これは、アプレット内の複数のイメージ グラフィカル オブジェクトに同一の URL が使用されると、イメージは一度だけサーバーから取得されることを意味します。イメージ データがキャッシュされないようにする場合は、次のいずれかの方法を選択します。

• source URL の Url.query メンバーが空でないことを確認してしてください。
• with-file-caching-styleを使用します。

イメージ データがキャッシュされた非 null source の場合、blocking? および ignore-exceptions? は、最初の image の呼び出し内でのみ使用されます。