Общие задачи редактирования форматированного текста

Поддерживаемое подмножество HTML

Текстовые виджеты Qt способны отображать форматированный текст, указываемый с использованием подмножества разметки HTML 4. Виджеты, которые используют QTextDocument, например, QLabel и QTextEdit, способны выводить на экран форматированный текст, заданный таким образом.

Использование разметки HTML в текстовых виджетов

Виджеты автоматически обнаруживает разметку HTML и выводит на экране соответствующий форматированный тектс. Например, настройка свойства метки text со строкой "<b>Hello</b> <i>Qt!</i>" будет иметь результат отображение текста в метке, вот так: Hello Qt!

Когда для текста используется разметка HTML, Qt следует правилам, описанным спецификацией HTML 4. Это включает свойства по умолчанию для текстового слоя, например, направление текста (слева на право), который может изменен применением атрибута dir к блокам текста.

Поддерживаемые теги

Следующая таблица перечисляет теги HTML поддерживаемые движком rich text Qt:

Тег	Описание	Комментарий
`a`	Якорь или ссылка	Поддерживает атрибуты `href` и `name`. Обратите внимание на то, что селектор `:visited` - один из тех, что не поддерживаются движком форматированного текста. Список остального смотрите ниже.
`address`	Адрес
`b`	Жирный
`big`	Больший шрифт
`blockquote`	Параграф с отступом
`body`	Тело документа	Поддерживает атрибут `bgcolor` который может быть именем цвета Qt или определением цвета `#RRGGBB`.
`br`	Разрыв строки
`center`	Центрированный параграф
`cite`	Встроенная цитата	Такой же как `i`.
`code`	Код	Такой же как `tt`.
`dd`	Определение данных
`dfn`	Определение	Такой же как `i`.
`div`	Деление документа	Поддерживает стандартные атрибуты блока.
`dl`	Определение списка	Поддерживает стандартные атрибуты блока.
`dt`	Определение составляющих	Поддерживает стандартные атрибуты блока.
`em`	Выделение	Такой же как `i`.
`font`	Размер шрифта, стиль и/или цвет	Поддерживает следующие атрибуты: `size`, `face` и `color` (имена цветов Qt или `#RRGGBB`).
`h1`	Заголовок уровня 1	Поддерживает стандартные атрибуты блока.
`h2`	Заголовок уровня 2	Поддерживает стандартные атрибуты блока.
`h3`	Заголовок уровня 3	Поддерживает стандартные атрибуты блока.
`h4`	Заголовок уровня 4	Поддерживает стандартные атрибуты блока.
`h5`	Заголовок уровня 5	Поддерживает стандартные атрибуты блока.
`h6`	Заголовок уровня 6	Поддерживает стандартные атрибуты блока.
`head`	Заголовок документа
`hr`	Горизонтальная линия	Поддерживает атрибут `width` который может быть указан как абсолютное или относительное (`%`) значение.
`html`	Документ HTML
`i`	Наклонный
`img`	Изображение	Поддреживает атрибуты `src`, `source` (для поддержки Qt 3), `width` и `height`.
`kbd`	Текст вводимый пользователем
`meta`	Мета информация	Если указана кодировка текста с использованием тега `meta`, он выбирается Qt::codecForHtml(). Аналогично, если кодировка указана для QTextDocument::toHtml(), кодировка хранится с использованием тега `meta`, например: <meta http-equiv="Content-Type" content="text/html; charset=EUC-JP" />
`li`	Элемент списка
`nobr`	Неразрывный текст
`ol`	Упорядоченный список	Поддерживает стандартные атрибуты списка
`p`	Параграф	По умолчанию выравнивается по левому краю. Поддерживает стандартные атрибуты блока.
`pre`	Преформатированный текст
`qt`	Документ форматированного текста Qt	Синоним для `html`. Предоставляет совместимость с ранними версиями Qt.
`s`	Зачеркнутый
`samp`	Пример кода	Такой же как `tt`.
`small`	Маленький шрифт
`span`	Группированные элементы
`strong`	Жирный	Такой же как `b`.
`style`	Таблица стилей	Разрешает информацию о стиле включать в форматированный текст. Ограниченное подмножество синтаксиса CSS можно использовать для изменения внешнего вида текста.
`sub`	Нижний индекс
`sup`	Верхний индекс
`table`	Таблица	Поддерживает следующие атрибуты: `border`, `bgcolor` (имена цветов Qt или `#RRGGBB`), `cellspacing`, `cellpadding`, `width` (абсолютная или относительная) и `height`.
`tbody`	Тело таблицы	Ничего не делает
`td`	Ячейка данных таблицы	Поддерживает стандартные атрибуты ячейки таблицы.
`tfoot`	Сноска таблицы	Ничего не делает
`th`	Ячейка заголовка таблицы	Поддерживает стандартные атрибуты ячейки таблицы.
`thead`	Заголовок таблицы	Если тег `thead` указан, то он используется при печати таблицы которая состоит из множества страниц.
`title`	Заголовок документа	Значение, указанное с помощью тега `title`, доступно через QTextDocument::metaInformation().
`tr`	Строка таблицы	Поддерживает атрибут `bgcolor` который может быть именем цвета Qt или определением цвета `#RRGGBB`.
`tt`	Моноширинный шрифт
`u`	Подчеркнутый
`ul`	Неупорядоченный список	Поддерживает стандартные атрибуты списка
`var`	Переменная	Такой же как `i`.

