Интерфейс RichEdit

Класс RichEdit расширяет возможности класса Edit и позволяет редактировать текст, содержащий форматирование, компонент поддерживает разбиение текста на абзацы, а также имеет некоторые дополнительные возможности, такие как возможность отмены нескольких изменений. Подробнее...

Граф наследования:RichEdit:

Inheritance graph
Граф связей класса RichEdit:

Collaboration graph
Полный список членов класса

Открытые члены

 FindText ([in] BSTR Text,[in, defaultvalue(FR_DOWN)] ULONG Flags,[in, defaultvalue(0)] LONG MinPos,[in, defaultvalue(-1)] LONG MaxPos,[out, retval] LONG *pResult)
 Метод ищет в тексте текст.
 Load ([in] VARIANT Stream,[in, defaultvalue(SF_RTF)] ULONG Flags,[out, retval] VARIANT_BOOL *pResult)
 Метод загружает текст из потока.
 Save ([in] VARIANT Stream,[in, defaultvalue(SF_RTF)] ULONG Flags,[out, retval] VARIANT_BOOL *pResult)
 Метод сохраняет текст в потоке.
 Redo (void)
 Метод позволяет возвратить изменение текста после отмены изменений.
 Print ([in] BSTR Driver,[in] BSTR Device,[in] IDispatch PrintInfo,[in, defaultvalue(FALSE)] VARIANT_BOOL Selection)
 Печатает текст на выбранном принтере.

Свойства

IDispatch *RW SelFont []
 Свойство определяет шрифт для выделенного фрагмента текста, шрифт по умолчанию определяется свойством Font.
IDispatch *R Paragraph []
 Свойство содержит объект Paragraph для настройки параметров абзаца.
VARIANT_BOOL RW AutoURLDetect []
 Свойство определяет автоматическое определение гиперссылок в тексте.
VARIANT_BOOL R CanRedo []
 Свойство позволяет определить возможность возврата изменение текста после отмены изменений.
ULONG RW UndoLimit []
 Свойство позволяет определить количество возможных изменений, которые можно отменить.
VARIANT W OnSelChange []
 Свойство позволяет задать обработчик события OnSelChange через 2-й уровень.
ULONG RW PageRotate []
 Свойство позволяет определить поворот текста.
ULONG R UndoName []
 Возвращает тип следующей возможно операции Undo.
BSTR R UndoNameString []
 Возвращает тип следующей возможно операции Undo в строковом виде.

Подробное описание

Класс RichEdit расширяет возможности класса Edit и позволяет редактировать текст, содержащий форматирование, компонент поддерживает разбиение текста на абзацы, а также имеет некоторые дополнительные возможности, такие как возможность отмены нескольких изменений.

События: RichEdit как и Edit вызывает событие OnChange при изменении текста. RichEdit имеет дополнительные события RichEditEvents.

Создание: Компонент можно создать методом CreateRichEdit класса Frame

Пример (JScript):

o = new ActiveXObject("Scripting.WindowSystemObject")

f = o.CreateForm(0,0,0,0)

f.ClientWidth = 300
f.ClientHeight = 200
f.CenterControl()

r = f.CreateRichEdit(10,10,400,100)
r.Align = o.Translate("AL_CLIENT")

r.Font.Size = 14

r.Add("Line 1")

r.SelFont.Color = 0x00FF0000

r.Add("Line 3")

r.SelFont.Bold = true
r.SelFont.Color = 0x000000FF
r.SelFont.Size = 16

r.Add("Line 2")

f.Show()

o.Run()

Результат:

RichEdit.jpg


Методы

FindText ( [in] BSTR  Text,
[in, defaultvalue(FR_DOWN)] ULONG  Flags,
[in, defaultvalue(0)] LONG  MinPos,
[in, defaultvalue(-1)] LONG  MaxPos,
[out, retval] LONG *  pResult 
)

Метод ищет в тексте текст.

Аргументы:
Text текст для поиска
Flags может быть комбинацией следующих значений:
  • FR_DOWN направление поиска - вниз - к концу документа
  • FR_WHOLEWORD поиск слов целиком
  • FR_MATCHCASE поиск с учетом регистра
