Класс CEdit

Статья
06/10/2015

Предоставляет функциональные возможности элемента управления "Поле ввода" Windows.

class CEdit : public CWnd

Члены

Открытые конструкторы

Имя	Описание
CEdit::CEdit	Создает объект управления CEdit.

Открытые методы

Имя	Описание
CEdit::CanUndo	Определяет, является ли операция элемента управления "Поле ввода" можно отменить.
CEdit::CharFromPos	Извлекает индексы линии и знака для символа, ближайшего к заданной позиции.
CEdit::Clear	Удаляет (снимите клиринги) текущее выделение (если есть), то в элементе управления "Поле ввода".
CEdit::Copy	Копирует текущее выделение (если есть), то в элементе управления "Поле ввода" в буфер обмена в формате CF_TEXT.
CEdit::Create	Создает элемент управления "Поле ввода" Windows и вложение его к объекту CEdit.
CEdit::Cut	Удаляет (отрезки) текущее выделение (если есть), то в элементе управления "Поле ввода" и копиях удалено текста в буфер обмена в формате CF_TEXT.
CEdit::EmptyUndoBuffer	Сбросить (снимите клиринги) пометить отката элемента управления "Поле ввода".
CEdit::FmtLines	Устанавливает включение и выключение функциональных клавиш символов разрыва строк в многономенклатурный элемент управления "Поле ввода".
CEdit::GetCueBanner	Извлекает текст, который отображается как очередь текста или совет в элементе управления "Поле ввода", если элемент управления является пустым и не имеет фокус.
CEdit::GetFirstVisibleLine	Указывает верхний видимую линию в элементе управления "Поле ввода".
CEdit::GetHandle	Получает дескриптор памяти, которая в настоящий момент выделена для многономенклатурного элемента управления "Поле ввода".
CEdit::GetHighlight	Возвращает индексы начальный и конечный символы в диапазон текста, выделен в текущем элементе управления "Поле ввода".
CEdit::GetLimitText	Получает максимальное количество это CEdit может содержать текст.
CEdit::GetLine	Извлекает линия текст из элемента управления "Поле ввода".
CEdit::GetLineCount	Получает количество линий в многономенклатурном элементе управления "Поле ввода".
CEdit::GetMargins	Возвращает левое и правое поле для этого CEdit.
CEdit::GetModify	Определяет, были ли изменены содержимое элемента управления "Поле ввода".
CEdit::GetPasswordChar	Извлекает знак пароля, отображаемый в элементе управления "Поле ввода", когда пользователь вводит вставке СМС.
CEdit::GetRect	Возвращает прямоугольник форматирования элемента управления "Поле ввода".
CEdit::GetSel	Возвращает первую и последнюю позиции символа текущего выделения в элементе управления "Поле ввода".
CEdit::HideBalloonTip	Скрывает все всплывающая подсказка, связанная с текущим элементом управления "Поле ввода".
CEdit::LimitText	Ограничивает длину текста, пользователь может вводить в элемент управления "Поле ввода".
CEdit::LineFromChar	Получает номер линии линии, содержащую заданный индекс символа.
CEdit::LineIndex	Извлекает индекс символа линии в многономенклатурный элемент управления "Поле ввода".
CEdit::LineLength	Получает длину линии в элементе управления "Поле ввода".
CEdit::LineScroll	Прокручивает текст многономенклатурного элемента управления "Поле ввода".
CEdit::Paste	Вставляет данные из буфера обмена в элемент управления "Поле ввода" с текущей позиции курсора. Данные вставляются только в случае, если буфер обмена содержит данные в формате CF_TEXT.
CEdit::PosFromChar	Получает координаты левого угла верхн- указанного индекса символа.
CEdit::ReplaceSel	Заменяет текущее выделение в элементе управления "Поле ввода" с заданным текстом.
CEdit::SetCueBanner	Задает текст, который отображается как очередь текста или совет в элементе управления "Поле ввода", если элемент управления является пустым и не имеет фокус.
CEdit::SetHandle	Устанавливает дескриптор локальной памяти, которая будет использоваться многономенклатурным элементом управления "Поле ввода".
CEdit::SetHighlight	Выбирает диапазон текста, отображаемого в текущем элементе управления "Поле ввода".
CEdit::SetLimitText	Задает максимальное количество это CEdit может содержать текст.
CEdit::SetMargins	Задает левое и правое поле для этого CEdit.
CEdit::SetModify	Задает или снимите клиринги пометить изменения для элемента управления "Поле ввода".
CEdit::SetPasswordChar	Задает или удаляет знак пароля, отображаемый в элементе управления "Поле ввода", когда пользователь вводит вставке СМС.
CEdit::SetReadOnly	Устанавливает только для чтения, состояние элемента управления "Поле ввода".
CEdit::SetRect	Задает прямоугольник форматирования многономенклатурного элемента управления "Поле ввода" и обновляет элемент управления.
CEdit::SetRectNP	Задает прямоугольник форматирования многономенклатурного элемента управления "Поле ввода" без redrawing окно элемента управления.
CEdit::SetSel	Выбирает диапазон символов в элементе управления "Поле ввода".
CEdit::SetTabStops	Устанавливает позицию табуляции в многономенклатурном элементе управления "Поле ввода".
CEdit::ShowBalloonTip	Отображает всплывающую подсказку, которая сопоставлена с текущим элементом управления "Поле ввода".
CEdit::Undo	Отменяет последнюю операцию элемента управления "Поле ввода".

