バージョン

画像の追加 (xamRichTextEditor)

トピックの概要

目的

このトピックは、 xamRichTextEditor ™ を使用して画像を作成する方法を、開発者の観点から説明します。

前提条件

このトピックをより理解するために、以下のトピックを参照することをお勧めします。

トピック 目的

このトピックでは、 xamRichTextEditor コントロールがサポートする機能の概要を説明します。

このトピックは、 xamRichTextEditor でコンテンツをプログラム処理する際に必要なドキュメントのコンテンツ論理構造を説明します。

このトピックでは、 xamRichTextEditor を短時間で起動、実行するために役立つ詳細な操作方法を紹介します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

はじめに

画像の概要

xamRichTextEditor コントロールは、ドキュメントのコンテンツ内の異なるファイル形式の画像をサポートします。画像は ImageNode として表され、 RunNode の ChildNodes コレクションにのみ追加できます。以下のツリー図は、画像を含む段落の構造を示します。

  1. ParagraphNode

    1. RunNode

      1. ImageNode

以下の画像形式がサポートされています。BMP、DIB、EMF、GIF、JPEG、PNG、TIFF、WMF。

注:

Note

GIF および TIFF 画像は、リッチ テキスト ドキュメントのコンテンツを Silverlight の RTF ファイル形式で保存すると損失します。WMF および EMFファイル形式はラウンド トリップの目的のみでサポートされています。これらの画像は、 xamRichTextEditor によりデフォルト画像アイコンとして描画されます。

ImageNode クラスの主要機能

概要

このクラスは、ドキュメントのノード階層の画像を表します。トリミングとマージンを指定するメソッドを提供します。

主要機能

以下の表では、各プロパティ設定の構成です。

目的: 使用する項目 設定値

画像の読み込む

Image プロパティ

RichTextImage 型のインスタンス

画像の読み込む

ImageUri プロパティ

読み込む画像ファイルの場所を指定する文字列。

注:

Note

Image プロパティも指定された場合、このプロパティは無視されます。

画像のトリミング

Cropping プロパティ

各端からのオフセットのパーセンテージとして指定した RectOffsets 型のインスタンス。たとえば、Left および Right プロパティをそれぞれ 10 に設定すると、画像の 20% がトリミングされ、中央の 80% のみが描画されます。負の値も設定できます。その場合、画像の周囲にパディングが設定されます。

画像のマージン設定

RenderEffectsMargin プロパティ

RichTextMargin 型のインスタンス

注:

Note

多くの場合、特に Transform プロパティを使用してストレッチや回転変換が設定されている場合やトリミングが指定されている場合はこのプロパティを設定しないことをお勧めします。RenderEffectsMargin に null が指定されている場合は、レイアウト エンジンにより適切なマージンが自動で計算されます。自動計算されても、このプロパティの値は null のままです。

高度画像変換の設定

Transform プロパティ

プロパティを公開して、水平または垂直方向にストレッチ、回転、反転させる RichTextImageTransform 型のインスタンス

画像サイズの設定または取得

RenderSize プロパティ

RichTextSize 型の値を設定または取得します。

注:

Note

Transform プロパティを使用してストレッチや回転変換が設定されている場合やトリミングが指定されている場合は、このプロパティの指定を null のままとしておくことをお勧めします。null の場合、レイアウト エンジンにより適切な描画サイズが自動で計算され、このプロパティは自動で更新されます。

RichTextImage クラスの主要機能

概要

このクラスは、画像データを表します。コンストラクターはバイト配列からインスタンスを作成できます。このクラスは、ストリームまたはファイルの場所からインスタンスを作成するための静的メソッドを提供します。

主要機能

以下の表では、各プロパティ設定の構成です。

目的: 使用する項目 操作:

バイト配列からの RichTextImage の作成

クラスのコンストラクター

バイト配列を提供します。

データ ストリームからの RichTextImage の作成

CreateFrom メソッド

ストリームを提供します。

ファイルの場所からの RichTextImage の作成

CreateFrom メソッド

ファイルの場所を文字列で提供します。

RichTextImageTransform クラスの主要機能

概要

このクラスは、ドキュメントの描画時に画像に適用する変換を示します。

主要機能

以下の表では、各プロパティ設定の構成です。

目的: 使用するプロパティ: 設定値

画像の水平方向への反転

true

画像の垂直方向への反転

true

画像の回転

回転角度を表す float 型の値。負の値を設定すると画像は左に回転し、正の値を設定すると右に回転します。

画像の水平 / 垂直方向へのストレッチ

ストレッチ幅と高さを含む RichTextSize 型の値。

注:

Note

画像にストレッチサイズを設定すると、RenderSize プロパティで指定したサイズは無視されます。

関連コンテンツ

このトピックの追加情報については、以下のトピックも合わせてご参照ください。

トピック 目的

このトピックは、 xamRichTextEditor を使用してテキストを作成する方法を、開発者の観点から説明します。

このトピックは、 xamRichTextEditor を使用してハイパーリンクを作成する方法を、開発者の観点から説明します。

このトピックは、 xamRichTextEditor を使用してリストを作成する方法を、開発者の観点から説明します。

このトピックは、 xamRichTextEditor を使用してテーブルを作成する方法を、開発者の観点から説明します。