StartRenderPageJob
Inspección de documentos, Renderizado
Descripción
Inicia un trabajo en segundo plano que representa una página de un archivo PDF sin bloquear el hilo de quien llama
Como TPDFlib no es seguro para subprocesos, el trabajo crea una instancia aislada a partir del mismo archivo de origen y se ejecuta en una tarea del sistema, de modo que una página grande ya no puede ocupar el subproceso anfitrión hasta que finalice
El trabajo incorpora una marca de cancelación y una puerta de pausa de restablecimiento manual al representador, que las consulta entre operadores de flujo de contenido; esto permite que PauseRenderJob, ResumeRenderJob y CancelRenderJob interrumpan una sola página en curso
Sintaxis
Delphi
Function TPDFlib.StartRenderPageJob(Const FileName, Password, OutputFileName: WideString; DPI: Double; Page, Options: Integer): Integer;DLL
int DLStartRenderPageJob(int InstanceID, const wchar_t* FileName, const wchar_t* Password, const wchar_t* OutputFileName, double DPI, int Page, int Options);ActiveX
Function PDFlib::StartRenderPageJob(FileName As String, Password As String, OutputFileName As String, DPI As Double, Page As Long, Options As Long) As LongParámetros
| FileName | La ruta del archivo PDF de origen |
|---|---|
| Password | La contraseña del documento o una cadena vacía cuando el PDF no está cifrado |
| OutputFileName | La ruta de imagen de destino; el formato sigue Options como en RenderPageToFile |
| DPI | La resolución de renderizado |
| Page | El número de página basado en uno que se representará |
| Options | La opción de formato de imagen se pasa directamente a RenderPageToFile |
Valores devueltos
| >0 | Un identificador de trabajo basado en 1 para usar con los métodos de control de trabajos de renderizado |
|---|---|
| 0 | No se pudo iniciar el trabajo |
Observaciones
Consulte el progreso con GetRenderJobState y bloquee con WaitForRenderJob; ambos devuelven los códigos RENDER_JOB_STATE_*
Use PauseRenderJob, ResumeRenderJob y CancelRenderJob para interrumpir una página en proceso sin perder el hilo de trabajo
La instancia que inició el trabajo es su propietaria; al liberar la instancia se esperan los trabajos pendientes, por lo que una página a medio terminar nunca sobrevive a su propietaria