MinPos минимальная позиция области поиска
MaxPos максимальная позиция области поиска, -1 - нет ограничений
Возвращаемые значения:
pResult позиция текста в случае успешной находки текста, -1 если текст не найден.

Load ( [in] VARIANT  Stream,
[in, defaultvalue(SF_RTF)] ULONG  Flags,
[out, retval] VARIANT_BOOL *  pResult 
)

Метод загружает текст из потока.

Аргументы:
Stream поток, может быть объектом TextStream, создаваемым методом OpenTextFile объекта FileSystemObject (для того чтобы узнать об этом объекте и его методе смотрите Microsoft Platform SDK).
Flags параметры формата текста, может принимать одно из значений:
  • SF_RTF Rich Text Format (RTF)
  • SF_TEXT обычный текст без специального форматирования
Дополнительно могут быть указаны следующие флаги:

Возвращаемые значения:
pResult позволяет узнать о корректности выполнения операции.

Print ( [in] BSTR  Driver,
[in] BSTR  Device,
[in] IDispatch  PrintInfo,
[in, defaultvalue(FALSE)] VARIANT_BOOL  Selection 
)

Печатает текст на выбранном принтере.

Аргументы:
Driver Драйвер.
Device Принтер.
PrintInfo Объект PrintInfo .
Selection - "TRUE" - печать только выделенный фрагмент. "FALSE" - печатать весь текст.
Начиная с:
1.1.6.

Redo ( void   ) 

Метод позволяет возвратить изменение текста после отмены изменений.

Save ( [in] VARIANT  Stream,
[in, defaultvalue(SF_RTF)] ULONG  Flags,
[out, retval] VARIANT_BOOL *  pResult 
)

Метод сохраняет текст в потоке.

Аргументы:
Stream поток, может быть объектом TextStream, создаваемым методом CreateTextFile объекта FileSystemObject (для того чтобы узнать об этом объекте и его методе смотрите Microsoft Platform SDK).
Flags параметры формата текста, может принимать одно из значений:
  • SF_RTF Rich Text Format (RTF)
  • SF_RTFNOOBJS Rich Text Format (RTF) без включения объектов
  • SF_TEXT обычный текст без специального форматирования
  • SF_TEXTIZED обычный текст без специального форматирования c объектами в текстовом представлении
Дополнительно могут быть указаны следующие флаги:

Возвращаемые значения:
pResult позволяет узнать о корректности выполнения операции.


Полный список свойств

VARIANT_BOOL RW AutoURLDetect

Свойство определяет автоматическое определение гиперссылок в тексте.

Значение по умолчанию: "FALSE".

VARIANT_BOOL R CanRedo

Свойство позволяет определить возможность возврата изменение текста после отмены изменений.

VARIANT W OnSelChange

Свойство позволяет задать обработчик события OnSelChange через 2-й уровень.

ULONG RW PageRotate

Свойство позволяет определить поворот текста.

Возможные значения

Требуется Windows XP SP1. Работает только с RichEdit версии 5 (CreateRichEdit).

Начиная с:
1.1.8.

IDispatch* R Paragraph

Свойство содержит объект Paragraph для настройки параметров абзаца.

IDispatch* RW SelFont

Свойство определяет шрифт для выделенного фрагмента текста, шрифт по умолчанию определяется свойством Font.

Заметки:
При изменении выделенной области SelFont обновляется.

ULONG RW UndoLimit

Свойство позволяет определить количество возможных изменений, которые можно отменить.

Значение по умолчанию: "100".

ULONG R UndoName

Возвращает тип следующей возможно операции Undo.

Возможные варианты:

BSTR R UndoNameString

Возвращает тип следующей возможно операции Undo в строковом виде.

См. также:
UndoName
Начиная с:
1.1.8.


Документация по WSO 1.1. Последние изменения:Wed Aug 12 18:11:16 2015. (C) Веретенников А. Б. 2004-2015