Vanilla.PDF  2.2.1
Cross-platform toolkit for creating and modifying PDF documents
c_destinations.h
Go to the documentation of this file.
1#ifndef _C_DESTINATIONS_H
2#define _C_DESTINATIONS_H
3
7
8#ifdef __cplusplus
9extern "C"
10{
11#endif
12
94 typedef enum {
95 DestinationType_Undefined = 0,
96
104
116
125
134
147
159
168
178
194 VANILLAPDF_API error_type CALLING_CONVENTION Destination_CreateFromArray(ArrayObjectHandle* array_handle, DestinationHandle** result);
195
206 VANILLAPDF_API error_type CALLING_CONVENTION Destination_CreateFromDictionary(DictionaryObjectHandle* dict_handle, DestinationHandle** result);
207
211 VANILLAPDF_API error_type CALLING_CONVENTION Destination_GetDestinationType(DestinationHandle* handle, DestinationType* result);
212
225 VANILLAPDF_API error_type CALLING_CONVENTION Destination_GetPageNumber(DestinationHandle* handle, ObjectHandle** result);
226
230 VANILLAPDF_API error_type CALLING_CONVENTION Destination_ToUnknown(DestinationHandle* handle, IUnknownHandle** result);
231
235 VANILLAPDF_API error_type CALLING_CONVENTION Destination_FromUnknown(IUnknownHandle* handle, DestinationHandle** result);
236
248 VANILLAPDF_API error_type CALLING_CONVENTION XYZDestination_FromDestination(DestinationHandle* handle, XYZDestinationHandle** result);
249
253 VANILLAPDF_API error_type CALLING_CONVENTION XYZDestination_ToDestination(XYZDestinationHandle* handle, DestinationHandle** result);
254
259 VANILLAPDF_API error_type CALLING_CONVENTION XYZDestination_GetLeft(XYZDestinationHandle* handle, ObjectHandle** result);
260
265 VANILLAPDF_API error_type CALLING_CONVENTION XYZDestination_GetTop(XYZDestinationHandle* handle, ObjectHandle** result);
266
271 VANILLAPDF_API error_type CALLING_CONVENTION XYZDestination_GetZoom(XYZDestinationHandle* handle, ObjectHandle** result);
272
277 VANILLAPDF_API error_type CALLING_CONVENTION XYZDestination_Release(XYZDestinationHandle* handle);
278
290 VANILLAPDF_API error_type CALLING_CONVENTION FitDestination_FromDestination(DestinationHandle* handle, FitDestinationHandle** result);
291
295 VANILLAPDF_API error_type CALLING_CONVENTION FitDestination_ToDestination(FitDestinationHandle* handle, DestinationHandle** result);
296
301 VANILLAPDF_API error_type CALLING_CONVENTION FitDestination_Release(FitDestinationHandle* handle);
302
310 VANILLAPDF_API error_type CALLING_CONVENTION FitHorizontalDestination_FromDestination(DestinationHandle* handle, FitHorizontalDestinationHandle** result);
311 VANILLAPDF_API error_type CALLING_CONVENTION FitHorizontalDestination_ToDestination(FitHorizontalDestinationHandle* handle, DestinationHandle** result);
312
317 VANILLAPDF_API error_type CALLING_CONVENTION FitHorizontalDestination_GetTop(FitHorizontalDestinationHandle* handle, ObjectHandle** result);
318
319 VANILLAPDF_API error_type CALLING_CONVENTION FitHorizontalDestination_Release(FitHorizontalDestinationHandle* handle);
320
328 VANILLAPDF_API error_type CALLING_CONVENTION FitVerticalDestination_FromDestination(DestinationHandle* handle, FitVerticalDestinationHandle** result);
329 VANILLAPDF_API error_type CALLING_CONVENTION FitVerticalDestination_ToDestination(FitVerticalDestinationHandle* handle, DestinationHandle** result);
330
335 VANILLAPDF_API error_type CALLING_CONVENTION FitVerticalDestination_GetLeft(FitVerticalDestinationHandle* handle, ObjectHandle** result);
336
337 VANILLAPDF_API error_type CALLING_CONVENTION FitVerticalDestination_Release(FitVerticalDestinationHandle* handle);
338
346 VANILLAPDF_API error_type CALLING_CONVENTION FitRectangleDestination_FromDestination(DestinationHandle* handle, FitRectangleDestinationHandle** result);
347 VANILLAPDF_API error_type CALLING_CONVENTION FitRectangleDestination_ToDestination(FitRectangleDestinationHandle* handle, DestinationHandle** result);
348
353 VANILLAPDF_API error_type CALLING_CONVENTION FitRectangleDestination_GetLeft(FitRectangleDestinationHandle* handle, ObjectHandle** result);
354
360
365 VANILLAPDF_API error_type CALLING_CONVENTION FitRectangleDestination_GetRight(FitRectangleDestinationHandle* handle, ObjectHandle** result);
366
371 VANILLAPDF_API error_type CALLING_CONVENTION FitRectangleDestination_GetTop(FitRectangleDestinationHandle* handle, ObjectHandle** result);
372
373 VANILLAPDF_API error_type CALLING_CONVENTION FitRectangleDestination_Release(FitRectangleDestinationHandle* handle);
374
382 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxDestination_FromDestination(DestinationHandle* handle, FitBoundingBoxDestinationHandle** result);
383 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxDestination_ToDestination(FitBoundingBoxDestinationHandle* handle, DestinationHandle** result);
384 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxDestination_Release(FitBoundingBoxDestinationHandle* handle);
385
393 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxHorizontalDestination_FromDestination(DestinationHandle* handle, FitBoundingBoxHorizontalDestinationHandle** result);
394 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxHorizontalDestination_ToDestination(FitBoundingBoxHorizontalDestinationHandle* handle, DestinationHandle** result);
395
401
402 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxHorizontalDestination_Release(FitBoundingBoxHorizontalDestinationHandle* handle);
403
411 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxVerticalDestination_FromDestination(DestinationHandle* handle, FitBoundingBoxVerticalDestinationHandle** result);
412 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxVerticalDestination_ToDestination(FitBoundingBoxVerticalDestinationHandle* handle, DestinationHandle** result);
413
419
420 VANILLAPDF_API error_type CALLING_CONVENTION FitBoundingBoxVerticalDestination_Release(FitBoundingBoxVerticalDestinationHandle* handle);
421
426 VANILLAPDF_API error_type CALLING_CONVENTION Destination_Release(DestinationHandle* handle);
427
438 VANILLAPDF_API error_type CALLING_CONVENTION NamedDestinations_Contains(NamedDestinationsHandle* handle, const NameObjectHandle* name, boolean_type* result);
439
448 VANILLAPDF_API error_type CALLING_CONVENTION NamedDestinations_Find(NamedDestinationsHandle* handle, const NameObjectHandle* name, DestinationHandle** result);
449
454 VANILLAPDF_API error_type CALLING_CONVENTION NamedDestinations_Release(NamedDestinationsHandle* handle);
455
458#ifdef __cplusplus
459};
460#endif
461
462#endif /* _C_DESTINATIONS_H */
This file contains macro declarations for importing and exporting symbols from library boundaries.
This file contains all type forward declarations returned by the library API.
This file contains types and constants used as parameters or return values.
An array object is a one-dimensional collection of objects arranged sequentially.
Base class for all destinations.
error_type CALLING_CONVENTION Destination_CreateFromArray(ArrayObjectHandle *array_handle, DestinationHandle **result)
Create a destination from an array object.
error_type CALLING_CONVENTION Destination_GetDestinationType(DestinationHandle *handle, DestinationType *result)
Get the type of destination to determine available parameters.
error_type CALLING_CONVENTION Destination_CreateFromDictionary(DictionaryObjectHandle *dict_handle, DestinationHandle **result)
Create a destination from a dictionary object.
error_type CALLING_CONVENTION Destination_ToUnknown(DestinationHandle *handle, IUnknownHandle **result)
Reinterpret current object as IUnknownHandle.
error_type CALLING_CONVENTION Destination_GetPageNumber(DestinationHandle *handle, ObjectHandle **result)
The page of the document that shall be displayed.
error_type CALLING_CONVENTION Destination_FromUnknown(IUnknownHandle *handle, DestinationHandle **result)
Convert IUnknownHandle to DestinationHandle.
A dictionary object is an associative table containing pairs of objects.
FitB destination that fits bounding box within window.
FitBH destination with vertical coordinate at top of bounding box.
error_type CALLING_CONVENTION FitBoundingBoxHorizontalDestination_GetTop(FitBoundingBoxHorizontalDestinationHandle *handle, ObjectHandle **result)
Get the top coordinate for FitBoundingBoxHorizontal destination (null means no change).
FitBV destination with horizontal coordinate at left of bounding box.
error_type CALLING_CONVENTION Destination_Release(DestinationHandle *handle)
Decrement the internal reference counter.
error_type CALLING_CONVENTION FitBoundingBoxVerticalDestination_GetLeft(FitBoundingBoxVerticalDestinationHandle *handle, ObjectHandle **result)
Get the left coordinate for FitBoundingBoxVertical destination (null means no change).
Fit destination that fits the entire page within the window.
error_type CALLING_CONVENTION FitDestination_FromDestination(DestinationHandle *handle, FitDestinationHandle **result)
Convert destination to Fit destination if the type matches.
error_type CALLING_CONVENTION FitDestination_ToDestination(FitDestinationHandle *handle, DestinationHandle **result)
Convert Fit destination back to base destination.
error_type CALLING_CONVENTION FitDestination_Release(FitDestinationHandle *handle)
Decrement the internal reference counter.
FitH destination with vertical coordinate at top edge.
error_type CALLING_CONVENTION FitHorizontalDestination_GetTop(FitHorizontalDestinationHandle *handle, ObjectHandle **result)
Get the top coordinate for FitHorizontal destination (null means no change).
FitR destination that fits specified rectangle within window.
error_type CALLING_CONVENTION FitRectangleDestination_GetLeft(FitRectangleDestinationHandle *handle, ObjectHandle **result)
Get the left coordinate for FitRectangle destination.
error_type CALLING_CONVENTION FitRectangleDestination_GetTop(FitRectangleDestinationHandle *handle, ObjectHandle **result)
Get the top coordinate for FitRectangle destination.
error_type CALLING_CONVENTION FitRectangleDestination_GetRight(FitRectangleDestinationHandle *handle, ObjectHandle **result)
Get the right coordinate for FitRectangle destination.
error_type CALLING_CONVENTION FitRectangleDestination_GetBottom(FitRectangleDestinationHandle *handle, ObjectHandle **result)
Get the bottom coordinate for FitRectangle destination.
FitV destination with horizontal coordinate at left edge.
error_type CALLING_CONVENTION FitVerticalDestination_GetLeft(FitVerticalDestinationHandle *handle, ObjectHandle **result)
Get the left coordinate for FitVertical destination (null means no change).
Base class for reference counting.
A name object is an atomic symbol uniquely defined by a sequence of characters.
A map of unique names mapped to their associated a DestinationHandle.
error_type CALLING_CONVENTION NamedDestinations_Contains(NamedDestinationsHandle *handle, const NameObjectHandle *name, boolean_type *result)
Determine if current map contains name.
error_type CALLING_CONVENTION NamedDestinations_Release(NamedDestinationsHandle *handle)
Decrement the internal reference counter.
error_type CALLING_CONVENTION NamedDestinations_Find(NamedDestinationsHandle *handle, const NameObjectHandle *name, DestinationHandle **result)
Find mapped value for key name.
Base class for syntactic tokens.
XYZ destination with optional left, top, and zoom parameters.
error_type CALLING_CONVENTION XYZDestination_GetZoom(XYZDestinationHandle *handle, ObjectHandle **result)
Get the zoom factor for XYZ destination (null means no change).
error_type CALLING_CONVENTION XYZDestination_GetTop(XYZDestinationHandle *handle, ObjectHandle **result)
Get the top coordinate for XYZ destination (null means no change).
error_type CALLING_CONVENTION XYZDestination_Release(XYZDestinationHandle *handle)
Decrement the internal reference counter.
error_type CALLING_CONVENTION XYZDestination_GetLeft(XYZDestinationHandle *handle, ObjectHandle **result)
Get the left coordinate for XYZ destination (null means no change).
error_type CALLING_CONVENTION XYZDestination_FromDestination(DestinationHandle *handle, XYZDestinationHandle **result)
Convert destination to XYZ destination if the type matches.
error_type CALLING_CONVENTION XYZDestination_ToDestination(XYZDestinationHandle *handle, DestinationHandle **result)
Convert XYZ destination back to base destination.
DestinationType
Available destination types.
Definition c_destinations.h:94
@ DestinationType_XYZ
Display the page designated by page, with the coordinates (left, top) positioned at the upper-left co...
Definition c_destinations.h:103
@ DestinationType_FitBoundingBoxHorizontal
Display the page designated by page, with the vertical coordinate top positioned at the top edge of t...
Definition c_destinations.h:167
@ DestinationType_Fit
Display the page designated by page, with its contents magnified just enough to fit the entire page w...
Definition c_destinations.h:115
@ DestinationType_FitBoundingBoxVertical
Display the page designated by page, with the horizontal coordinate left positioned at the left edge ...
Definition c_destinations.h:176
@ DestinationType_FitRectangle
Display the page designated by page, with its contents magnified just enough to fit the rectangle spe...
Definition c_destinations.h:146
@ DestinationType_FitVertical
Display the page designated by page, with the horizontal coordinate left positioned at the left edge ...
Definition c_destinations.h:133
@ DestinationType_FitHorizontal
Display the page designated by page, with the vertical coordinate top positioned at the top edge of t...
Definition c_destinations.h:124
@ DestinationType_FitBoundingBox
Display the page designated by page, with its contents magnified just enough to fit its bounding box ...
Definition c_destinations.h:158
uint32_t error_type
This is return value type of all API functions.
Definition c_types.h:25
int8_t boolean_type
Boolean type supported in C.
Definition c_types.h:31