CEdit::SetHandle

void SetHandle ( HLOCAL hBuffer );

Параметры

hBuffer

Содержит дескриптор для локальной памяти. Этот дескриптор должен быть создан с помощью предыдущего вызова реализации LocalAlloc Windows функции с использованием флага LMEM_MOVEABLE . Предполагается, что память будет содержать строку, оканчивающуюся нулем. Если это не так, первый байт выделенной памяти должен быть установлен на 0.

Примечания

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

Эта функция-член обрабатывается только элементов управления многострочного редактирования.

Прежде чем приложение задает новый дескриптор памяти, следует использовать функцию-член GetHandle для получения дескриптора в текущий буфер памяти и освободить эту память с помощью функции LocalFree Windows.

SetHandle очищает буфер отмены (функция-член CanUndo возвращает 0) и внутренние изменения флага (функция-член GetModify возвращает 0). Перерисовать окно управления edit.

Можно использовать эту функцию-член в элементе управления многострочного редактирования в диалоговом окне, только если вы создали диалоговым окном с установленным флагом стиля DS_LOCALEDIT.

Примечаниеnbsp;GetHandle не будет работать с Windows 95.  Если вызвать GetHandle в Windows 95, он будет возвращать &NULL. GetHandle будет работать соответствующим образом документирована в Windows NT версии 3.51 и выше.

Для получения дополнительной информации, смотрите EM_SETHANDLE реализации LocalAllocи LocalFree в документации Win32.

Обзор CEditЧлены класса | Иерархическая схема

См. также CEdit::CanUndo, CEdit::GetHandle, CEdit::GetModify

Index