SetMissingGlyphCallback

Текст, шрифты, обратные вызовы

Описание

Регистрирует необязательный колбэк, который может наблюдать отсутствующий скаляр Unicode и выбирать поведение записи или прерывания для этого события

Синтаксис

Delphi

TPDFlibMissingGlyphEvent= Procedure(Sender: TObject;
  CodePoint: Cardinal; UTF16Index, Page: Integer;
  Const FontName, Operation: WideString; Var Action: Integer) Of Object;

PDFlib.OnMissingGlyph:= MissingGlyphHandler;

ActiveX

Function PDFlib::SetMissingGlyphCallback(Callback As Object) As Long

Function Callback.MissingGlyph(CodePoint As Long, UTF16Index As Long,
  Page As Long, FontName As String, Operation As String) As Long

DLL

typedef int (__stdcall *TPDFlibMissingGlyphCallback)(
  uint32_t CodePoint, int UTF16Index, int Page,
  const wchar_t* FontName, const wchar_t* Operation, void* UserData);

int DLSetMissingGlyphCallback(int InstanceID,
  TPDFlibMissingGlyphCallback Callback, void* UserData);

Параметры

CodePoint	Полное скалярное значение Unicode
UTF16Index	Исходный индекс скаляра или сформированного кластера с нуля
Page	Номер выбранной страницы, начиная с 1, либо ноль, если активной страницы нет
FontName	Имя выбранной шрифтовой программы или ресурса
Operation	Текстовая операция, обнаружившая отсутствие глифа
Action	Текущая политика на входе; верните или присвойте 0, чтобы сообщить и пропустить, или 1, чтобы прервать

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

Методы регистрации возвращают 1 для корректного экземпляра

Примечания

Событие добавляется в удерживаемый отчёт до запуска callback

Текстовые указатели DLL доступны только для чтения и действительны только в течение callback

Указатели текста DLL доступны только для чтения и действительны только на время callback. Исключения, пересекающие границу callback DLL или ActiveX, локализуются и сводятся к поведению «сообщить и отбросить»

См. также

SetMissingGlyphPolicy, GetMissingGlyphReportJSON