Заметки

Элемент управления "Поле ввода" прямоугольное дочернее окно, в котором пользователь может вводить текст.

Можно создать элемент управления "Поле ввода" или из шаблона диалогового окна или непосредственно в коде. В обоих случаях сначала вызвать конструктор CEdit для создания объекта CEdit, затем вызвать функцию-член Создание для создания элемента управления "Поле ввода" Windows и вложить его к объектному CEdit.

Конструкция может быть одношаговым процессом в классе, производном от CEdit. Создание конструктора производного класса и вызовите Создать из конструктора.

CEdit наследует значительные возможности из CWnd. Для установки и извлечения текста из объекта CEdit, используйте функции-члены SetWindowText и GetWindowTextCWnd, устанавливающие или получающие все содержимое элемента управления "Поле ввода", даже если многострочный элемент управления. Линии многополосном текста в элементе управления разделены последовательности символов "\r\n". Кроме того, если элемент управления "Поле ввода" многополосн, получение и установка часть текста элемента управления путем вызова функции-члены GetLine, SetSel, GetSel и ReplaceSelCEdit.

Если нужно обрабатывать сообщения уведомлений Windows, отправляемых элементом управления "Поле ввода" с родительским элементом (обычно класс, производный от CDialog), то добавление функции-члена записи и обработчика сообщений сообщение- сопоставления в родительский класс для каждого сообщения.

Каждая запись сообщение-сопоставления принимает следующую форму:

ON_Notification(id, memberFxn)

где id задает идентификатор дочернего окна элемента управления "Поле ввода" отправляющее уведомление и memberFxn имя родительского функции-члена был написан для обработки уведомления.

Родительский прототип функции следующим образом:

memberFxn ( ); свободного пространства afx_msg

Ниже приведен список потенциальных записей сообщение- сопоставления и описание вариантов, в которых они были бы отправлены к родительскому элементу.

ON_EN_CHANGE Принимало действие, которое пользователь может изменять текст в элементе управления "Поле ввода". В отличие от сообщение уведомления EN_UPDATE это сообщение уведомления отправлено после Windows обновляет отображение.
ON_EN_ERRSPACE Элемент управления "Поле ввода" не может выделить достаточно памяти для особому соответствовать требованию.
ON_EN_HSCROLL Пользователь щелкает полоса прокрутки элемента управления "Поле ввода" горизонтальная. Родительское окно уведомлено, прежде чем экран обновления.
ON_EN_KILLFOCUS Элемент управления "Поле ввода" теряет фокус ввода.
ON_EN_MAXTEXT Текущая инструкция insert threshold exceeded указанное число знаков для элемента управления "Поле ввода" и было усечено. Кроме того, отправленный, когда элемент управления "Поле ввода" не будет иметь стилю ES_AUTOHSCROLL и число символов для вставки превышает ширину элемента управления "Поле ввода". Кроме того, отправленный, когда элемент управления "Поле ввода" не будет иметь ES_AUTOVSCROLL и стиль линий привести к общему количеству из вставки текста, превысит на высоту элемента управления "Поле ввода".
ON_EN_SETFOCUS, Отправляемое, когда элемент управления "Поле ввода" получит фокус ввода.
ON_EN_UPDATE Элемент управления "Поле ввода" рядом с текстом измененных отображением. Отправленный после того как элемент управления форматировал текст, но прежде, чем он экранирует текст, так что размер окна можно изменить, если требуемый.
ON_EN_VSCROLL Пользователь щелкает вертикальная полоса прокрутки элемента управления "Поле ввода". Родительское окно уведомлено, прежде чем экран обновления.

При создании объекта CEdit в диалоговое окно, то объект CEdit автоматически уничтожается, когда пользователь закрывает диалоговое окно.

При создании объекта CEdit из ресурса диалогового окна с помощью редактора диалоговых окон, то объект CEdit автоматически уничтожается, когда пользователь закрывает диалоговое окно.

При создании объекта CEdit в это окно можно также удалить его. При создании объекта CEdit в стеке, он удален автоматически. При создании объекта CEdit в куче с помощью функции новый, необходимо вызвать метод удалить в объекте, чтобы удалить его, когда пользователь завершает элемент управления "Поле ввода" Windows. При выборе любая память в объекте CEdit, следует переопределить CEdit деструктор для удаления распределений.

Чтобы изменить некоторые стили в элементе управления "Поле ввода" (например, ES_READONLY) для отправки сообщения, относящиеся к элементу управления вместо использования ModifyStyle. См. раздел Стили элемента управления "Поле ввода" в Windows SDK.

Дополнительные сведения о CEdit см. в разделах: