StartRenderPageJob
Inspección de documentos, renderización
Descripción
Inicia un trabajo en segundo plano que renderiza una página de un archivo PDF sin bloquear el subproceso del llamador
Como TPDFlib no es seguro para subprocesos, el trabajo crea una instancia aislada desde el mismo archivo de origen y se ejecuta en una tarea del sistema, por lo que una página grande ya no puede ocupar el hilo anfitrión hasta finalizar
El trabajo conecta al renderizador una marca de cancelación y una puerta de pausa de restablecimiento manual, que se consultan entre operadores del 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 si el PDF no está cifrado |
| OutputFileName | La ruta de la 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 1 que se va a renderizar |
| Options | La opción de formato de imagen que se pasa directamente a RenderPageToFile |
Valores devueltos
| >0 | Un identificador de trabajo basado en uno para utilizarlo con los métodos de control de trabajos de renderizado |
|---|---|
| 0 | No se pudo iniciar el trabajo |
Observaciones
Consulte el progreso mediante GetRenderJobState y bloquee mediante WaitForRenderJob; ambas funciones devuelven los códigos RENDER_JOB_STATE_*
Utilice PauseRenderJob, ResumeRenderJob y CancelRenderJob para interrumpir una página en ejecución sin perder el hilo de trabajo
La instancia que inició el trabajo es su propietaria; al liberar la instancia se espera a que terminen los trabajos pendientes, por lo que una página a medio terminar nunca sobrevive a su propietaria