リッチテキストエディター

[リッチテキストエディター] コントロールを使用すると、ユーザーがアプリからリッチテキストを作成できます。このテキストは、メールの内容、マーケティングコンテンツなどとして使用できます。

設計時

全般

ヒントテキスト - 実行時に表示するヘルプテキストです。
既定のテキスト - 実行時に表示する既定のコンテンツです。
ラベル - コントロールの表示テキストです。
必須 - true の場合、アプリユーザーはコントロール内のデータを指定する必要があります。実行時にコントロールが必須であることを示すため、ラベルテキストの後にアスタリスク * が追加されます。
カスタムエラーメッセージ - [必須] プロパティが true に設定され、コントロールが空のままの場合に表示するテキストです。
非表示 - true の場合、実行時にコントロールが非表示になります。
読み取り専用 - true の場合、実行時にテキストを追加することはできません。ただし、既存のコンテンツは表示されますが、それを編集することはできません。

イベント

値の変更時 - コンテンツが変更された際の挙動を設定します。

スタイル

コントロールの配置 - 既定では、親の配置を継承します。親とは異なる配置を設定することもできます。既定の親の配置に戻すには、現在優先されているオプションの選択を解除します。

注: 配置は、親に対して選択したレイアウト ([縦方向]/[横方向]) によって異なります。
ラベル配置 - 既定では、ラベルはコントロールの左上に表示されるよう設定されています。ラベルは、コントロールの左横に配置することもできます。[ラベル幅] プロパティはラベルの幅を設定し、[間隔] プロパティはラベルとコントロールの間の距離を設定します。
フォント - ラベルテキストのフォント属性 (フォントファミリ、サイズ、色、スタイル (太字、斜体、下線) など) です。既定では、このコントロールの直接の親コンテナーのフォントファミリが継承されます。その場合、フォントに「Inherited」と表示されます。
マージン - コントロールのマージンです。既定では 4px のマージンが設定されています。[上/下] および [左/右] のプロパティがそれぞれ組み合わされています。これらのプロパティの組み合わせは、[マージン] セクションの右側にある [リンク] ボタンをクリックして解除できます。
サイズ - コントロールの幅と高さです。既定では、サイズは [auto] に設定されています。最小値または最大値を設定するには、3 点リーダーメニューのアイコン (...) をクリックします。コントロールのサイズがオプションよりも小さい場合は、スクロールバーが表示されます。

注: コントロールの配置を [画面に合わせて伸縮] に設定した場合に、親コントロールを [折り返しを許可] に設定すると、[リッチテキストエディター] コントロールが高さいっぱいまで拡大されません。これを回避するには、[画面に合わせて伸縮] の配置を削除するか、コントロールの高さを明示的に指定します。

実行時

概要

このコントロールを使用すると、実行時にアプリから直接リッチテキストを作成できます。

注: 実行時に [読み取り専用] ボックスを選択すると、[リッチテキストエディター] のインターフェイスが変わります。編集コントロールは非表示になり、新しいテキストを追加したり、既存のテキストを編集したりすることはできません。

インターフェイス

このインターフェイスは、次のような便利な機能を提供します。

フォントスタイル - フォントをパーソナライズします。以下のオプションから選択できます。
- 太字
- 斜体
- 下線
- 箇条書き - 箇条書きを作成します。
- 番号付きリスト - 番号付きリストを作成します。
- 表 - 表を作成します。ドロップダウンメニューから [表のプロパティ] を選択することで、表のスタイル (サイズ、配置、背景色、枠線) を変更できます。
- フォントファミリ
- フォントサイズ
- テキストの色
- テキストの背景色
配置 - [リッチテキストエディター] コントロールのコンテンツの配置を設定します。
- 左揃え - テキストを左端に揃えます。
- 右揃え - テキストを右端に揃えます。
- 中央揃え - テキストを 2 つの端の間に揃えます。
- 割り付け - 行全体が埋まるように単語間のスペースを増やして、左右両端に揃えます。
インデントを減らすまたは増やす - 段落の左マージンと右マージンの間のスペースを増やすか、減らします。
行の高さ - 2 つの行の間のスペースを変更します。
上付き文字と下付き文字 - テキストを標準タイプの行より少し上 (上付き) または下 (下付き) になるように書式設定します。
書式をクリア - 選択したテキストのブロック、段落、またはテキスト全体のすべての書式設定を解除します。
画像を挿入/編集 - ストレージバケットから画像を挿入します。
ブロック引用符 - 別のソースから取得したテキストの大きな選択範囲の引用を示します。
横線 - 横線を挿入します。
リンクを挿入/編集 - パブリック URL を挿入または編集します。同じウィンドウまたは新しいウィンドウで開くよう設定することもできます。
元に戻す

キーボードショートカット

重要:

現在、Windows マシンでは、[リッチテキストエディター] コントロールに表示される埋め込みまたは画像ポップアップに対して、CTRL+C および CTRL+V のキーボードショートカットが機能しません。

代わりに、CTRL+SHIFT+C と CTRL+SHIFT+V を使用してください。

次のキーボードショートカットを使用して、コントロールのツールバーに移動できます。

タスク	PC (macOS 以外)	macOS
メニューバーにフォーカスまたはジャンプする	ALT + F9	Option + F9
ツールバーにフォーカスまたは移動する	ALT + F10	Option + F10