Функция ScriptStringXtoCP (usp10.h)

Статья
08/26/2023

Преобразует координату x в позицию символа.

Синтаксис

HRESULT ScriptStringXtoCP(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [in]  int                    iX,
  [out] int                    *piCh,
  [out] int                    *piTrailing
);

Параметры

[in] ssa

Структура SCRIPT_STRING_ANALYSIS для строки.

[in] iX

Координата Х.

[out] piCh

Указатель на переменную, в которой эта функция получает позицию символа, соответствующую координате x.

[out] piTrailing

Указатель на переменную, в которой эта функция получает значение, указывающее, является ли координата x для переднего края или конечного края позиции символа. Дополнительные сведения см. в разделе «Примечания».

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

В случае успешного выполнения возвращает S_OK. Функция возвращает ненулевое значение HRESULT, если не удалось. Приложение может проверить возвращаемое значение с помощью макросов SUCCEEDED и FAILED .

Если координата x соответствует переднему краю символа, значение piTrailing равно 0. Если координата x соответствует конечной границе символа, значением piTrailing является положительное целое число. Что касается ScriptXtoCP, значение равно 1 для символа, который можно отрисовыть самостоятельно. Значение больше 1, если символ является частью кластера в скрипте, для которого курсоры не размещены в кластере, чтобы указать смещение до следующей допустимой позиции логического курсора.

Если координата X находится перед началом строки, функция получает значение -1 для piCh и 1 для piTrailing, указывая конечный край несуществующего символа перед строкой. Если координата x находится после конца строки, функция получает для piCh первый индекс, превышающий длину строки, и 0 для piTrailing. Значение 0 указывает на передний край несуществующего символа после строки.

Важно Начиная с Windows 8. Чтобы поддерживать возможность запуска в Windows 7, модуль, использующий Uniscribe, должен указать Usp10.lib перед gdi32.lib в списке библиотек.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	usp10.h
Библиотека	Usp10.lib
DLL	Usp10.dll
Распространяемые компоненты	Internet Обозреватель 5 или более поздней версии в Windows Me/98/95

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

SCRIPT_STRING_ANALYSIS

Одноимесяца

Функции uniscribe

Share via