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

DocumentIDO ID do documento de onde copiar as páginas
RangeListAs páginas a extrair, por exemplo "10,15,18-20,25-35". Caracteres inválidos na string serão ignorados.
OptionsOptions 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

0O 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
1As páginas foram copiadas com sucesso do documento informado para o documento selecionado