Атрибуты блока

Следующие атрибуты поддерживаются тегами div, dl, dt, h1, h2, h3, h4, h5, h6, p:

align (left, right, center, justify)
dir (ltr, rtl)

Атрибуты списка

Следующие атрибуты поддерживаются тегами ol и ul:

type (1, a, A, square, disc, circle)

Атрибуты ячейки таблицы

Следующие атрибуты поддерживаются тегами td и th:

width (абсолютная, относительная или без значения)
bgcolor (имена цветов Qt или #RRGGBB)
colspan
rowspan
align (left, right, center, justify)
valign (top, middle, bottom)

Свойства CSS

Следующая таблица перечисляет свойства CSS поддерживаемые движком rich text Qt:

Свойство	Значения	Описание
`background-color`	<color>	Цвет фона для элемента
`background-image`	<uri>	Фоновое изображение для элементов
`color`	<color>	Цвет текста
`font-family`	<family name>	Имя стиля шрифта
`font-size`	[ small \| medium \| large \| x-large \| xx-large ] \| <size>pt \| <size>px	Размер шрифта относительно шрифта документа или указанные в точках или пикселах
`font-style`	[ normal \| italic \| oblique ]
`font-weight`	[ normal \| bold \| 100 \| 200 \| 300 \| 400 \| 500 \| 600 \| 700 \| 800 \| 900 ]	Указывает вес фона используемого для текста где `normal` и `bold` преобразовываются в соответствующие веса QFont. Числовые значения 8 размеров эквивалентны значениям весов QFont.
`text-decoration`	none \| [ underline \|\| overline \|\| line-through ]	Дополнительные текстовые эффекты
`font`	[ [ <'font-style'> \|\| <'font-weight'> ]? <'font-size'> <'font-family'> ]	Стенографическое свойство шрифта
`text-indent`	<length>px	Отступ первой линии текста в пикселах
`white-space`	normal \| pre \| nowrap \| pre-wrap	Объявляет как обрабатываются пробелы в HTML.
`margin-top`	<length>px	Верхняя граница параграфа в пикселах
`margin-bottom`	<length>px	Нижняя граница параграфа в пикселах
`margin-left`	<length>px	Левая граница параграфа в пикселах
`margin-right`	<length>px	Правая граница параграфа в пикселах
`padding-top`	<length>px	Верхний отступ ячейки таблицы в пикселах
`padding-bottom`	<length>px	Нижний отступ ячейки таблицы в пикселах
`padding-left`	<length>px	Левый отступ ячейки таблицы в пикселах
`padding-right`	<length>px	Правый отступ ячейки таблицы в пикселах
`padding`	<length>px	Стенограмма всех настроек всех свойств отступов.
`vertical-align`	baseline \| sub \| super \| middle \| top \| bottom	Вертикальное выравнивание текста. Для вертикального выравнивания в ячейках текстовой таблицы применяются только middle, top и bottom.
`border-color`	<color>	Цвет границ для текстовых таблиц.
`border-style`	none \| dotted \| dashed \| dot-dash \| dot-dot-dash \| solid \| double \| groove \| ridge \| inset \| outset	Стиль границ для текстовых таблиц.
`background`	[ <'background-color'> \|\| <'background-image'> ]	Стенограмма свойств фона
`page-break-before`	[ auto \| always ]	Делает возможным заставить разорвать страницу перед параграфом/таблицу
`page-break-after`	[ auto \| always ]	Делает возможным заставить разорвать страницу после параграфа/таблицы
float	[ left \| right \| none ]	Указывает где изображение или текст будет установлено в другом элементе. Обратите внимание на то, что свойство `float` поддерживается только для таблиц и изображений.
`text-transform`	[ uppercase \| lowercase ]	Выбирает трансформацию которая будет исполнена на тексте до его отображения.
`font-variant`	small-caps	Выполняет преобразование текста к маленьким буквам перед выводом на экран.
`word-spacing`	<width>px	Указывает дополнительный интервал между каждым словом.

Поддерживаемые селекторы CSS

Поддерживаются все классы селекторов CSS 2.1 кроме псевдо-классов, таких как :first-child, :visited и :hover.