pub struct PdfPageAnnotationObjects<'a> { /* private fields */ }Expand description
The page objects contained within a single PdfPageAnnotation.
Content in an annotation is structured as a stream of PdfPageObject objects of different types: text objects, image objects, path objects, and so on.
Note that Pdfium does not support or recognize all PDF page object types. For instance,
Pdfium does not currently support or recognize the External Object (“XObject”) page object type
supported by Adobe Acrobat and Foxit’s commercial PDF SDK. In these cases, Pdfium will return
PdfPageObjectType::Unsupported.
Page objects can be retrieved from any type of PdfPageAnnotation, but Pdfium currently
only permits adding new page objects to, or removing existing page objects from, annotations
of types PdfPageAnnotationType::Ink and PdfPageAnnotationType::Stamp. All other annotation
types are read-only.
Auto Trait Implementations§
impl<'a> !RefUnwindSafe for PdfPageAnnotationObjects<'a>
impl<'a> !Send for PdfPageAnnotationObjects<'a>
impl<'a> !Sync for PdfPageAnnotationObjects<'a>
impl<'a> Unpin for PdfPageAnnotationObjects<'a>
impl<'a> !UnwindSafe for PdfPageAnnotationObjects<'a>
Blanket Implementations§
source§impl<'a, T> PdfPageObjectsCommon<'a> for Twhere
T: PdfPageObjectsPrivate<'a>,
impl<'a, T> PdfPageObjectsCommon<'a> for Twhere T: PdfPageObjectsPrivate<'a>,
source§fn get(&self, index: usize) -> Result<PdfPageObject<'a>, PdfiumError>
fn get(&self, index: usize) -> Result<PdfPageObject<'a>, PdfiumError>
Returns a single PdfPageObject from this page objects collection.
source§fn iter(&'a self) -> PdfPageObjectsIterator<'a> ⓘ
fn iter(&'a self) -> PdfPageObjectsIterator<'a> ⓘ
Returns an iterator over all the PdfPageObject objects in this page objects collection.
source§fn add_object(
&mut self,
object: PdfPageObject<'a>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn add_object( &mut self, object: PdfPageObject<'a> ) -> Result<PdfPageObject<'a>, PdfiumError>
Adds the given PdfPageObject to this page objects collection. The object’s
memory ownership will be transferred to the
PdfPage containing this page objects
collection, and the updated page object will be returned. Read moresource§fn create_text_object(
&mut self,
x: PdfPoints,
y: PdfPoints,
text: impl ToString,
font: &PdfFont<'_>,
font_size: PdfPoints
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_text_object( &mut self, x: PdfPoints, y: PdfPoints, text: impl ToString, font: &PdfFont<'_>, font_size: PdfPoints ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPageTextObject at the given x and y page co-ordinates
from the given arguments and adds it to this page objects collection,
returning the text object wrapped inside a generic PdfPageObject wrapper. Read more
source§fn create_path_object_line(
&mut self,
x1: PdfPoints,
y1: PdfPoints,
x2: PdfPoints,
y2: PdfPoints,
stroke_color: PdfColor,
stroke_width: PdfPoints
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_path_object_line( &mut self, x1: PdfPoints, y1: PdfPoints, x2: PdfPoints, y2: PdfPoints, stroke_color: PdfColor, stroke_width: PdfPoints ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPagePathObject for the given line, with the given
stroke settings applied. The new path object will be added to this page objects collection
and then returned, wrapped inside a generic PdfPageObject wrapper. Read more
source§fn create_path_object_bezier(
&mut self,
x1: PdfPoints,
y1: PdfPoints,
x2: PdfPoints,
y2: PdfPoints,
control1_x: PdfPoints,
control1_y: PdfPoints,
control2_x: PdfPoints,
control2_y: PdfPoints,
stroke_color: PdfColor,
stroke_width: PdfPoints
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_path_object_bezier( &mut self, x1: PdfPoints, y1: PdfPoints, x2: PdfPoints, y2: PdfPoints, control1_x: PdfPoints, control1_y: PdfPoints, control2_x: PdfPoints, control2_y: PdfPoints, stroke_color: PdfColor, stroke_width: PdfPoints ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPagePathObject for the given cubic Bézier curve, with the given
stroke settings applied. The new path object will be added to this page objects collection
and then returned, wrapped inside a generic PdfPageObject wrapper. Read more
source§fn create_path_object_rect(
&mut self,
rect: PdfRect,
stroke_color: Option<PdfColor>,
stroke_width: Option<PdfPoints>,
fill_color: Option<PdfColor>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_path_object_rect( &mut self, rect: PdfRect, stroke_color: Option<PdfColor>, stroke_width: Option<PdfPoints>, fill_color: Option<PdfColor> ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPagePathObject for the given rectangle, with the given
fill and stroke settings applied. Both the stroke color and the stroke width must be
provided for the rectangle to be stroked. The new path object will be added to
this page objects collection and then returned, wrapped inside a generic
PdfPageObject wrapper. Read more
source§fn create_path_object_circle(
&mut self,
rect: PdfRect,
stroke_color: Option<PdfColor>,
stroke_width: Option<PdfPoints>,
fill_color: Option<PdfColor>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_path_object_circle( &mut self, rect: PdfRect, stroke_color: Option<PdfColor>, stroke_width: Option<PdfPoints>, fill_color: Option<PdfColor> ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPagePathObject. The new path will be created with a circle that fills
the given rectangle, with the given fill and stroke settings applied. Both the stroke color
and the stroke width must be provided for the circle to be stroked. The new path object
will be added to this page objects collection and then returned, wrapped inside a generic
PdfPageObject wrapper. Read more
source§fn create_path_object_circle_at(
&mut self,
center_x: PdfPoints,
center_y: PdfPoints,
radius: PdfPoints,
stroke_color: Option<PdfColor>,
stroke_width: Option<PdfPoints>,
fill_color: Option<PdfColor>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_path_object_circle_at( &mut self, center_x: PdfPoints, center_y: PdfPoints, radius: PdfPoints, stroke_color: Option<PdfColor>, stroke_width: Option<PdfPoints>, fill_color: Option<PdfColor> ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPagePathObject. The new path will be created with a circle centered
at the given coordinates, with the given radius, and with the given fill and stroke settings
applied. Both the stroke color and the stroke width must be provided for the circle to be
stroked. The new path object will be added to this page objects collection and then
returned, wrapped inside a generic PdfPageObject wrapper. Read more
source§fn create_path_object_ellipse(
&mut self,
rect: PdfRect,
stroke_color: Option<PdfColor>,
stroke_width: Option<PdfPoints>,
fill_color: Option<PdfColor>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_path_object_ellipse( &mut self, rect: PdfRect, stroke_color: Option<PdfColor>, stroke_width: Option<PdfPoints>, fill_color: Option<PdfColor> ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPagePathObject. The new path will be created with an ellipse that fills
the given rectangle, with the given fill and stroke settings applied. Both the stroke color
and the stroke width must be provided for the ellipse to be stroked. The new path object
will be added to this page objects collection and then returned, wrapped inside a generic
PdfPageObject wrapper. Read more
source§fn create_path_object_ellipse_at(
&mut self,
center_x: PdfPoints,
center_y: PdfPoints,
x_radius: PdfPoints,
y_radius: PdfPoints,
stroke_color: Option<PdfColor>,
stroke_width: Option<PdfPoints>,
fill_color: Option<PdfColor>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_path_object_ellipse_at( &mut self, center_x: PdfPoints, center_y: PdfPoints, x_radius: PdfPoints, y_radius: PdfPoints, stroke_color: Option<PdfColor>, stroke_width: Option<PdfPoints>, fill_color: Option<PdfColor> ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPagePathObject. The new path will be created with an ellipse centered
at the given coordinates, with the given radii, and with the given fill and stroke settings
applied. Both the stroke color and the stroke width must be provided for the ellipse to be
stroked. The new path object will be added to this page objects collection and then
returned, wrapped inside a generic PdfPageObject wrapper. Read more
source§fn create_image_object(
&mut self,
x: PdfPoints,
y: PdfPoints,
image: &DynamicImage,
width: Option<PdfPoints>,
height: Option<PdfPoints>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn create_image_object( &mut self, x: PdfPoints, y: PdfPoints, image: &DynamicImage, width: Option<PdfPoints>, height: Option<PdfPoints> ) -> Result<PdfPageObject<'a>, PdfiumError>
Creates a new PdfPageImageObject at the given x and y page co-ordinates
from the given arguments and adds it to this page objects collection,
returning the image object wrapped inside a generic PdfPageObject wrapper. Read more
source§fn remove_object(
&mut self,
object: PdfPageObject<'a>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn remove_object( &mut self, object: PdfPageObject<'a> ) -> Result<PdfPageObject<'a>, PdfiumError>
Removes the given PdfPageObject from this page objects collection. The object’s
memory ownership will be removed from the
PdfPage containing this page objects
collection, and the updated page object will be returned. It can be added back to a
page objects collection or dropped, at which point the memory owned by the object will
be freed. Read moresource§fn remove_object_at_index(
&mut self,
index: usize
) -> Result<PdfPageObject<'a>, PdfiumError>
fn remove_object_at_index( &mut self, index: usize ) -> Result<PdfPageObject<'a>, PdfiumError>
Removes the PdfPageObject at the given index from this page objects collection.
The object’s memory ownership will be removed from the
PdfPage containing this page objects
collection, and the updated page object will be returned. It can be added back into a
page objects collection or discarded, at which point the memory owned by the object will
be freed. Read moresource§fn as_range(&self) -> Range<PdfPageObjectIndex>
fn as_range(&self) -> Range<PdfPageObjectIndex>
Returns a Range from
0..(number of objects) for this page objects collection.source§fn as_range_inclusive(&self) -> RangeInclusive<PdfPageObjectIndex>
fn as_range_inclusive(&self) -> RangeInclusive<PdfPageObjectIndex>
Returns an inclusive Range from
0..=(number of objects - 1) for this page objects collection.source§fn first(&self) -> Result<PdfPageObject<'a>, PdfiumError>
fn first(&self) -> Result<PdfPageObject<'a>, PdfiumError>
Returns the first PdfPageObject in this page objects collection.
source§fn last(&self) -> Result<PdfPageObject<'a>, PdfiumError>
fn last(&self) -> Result<PdfPageObject<'a>, PdfiumError>
Returns the last PdfPageObject in this page objects collection.
source§fn add_text_object(
&mut self,
object: PdfPageTextObject<'a>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn add_text_object( &mut self, object: PdfPageTextObject<'a> ) -> Result<PdfPageObject<'a>, PdfiumError>
Adds the given PdfPageTextObject to this page objects collection,
returning the text object wrapped inside a generic PdfPageObject wrapper. Read more
source§fn add_path_object(
&mut self,
object: PdfPagePathObject<'a>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn add_path_object( &mut self, object: PdfPagePathObject<'a> ) -> Result<PdfPageObject<'a>, PdfiumError>
Adds the given PdfPagePathObject to this page objects collection,
returning the path object wrapped inside a generic PdfPageObject wrapper. Read more
source§fn add_image_object(
&mut self,
object: PdfPageImageObject<'a>
) -> Result<PdfPageObject<'a>, PdfiumError>
fn add_image_object( &mut self, object: PdfPageImageObject<'a> ) -> Result<PdfPageObject<'a>, PdfiumError>
Adds the given PdfPageImageObject to this page objects collection,
returning the image object wrapped inside a generic PdfPageObject wrapper. Read more