Wt3.3.1文档翻译：Wt::WTextEdit类参考，Wt::WTextEdit Class Reference

详细说明

一个富文本XHTML 编辑器。

这个编辑器支持交互式地编辑XHTML 文本。默认情况下，它提供基本的标记功能（字体、格式、颜色、链接及列表），但是也可以向工具条中添加额外的按钮，它们提供额外的格式化选项。

它是基于TinyMCE实现的。这个部件可以通过 setConfigurationSetting() 及相关的允许直接访问底层TinyMCE 组件的方法来进行配置及裁剪。

妳可以在这个部件中使用TinyMCE 版本3或4，但是它们要求的配置选项是不同的。

默认情况下，Wt假设妳使用的是3.x 版本的TinyMCE。妳需要自己去下载TinyMCE（版本3.5b1或更高版本），然后将 tinymce/jscripts/tiny_mce 目录部署到 tinyMCEBaseURL 。 tinyMCEBaseURL 的默认值是 resourcesURL /tiny_mce ，其中， resourcesURL是指向Wt 的resources/目录的那个配置属性（也就是说，我们假设在默认情况下妳是将 tiny_mce 目录复制到 resources/ 目录的），参考 部署及资源 。

如果妳更喜欢使用TinyMCE 4（或更高版本），那么，妳需要将 tinyMCEVersion 属性设置为4（或更高版本）。注意，TinyMCE在版本4中改变了它的目录布局情况。妳需要将 js/tinymce 目录部署到 tinyMCEBaseURL 。对于TinyMCE 4（或更高版本）， tinyMCEBaseURL 的默认值是 resourcesURL /tinymce （也就是说，我们假设妳将 tinymce（☯：原文是tiny_mce） 目录复制到 resources/ 目录）

因为默认的目录名是不同的（对于版本3是"tiny_mce"，对于版本4是"tinymce"），所以，妳可以在资源目录中同时放置TinyMCE3和TinyMCE4，并且试验哪个版本的TinyMCE 更适合妳。

可在Wt 配置文件中设置tinyMCEBaseURL 属性 的值，以覆盖TinyMCE 资源的默认位置，参考 配置 属性。

使用示例：

Wt::WContainerWidget *w = new Wt::WContainerWidget();

Wt::WLabel *label = new Wt::WLabel("Comments:", w);

Wt::WTextEdit *edit = new Wt::WTextEdit("", w);

label->setBuddy(edit);

CSS

无法通过CSS来设置样式。

一个WTextEdit的默认配置情况下的截屏

成员函数文档

void Wt::WTextEdit::setConfigurationSetting	(	const std::string &	name,
		const boost::any &	value
	)

配置一个TinyMCE选项。

在这里可以找到一份可用选项列表： http://tinymce.moxiecode.com/wiki.php/Configuration

这个部件本身也会定义一些配置选项，这些选项同样可以使用这个方法来覆盖。

void Wt::WTextEdit::setExtraPlugins

(

const std::string &

plugins)

载入额外的TinyMCE插件。

Wt在默认情况下只载入'safari' (它提供了对于Safari网页浏览器的支持)这个插件。可使用这个方法来载入额外的插件。多个插件可使用逗号隔开。

各个插件都在TinyMCE文档中有说明。

注意

插件只可以在最初显示本部件之前载入。

void Wt::WTextEdit::setText ( const WString & text)

virtual

设置其内容。

所设置的文本内容text应当是一段有效的XHTML。

默认值是""。

这个方法对Wt::WTextArea进行了覆盖。

void Wt::WTextEdit::setToolBar	(	int	i,
		const std::string &	config
	)

配置一个工具条。

这个方法会配置第i个（其中0 <= i <= 3）工具条中的按钮。

TinyMCE 3

在TinyMCE文档中说明了应当使用的语法及可用的按钮。

针对第一个（i = 0）工具条的默认配置（config）值为："fontselect, |, bold, italic, underline, |, fontsizeselect, |, forecolor, backcolor, |, justifyleft, justifycenter, justifyright, justifyfull, |, anchor, |, numlist, bullist"。

默认情况下，另外3个工具条都处于禁用状态（ config = ""）。

TinyMCE 4

在TinyMCE文档中说明了应当使用的语法及可用的按钮。

针对第一个（i = 0）工具条的默认配置（config）值为："undo redo | styleselect | bold italic | link"。

某些按钮，只有在使用setExtraPlugins()载入了额外的插件之后才可使用。

注意

工具条配置选项只能在此部件最初显示之前设置。

未知美人

未知美人

未知美人