Функция _GUICtrlRichEdit_Create

 ↑  ←  Описание функции


_GUICtrlRichEdit_Create

Создаёт элемент Edit

#include <GuiRichEdit.au3>
_GUICtrlRichEdit_Create($hWnd, $sText, $iLeft, $iTop [, $iWidth = 150 [, $iHeight = 150 [, $iStyle = -1 [, $iExStyle = -1]]]])

Параметры

$hWnd Дескриптор родительского или текущего окна
$sText Текст, который будет отображаться в элементе
$iLeft Координата левого края
$iTop Координата верхнего края
$iWidth [необязательный] Ширина элемента
$iHeight [необязательный] Высота элемента
$iStyle [необязательный] Стили элемента:
    $ES_AUTOHSCROLL - Автоматически прокручивается текст вправо на 10 символов, когда пользователь вводит символ в конце строки.
    $ES_AUTOVSCROLL - Автоматически прокручивается текст на одну страницу, когда пользователь нажимает клавишу ENTER на последней строке.
    $WS_HSCROLL - Элемент имеет горизонтальную полосу прокрутки
    $WS_VSCROLL - Элемент имеет вертикальную полосу прокрутки
    $ES_CENTER - Выравнивает текст по центру в элементе Edit.
    $ES_LEFT - Выравнивает текст по левому краю.
    $ES_MULTILINE - Создаёт многострочный элемент (по умолчанию)
    $ES_NOHIDESEL - Выбранный текст инвертируется, даже если элемент не имеет фокуса.
    $ES_NUMBER - Позволяет ввод только цифр в элемент Edit.
    $ES_READONLY - Предотвращает ввод текста или редактирование в элементе Edit.
    $ES_RIGHT - Выравнивает текст по правому краю.
    $ES_WANTRETURN - Указывает вставку возврата каретки при нажатии клавиши Enter. (по умолчанию)
    $ES_PASSWORD - Отображает звездочки (*) при вводе символов в элемент Edit
    По умолчанию: 0
    Принудительно : WS_CHILD, $WS_VISIBLE, $WS_TABSTOP если не $ES_READONLY
$iExStyle [необязательный] Расширенный стиль элемента. Соответствует стандартным константам $WS_EX_.

Возвращаемое значение

Успех:Возвращает дескриптор элемента Rich Edit
Ошибка:Возвращает 0 и устанавливает @error
@error:103 - $iLeft не является положительным числом или 0
104 - $iTop не является положительным числом или 0
105 - $iWidth не является положительным числом или -1
106 - $iHeight не является положительным числом или -1
107 - $iStyle не является положительным числом или 0 или -1
108 - $iExStyle не является положительным числом или 0 или -1

Примечания

You must call _GUICtrlRichEdit_Destroy() before the script closes.

См. также

_GUICtrlRichEdit_Destroy

Пример

#include <GuiRichEdit.au3>
#include <GUIConstantsEx.au3>
#include <WindowsConstants.au3>
OnAutoItExitRegister('_OnExit') ; Освобождает ресурсы RichEdit даже при завершении скрипта с ошибкой

Global $hRichEdit

Main()

Func Main()
    Local $hGui
    $hGui = GUICreate(StringTrimRight(@ScriptName, 4), 420, 350, -1, -1)
    $hRichEdit = _GUICtrlRichEdit_Create($hGui, 'Это тест.', 10, 10, 400, 220, _
            BitOR($ES_MULTILINE, $WS_VSCROLL, $ES_AUTOVSCROLL))
    GUISetState()

    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
EndFunc   ;==>Main

Func _OnExit()
    ; Для версий ниже 3.3.8.0 обязательно удаление RichEdit или GUI для освобождения ресурсов RichEdit
    _GUICtrlRichEdit_Destroy($hRichEdit)
    GUIDelete()
EndFunc