CopyPageRangesEx
Extração, Manipulação de páginas
Descrição
Use esta função para copiar uma ou mais páginas de um documento aberto para o documento selecionado. As opções podem preservar a ordem de páginas solicitada e habilitar a reutilização semântica de recursos entre documentos de origem. O modo smart resource calcula hash dos grafos de recursos resolvidos recursivamente antes da alocação, de modo que fontes, imagens, espaços de cor, patterns, shadings e graphics states equivalentes possam compartilhar objetos de destino existentes mesmo quando os números de objeto de origem ou a ordem do dicionário diferem. Correspondências de hash recebem uma comparação estrutural, enquanto objetos de página ou optional content cíclicos e sensíveis à identidade permanecem separados
Sintaxe
Delphi
Function TPDFlib.CopyPageRangesEx(DocumentID: Integer; Const RangeList: WideString; Options: Integer): Integer;
ActiveX
Function PDFlib::CopyPageRangesEx(DocumentID As Long, RangeList As String, Options As Long) As Long
DLL
int DLCopyPageRangesEx(int InstanceID, int DocumentID, const wchar_t * RangeList, int Options);
Parâmetros
| DocumentID | O ID do documento de onde copiar as páginas |
|---|---|
| RangeList | As páginas a extrair, por exemplo "10,15,18-20,25-35". Caracteres inválidos na string serão ignorados. |
| Options | Options is a bit mask. PDF_COPY_PAGE_KEEP_ORDER (1) preserves the requested order and duplicates. PDF_COPY_PAGE_SMART_RESOURCES (2) reuses semantically equivalent resource dictionaries and streams already present in the target. Combine both flags with bitwise OR; 0 sorts the range and ignores duplicates |
Valores retornados
| 0 | O DocumentID informado não era válido, era igual ao do documento selecionado, ou o RangeList era inválido, or Options contained an unsupported bit |
|---|---|
| 1 | As páginas foram copiadas com sucesso do documento informado para o documento selecionado |