Skip to main content

pdfkit/
action_goto.rs

1use std::ptr;
2
3use crate::destination::PdfDestination;
4use crate::error::Result;
5use crate::ffi;
6use crate::handle::ObjectHandle;
7use crate::util::take_string;
8
9#[derive(Debug, Clone)]
10pub struct PdfActionGoTo {
11    handle: ObjectHandle,
12}
13
14impl PdfActionGoTo {
15    pub(crate) fn from_handle(handle: ObjectHandle) -> Self {
16        Self { handle }
17    }
18
19    pub fn new(destination: &PdfDestination) -> Result<Self> {
20        let mut out_action = ptr::null_mut();
21        let mut out_error = ptr::null_mut();
22        let status = unsafe {
23            ffi::pdf_action_goto_new(destination.as_handle_ptr(), &mut out_action, &mut out_error)
24        };
25        crate::util::status_result(status, out_error)?;
26        Ok(Self::from_handle(crate::util::required_handle(
27            out_action,
28            "PDFActionGoTo",
29        )?))
30    }
31
32    #[must_use]
33    pub fn destination(&self) -> Option<PdfDestination> {
34        let ptr = unsafe { ffi::pdf_action_goto_destination(self.handle.as_ptr()) };
35        unsafe { ObjectHandle::from_retained_ptr(ptr) }.map(PdfDestination::from_handle)
36    }
37
38    pub fn set_destination(&self, destination: &PdfDestination) -> Result<()> {
39        let mut out_error = ptr::null_mut();
40        let status = unsafe {
41            ffi::pdf_action_goto_set_destination(
42                self.handle.as_ptr(),
43                destination.as_handle_ptr(),
44                &mut out_error,
45            )
46        };
47        crate::util::status_result(status, out_error)
48    }
49
50    #[must_use]
51    pub fn action_type(&self) -> Option<String> {
52        take_string(unsafe { ffi::pdf_action_goto_type_string(self.handle.as_ptr()) })
53    }
54
55    pub(crate) fn as_handle_ptr(&self) -> *mut core::ffi::c_void {
56        self.handle.as_ptr()
57    }
58}