SetMissingGlyphCallback

Texto, fontes, callbacks

Descrição

Registra um callback opcional que pode observar um escalar Unicode faltante e escolher comportamento de reporte ou de abort para esse evento

Sintaxe

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);

Parâmetros

CodePoint	O valor escalar Unicode completo
UTF16Index	O índice de origem com base zero do escalar ou do cluster com shaping
Page	O número da página selecionada, com base 1, ou zero quando nenhuma página está ativa
FontName	O programa de fonte selecionado ou o nome do recurso
Operation	A operação de texto que detectou o glifo faltante
Action	A política atual na entrada; retorne ou atribua 0 para reportar e descartar, ou 1 para abortar

Valores retornados

Os métodos de registro retornam 1 para uma instância válida

Observações

O evento é adicionado ao relatório retido antes de o callback executar

Ponteiros de texto da DLL são somente leitura e válidos apenas pela duração do callback

Exceções que cruzem a fronteira de callback da DLL ou do ActiveX são contidas e caem no comportamento de relatar e descartar

Veja também

SetMissingGlyphPolicy, GetMissingGlyphReportJSON