pdfium/
action.rs

1// PDFium-rs -- Modern Rust wrapper to PDFium, the PDF library from Google
2//
3// Copyright (c) 2025 Martin van der Werff <github (at) newinnovations.nl>
4//
5// This file is part of PDFium-rs.
6//
7// PDFium-rs is free software: you can redistribute it and/or modify it under the terms of
8// the GNU General Public License as published by the Free Software Foundation, either version 3
9// of the License, or (at your option) any later version.
10//
11// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR
12// IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
13// FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
14// DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
15// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
16// BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
17// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
18// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
19
20use crate::{
21    error::{PdfiumError, PdfiumResult},
22    pdfium_types::FPDF_ACTION,
23};
24
25/// # Rust interface to FPDF_ACTION
26pub struct PdfiumAction {
27    handle: FPDF_ACTION,
28}
29
30impl PdfiumAction {
31    pub(crate) fn new_from_handle(handle: FPDF_ACTION) -> PdfiumResult<Self> {
32        if handle.is_null() {
33            Err(PdfiumError::NullHandle)
34        } else {
35            #[cfg(feature = "debug_print")]
36            println!("New action {handle:?}");
37            Ok(Self { handle })
38        }
39    }
40}
41
42impl From<&PdfiumAction> for FPDF_ACTION {
43    fn from(value: &PdfiumAction) -> Self {
44        value.handle
45    }
46}
47
48// TODO: check lifecycle FPDF_ACTION
49
50impl Drop for PdfiumAction {
51    /// Closes this [`PdfiumAction`], releasing held memory.
52    fn drop(&mut self) {
53        #[cfg(feature = "debug_print")]
54        println!("Closing action {:?}", self.handle);
55    }
56}
pdfium/action.rs

pdfium/
action.rs
