IPXV_ImportConverter::Convert Method

From PDF XChange PDF SDK
Jump to: navigation, search
m (Automatic page editing by robot)
 
(5 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
[[Category:Editor]]
 
[[Category:Editor]]
 
{{#customTitle:IPXV_ImportConverter::Convert Method}}
 
{{#customTitle:IPXV_ImportConverter::Convert Method}}
{{#parentPage:PXV:IPXV_ImportConverter#Methods|Convert Method|method}}
+
{{#parentPage:PXV:IPXV_ImportConverter#Methods|Convert|method}}
{{ToWrite}}
+
 
{{ToReview}}
 
{{ToReview}}
  
The method of interface of PDF-XChange Editor SDK.
+
Converts the given data to the [[PXV:IPXC_Document|IPXC_Document]] if the data format is supported by the converter.
  
 
== Syntax ==
 
== Syntax ==
Line 16: Line 15:
 
                 [in, defaultvalue(0)]    HANDLE_T        hWndParent,
 
                 [in, defaultvalue(0)]    HANDLE_T        hWndParent,
 
                 [in, defaultvalue(NULL)]  IUnknown*        pCtx,
 
                 [in, defaultvalue(NULL)]  IUnknown*        pCtx,
                 [out, retval]            IPXC_Document**  ppDoc);</pre>
+
                 [out, retval]            IPXC_Document**  pDoc);</pre>
  
 
== Parameters ==
 
== Parameters ==
 
;pInst
 
;pInst
:[in]  Pointer to [[PXV:IPXV_Inst|IPXV_Inst]].
+
:[in]  Pointer to [[PXV:IPXV_Inst|IPXV_Inst]] containing the instance of the program.
 
;pSrc
 
;pSrc
:[in]  Pointer to IUnknown*.
+
:[in]  Pointer to IUnknown* containing the source data. This should be cast to the data type that is supported by the converter. For example, the Image to PDF converter checks whether this pointer is an [[PXV:IIXC_Image|IIXC_Image]].
 
;nFlags
 
;nFlags
:[in, defaultvalue(0)]  Value of ULONG.
+
:[in, defaultvalue(0)]  Value of ULONG containing the [[PXV:PXV_FmtCheckFlags|format check flags]].
 
;pParams
 
;pParams
:[in, defaultvalue(NULL)]  Pointer to [[PXV:ICab|ICab]].
+
:[in, defaultvalue(NULL)]  Pointer to [[PXV:ICab|ICab]] containing the advanced format details cab node.
 
;pProgress
 
;pProgress
:[in, defaultvalue(NULL)]  Pointer to [[PXV:IProgressMon|IProgressMon]].
+
:[in, defaultvalue(NULL)]  Pointer to [[PXV:IProgressMon|IProgressMon]] containing the custom progress monitor.
 
;hWndParent
 
;hWndParent
:[in, defaultvalue(0)]  Value of HANDLE_T.
+
:[in, defaultvalue(0)]  Value of HANDLE_T containing the parent window handle.
 
;pCtx
 
;pCtx
:[in, optional]  Pointer to IUnknown*.
+
:[in, defaultvalue(NULL)]  Pointer to IUnknown* containing an additional convertor's context.
;ppDoc
+
;pDoc
:[out, retval]  Pointer to [[PXV:IPXC_Document|IPXC_Document]].
+
:[out, retval]  Pointer to [[PXV:IPXC_Document|IPXC_Document]] containing the resulting document when the conversion was successful.
  
 
== Return Value ==
 
== Return Value ==
Line 40: Line 39:
  
 
== See Also ==
 
== See Also ==
[[PXV:IPXV_ImportConverter|IPXV_ImportConverter]].
+
[[PXV:IPXV_ImportConverter|IPXV_ImportConverter]]

Latest revision as of 01:35, 27 April 2017


Converts the given data to the IPXC_Document if the data format is supported by the converter.

Syntax

HRESULT Convert([in]                      IPXV_Inst*       pInst,
                [in]                      IUnknown*        pSrc,
                [in, defaultvalue(0)]     ULONG            nFlags,
                [in, defaultvalue(NULL)]  ICab*            pParams,
                [in, defaultvalue(NULL)]  IProgressMon*    pProgress,
                [in, defaultvalue(0)]     HANDLE_T         hWndParent,
                [in, defaultvalue(NULL)]  IUnknown*        pCtx,
                [out, retval]             IPXC_Document**  pDoc);

Parameters

pInst
[in] Pointer to IPXV_Inst containing the instance of the program.
pSrc
[in] Pointer to IUnknown* containing the source data. This should be cast to the data type that is supported by the converter. For example, the Image to PDF converter checks whether this pointer is an IIXC_Image.
nFlags
[in, defaultvalue(0)] Value of ULONG containing the format check flags.
pParams
[in, defaultvalue(NULL)] Pointer to ICab containing the advanced format details cab node.
pProgress
[in, defaultvalue(NULL)] Pointer to IProgressMon containing the custom progress monitor.
hWndParent
[in, defaultvalue(0)] Value of HANDLE_T containing the parent window handle.
pCtx
[in, defaultvalue(NULL)] Pointer to IUnknown* containing an additional convertor's context.
pDoc
[out, retval] Pointer to IPXC_Document containing the resulting document when the conversion was successful.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IPXV_ImportConverter