PdfPages Class
Represents an intermediate node in a page tree, called a page tree node.
public sealed class PdfPages : PdfPageObject, IList<PdfPage>, ICollection<PdfPage>, IEnumerable<PdfPage>, IEnumerable
Public NotInheritable Class PdfPages
Inherits PdfPageObject
Implements IList(Of PdfPage), ICollection(Of PdfPage), IEnumerable(Of PdfPage), IEnumerable
- Inheritance:
- PdfPages
Implements
Properties
Count
(Required) The number of leaf nodes (page objects) that are descendants of this node within the page tree.
Property Value
The number of leaf nodes (page objects) that are descendants of this node within the page tree.
Item[Int32]
Gets or sets the PdfPage at the specified index.
public PdfPage this[int index] { get; set; }
Public Property Item(index As Integer) As PdfPage
Parameters
Property Value
Kids
(Required) An array of indirect references to the immediate children of this node. The children shall only be page objects or other page tree nodes.
public PdfPageObjectCollection Kids { get; }
Public ReadOnly Property Kids As PdfPageObjectCollection
Property Value
An array of indirect references to the immediate children of this node.
See Also
Methods
Add()
Returns
AddClone(PdfPage)
public PdfPage AddClone(PdfPage source)
Public Function AddClone(source As PdfPage) As PdfPage
Parameters
Returns
Exceptions
source
is null.
Clear()
Removes all PdfPages from the PdfCollection.
Contains(PdfPage)
Determines whether a PdfPage is in the collection.
Parameters
Returns
- System.Boolean
true if item
is found in the collection; otherwise, false.
CopyTo(PdfPage[], Int32)
Copies the entire collection to a compatible one-dimensional array, starting at the specified index of the target array.
public void CopyTo(PdfPage[] array, int arrayIndex)
Public Sub CopyTo(array As PdfPage(), arrayIndex As Integer)
Parameters
array
- PdfPage[]
arrayIndex
- Int32
The zero-based index in array
at which copying begins.
Exceptions
array
is null.
- System.ArgumentOutOfRangeException
arrayIndex
is less than 0 or greater than array
's Length.
The number of elements in the source PdfPages is greater than the available space from arrayIndex
to the end of the destination array
.
GetEnumerator()
Returns an enumerator that iterates through the collection of PdfPages.
public PdfPages.Enumerator GetEnumerator()
Public Function GetEnumerator As PdfPages.Enumerator
Returns
An enumerator for the collection of PdfPages.
IndexOf(PdfPage)
Searches for the specified PdfPage and returns the zero-based index of the first occurrence within the entire collection.
Parameters
Returns
The zero-based index of the first occurrence of item
within the entire collection, if found; otherwise, –1.
Insert(Int32)
Parameters
Returns
Exceptions
- System.ArgumentOutOfRangeException
index
is less than 0 or greater than Count.
InsertClone(Int32, PdfPage)
public PdfPage InsertClone(int index, PdfPage source)
Public Function InsertClone(index As Integer, source As PdfPage) As PdfPage
Parameters
Returns
Exceptions
source
is null.
Move(Int32, Int32)
Moves the PdfPage at the specified index to a new location in the collection.
public void Move(int oldIndex, int newIndex)
Public Sub Move(oldIndex As Integer, newIndex As Integer)
Parameters
Remove(PdfPage)
Removes the first occurrence of a specific PdfPage from the collection.
Parameters
Returns
- System.Boolean
true if item
is successfully removed; otherwise, false. This method also returns false if item
was not found in the collection.
RemoveAt(Int32)
Removes the PdfPage at the specified index of the collection.
Parameters
Inherited Properties
CropBox | (Optional; inheritable) A rectangle, expressed in default user space units, that shall define the visible region of default user space. When the page is displayed or printed, its contents shall be clipped (cropped) to this rectangle and then shall be imposed on the output medium in some implementation-defined manner (see 14.11.2, "Page Boundaries"). Default value: the value of MediaBox. Value of this property might be null if this is an instance of a PdfPages, but it should never be null if this is an instance of a PdfPage. (Inherited from PdfPageObject) |
MediaBox | (Required; inheritable) A rectangle (see 7.9.5, "Rectangles"), expressed in default user space units, that shall define the boundaries of the physical medium on which the page shall be displayed or printed (see 14.11.2, "Page Boundaries"). Value of this property might be null if this is an instance of a PdfPages, but it should never be null if this is an instance of a PdfPage. (Inherited from PdfPageObject) |
Metadata | (Optional; PDF 1.4) A metadata stream containing metadata for the component. (Inherited from PdfObject) |
Parent | (Required except in root node; prohibited in the root node; shall be an indirect reference) The page tree node that is the immediate parent of this one. (Inherited from PdfPageObject) |
Rotate | (Optional; inheritable) The number of degrees by which the page shall be rotated clockwise when displayed or printed. The value shall be a multiple of 90. Default value: 0. (Inherited from PdfPageObject) |
Inherited Methods
SetCropBox(Double, Double) | Sets the CropBox. (Inherited from PdfPageObject) |
SetCropBox(Double, Double, Double, Double) | Sets the CropBox. (Inherited from PdfPageObject) |
SetMediaBox(Double, Double) | Sets the MediaBox. (Inherited from PdfPageObject) |
SetMediaBox(Double, Double, Double, Double) | Sets the MediaBox. (Inherited from PdfPageObject) |