Flex-RichTextEditorコントロール

RichTextEditorコントロールは、テキストを入力およびフォーマットするためのユーザーオプションを提供します。ユーザーは、フォントファミリ、色、サイズ、スタイル、およびテキストの配置、箇条書き、URLリンクなどの他のプロパティを変更できます。コントロールは、2つのコントロールを持つPanelコントロールで構成されます

ユーザーがテキストを入力できるテキスト領域コントロール。
ユーザーがテキストの特性を指定できるフォーマットコントロールを備えたコンテナ。フォーマットコントロールは、入力するテキストまたは選択したテキストに影響します。

クラス宣言

以下は mx.controls.RichTextEditor クラスの宣言です-

public class RichTextEditor
   extends Panel

パブリックプロパティ

Sr.No	Property & Description
1	alignToolTip : String = "Align" ユーザーがテキスト配置ボタンにカーソルを合わせたときに表示されるツールヒント。
2	boldToolTip : String = "Bold" ユーザーがテキストの太字ボタンにカーソルを合わせたときに表示されるツールヒント。
3	bulletToolTip : String = "Bullet" ユーザーが箇条書きリストボタンにカーソルを合わせたときに表示されるツールヒント。
4	colorPickerToolTip : String = "Color" ユーザーがColorPickerコントロールにカーソルを合わせたときに表示されるツールヒント。
5	defaultLinkProtocol : String リンクテキストの先頭で使用するデフォルトのプロトコル文字列。
6	fontFamilyToolTip : String = "Font Family" ユーザーがフォントのドロップダウンリストにカーソルを合わせたときに表示されるツールヒント。
7	fontSizeToolTip : String = "Font Size" ユーザーがフォントサイズのドロップダウンリストにカーソルを合わせたときに表示されるツールヒント。
8	htmlText : String RichTextEditorコントロールのTextAreaサブコントロールに表示されるHTMLマークアップを含むテキスト。
9	italicToolTip : String = "Italic" ユーザーがテキストの斜体ボタンにカーソルを合わせたときに表示されるツールヒント。
10	linkToolTip : String = "Link" ユーザーがリンクテキスト入力フィールドにカーソルを合わせたときに表示されるツールヒント。
11	selection : mx.controls.textClasses:TextRange [read-only] A TextRange object containing the selected text in the TextArea subcontrol.
12	showControlBar : Boolean テキスト書式設定コントロールを含むコントロールバーを表示するかどうかを指定します。
13	showToolTips : Boolean テキスト書式設定コントロールのツールチップを表示するかどうかを指定します。
14	text : String RichTextEditorコントロールのTextAreaサブコントロールに表示されるマークアップなしのプレーンテキスト。
15	underlineToolTip : String = "Underline" ユーザーがテキストの下線ボタンにカーソルを合わせたときに表示されるツールヒント。

パブリックメソッド

Sr.No	Method & Description
1	RichTextEditor() コンストラクタ。

イベント

Sr.No	Event & Description
1	change ユーザーがTextAreaコントロールのテキストの内容または形式を変更したときに送出されます。

継承されるメソッド

このクラスは、次のクラスからメソッドを継承します-

mx.containers.Panel
mx.core.Container
mx.core.UIComponent
mx.core.FlexSprite
flash.display.Sprite
flash.display.DisplayObjectContainer
flash.display.InteractiveObject
flash.display.DisplayObject
flash.events.EventDispatcher
対象

Flex RichTextEditorコントロールの例

テストアプリケーションを作成して、FlexアプリケーションでのRichTextEditorコントロールの使用を確認するには、次の手順に従います-

Step	Description
1	Create a project with a name HelloWorld under a package com.finddevguides.client as explained in the Flex - Create Application chapter.
2	Modify HelloWorld.mxml as explained below. Keep rest of the files unchanged.
3	Compile and run the application to make sure business logic is working as per the requirements.

以下は、変更されたmxmlファイル src/com.finddevguides/HelloWorld.mxml の内容です。

<?xml version = "1.0" encoding = "utf-8"?>
<s:Application xmlns:fx = "http://ns.adobe.com/mxml/2009"
   xmlns:s = "library://ns.adobe.com/flex/spark"
   xmlns:mx = "library://ns.adobe.com/flex/mx"
   width = "100%" height = "100%" minWidth = "500" minHeight = "500">

   <fx:Style source = "/com/finddevguides/client/Style.css"/>
   <fx:Script>
      <![CDATA[
         private var richTextString:String = "You can enter text into the"
            +" <b>RichTextEditor control</b>.Click <b>"
            +"<font color = '#BB50AA'>buttons</font></b> to display"
            +" entered text as <i>plain text</i>, "
            +"or as <i>HTML-formatted</i> text.";
      ]]>
   </fx:Script>

   <s:BorderContainer width = "630" height = "480" id = "mainContainer"
      styleName = "container">
      <s:VGroup width = "100%" height = "100%" gap = "50"
         horizontalAlign = "center" verticalAlign = "middle">
         <s:Label id = "lblHeader" text = "Complex Controls Demonstration"
            fontSize = "40" color = "0x777777" styleName = "heading"/>

         <s:Panel id = "richTextEditorPanel" title = "Using RichTextEditor"
            width = "500" height = "300">
            <s:layout>
               <s:VerticalLayout  gap = "10" verticalAlign = "middle"
                  horizontalAlign = "center"/>
            </s:layout>

            <mx:RichTextEditor id = "richTextEditor" title = "RichTextEditor"
               width = "90%" height = "150"
               borderAlpha = "0.15"
               creationComplete = "richTextEditorlText = richTextString;"/>
            <s:TextArea id = "richText" width = "90%" height = "50"/>

            <s:HGroup>
               <s:Button label = "Show Plain Text"
                  click = "richText.text = richTextEditor.text;"/>
               <s:Button label = "Show HTML Markup"
                  click = "richText.text = richTextEditorlText;"/>
            </s:HGroup>
         </s:Panel>
      </s:VGroup>
   </s:BorderContainer>
</s:Application>

すべての変更が完了したら、link：/flex/flex_create_application [Flex-アプリケーションの作成]の章で行ったように、アプリケーションを通常モードでコンパイルして実行します。アプリケーションに問題がなければ、次の結果が得られます。[link：/flex/samples/ComplexControlsApplicationl＃currentlyLoaded = RichTextEditor [オンラインで試す]]

Flex RichTextEditorコントロール

Flex-richtexteditor-control