Share via

Структура GETTEXTEX (richedit.h)

  • Статья

Содержит сведения, используемые для получения текста из элемента управления расширенным редактированием. Эта структура используется с сообщением EM_GETTEXTEX .

Синтаксис

typedef struct _gettextex {
  DWORD  cb;
  DWORD  flags;
  UINT   codepage;
  LPCSTR lpDefaultChar;
  LPBOOL lpUsedDefChar;
} GETTEXTEX;

Члены

cb

Тип: DWORD

Размер (в байтах) буфера, используемого для хранения полученного текста.

flags

Тип: DWORD

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

Значение Значение
GT_DEFAULT
 Весь текст извлекается в соответствии со следующими критериями:
  • Возврат каретки (U+000D) не преобразуется в CRLF (U+000D U+000A).
  • Символы структуры таблиц и математических объектов удаляются (см. GT_RAWTEXT).
  • Включается скрытый текст.
  • Номера списка не включаются.
GT_NOHIDDENTEXT
 Скрытый текст не включается в полученный текст.
GT_RAWTEXT
 Текст извлекается точно так, как он отображается в памяти. Сюда входят специальные символы структуры для разделителей строк и ячеек таблицы (см. примечания для EM_INSERTTABLE), а также разделители математических объектов (начальный разделитель U+FDD0, разделитель аргументов U+FDEE и конечный разделитель U+FDDF) и маркеры объектов (U+FFFC). Это обеспечивает выравнивание позиций символов между извлеченным текстом и текстом в памяти.
GT_SELECTION
 Получение текста для текущего выделенного фрагмента.
GT_USECRLF
 При копировании текста преобразуйте каждый cr в cr/LF.

codepage

Тип: UINT

Кодовая страница, используемая в переводе. Это CP_ACP для кодовой страницы ANSI и 1200 для Юникода.

lpDefaultChar

Тип: LPCSTR

Символ, используемый, если расширенный символ не может быть представлен на указанной кодовой странице. Он используется только в том случае, если кодовая страница не имеет значения 1200 (Юникод). Если этот элемент имеет значение NULL, используется системное значение по умолчанию.

lpUsedDefChar

Тип: LPBOOL

Флаг, указывающий, использовался ли символ по умолчанию (lpDefaultChar). Этот элемент используется только в том случае, если кодовая страница не имеет значения 1200 или не CP_UTF8 (Юникод). Флаг имеет значение TRUE , если один или несколько расширенных символов в исходной строке не могут быть представлены на указанной кодовой странице. В противном случае флаг имеет значение FALSE. Этот элемент может иметь значение NULL.

Комментарии

Сообщение EM_GETTEXTEX выполняется быстрее, если lpDefaultChar и lpUsedDefChar имеют значение NULL.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть richedit.h

См. также раздел

EM_GETTEXTEX