op.document.addImage

From PDF XChange PDF SDK
Jump to: navigation, search
 
(5 intermediate revisions by 2 users not shown)
Line 2: Line 2:
 
{{#customTitle:op.document.addImage}}
 
{{#customTitle:op.document.addImage}}
 
{{#parentPage:PXV:Operations|op.document.addImage|operation}}
 
{{#parentPage:PXV:Operations|op.document.addImage|operation}}
{{ToWrite}}
+
{{SinceVersion|1.3.0.0}}
 
{{ToReview}}
 
{{ToReview}}
  
 
== Overview ==
 
== Overview ==
The operation overview...
+
The operation allows to place an image onto document's page as a part of the page's content or as stamp.
  
 
== Parameters ==
 
== Parameters ==
Line 16: Line 16:
 
| class="op_param_name" | Input
 
| class="op_param_name" | Input
 
| style="text-align:center" | Array
 
| style="text-align:center" | Array
| Array of <code>IUnknown</code>-based objects.
+
| <code>IUnknown</code>-based object containing the [[PXV:IPXC_Document|IPXC_Document]] where the image would be placed at.
 
|-
 
|-
 
| class="op_param_name" | Output
 
| class="op_param_name" | Output
 
| style="text-align:center;" | Array
 
| style="text-align:center;" | Array
| Array of <code>IUnknown</code>-based objects.
+
| <code>IUnknown</code>-based object containing the [[PXV:IPXC_Annotation|IPXC_Annotation]] when adding image as stamp or the [[PXV:INumArray|INumArray]] when adding image as content.
 
|-
 
|-
 
| class="op_param_name" | [[PXV:op_document_addImage_Options|Options]]
 
| class="op_param_name" | [[PXV:op_document_addImage_Options|Options]]
Line 34: Line 34:
 
return;
 
return;
 
int nID = Inst.Str2ID("op.document.addImage", false);
 
int nID = Inst.Str2ID("op.document.addImage", false);
PDFXEdit.IOperation pOp = Inst.CreateOp(nID);
+
PDFXEdit.IOperation Op = Inst.CreateOp(nID);
PDFXEdit.ICabNode input = pOp.Params.Root["Input"];
+
PDFXEdit.ICabNode input = Op.Params.Root["Input"];
 
input.v = Doc;
 
input.v = Doc;
PDFXEdit.ICabNode options = pOp.Params.Root["Options"];
+
PDFXEdit.ICabNode options = Op.Params.Root["Options"];
 
options["Page"].v = 0; //First page
 
options["Page"].v = 0; //First page
 
options["Pos.top"].v = 400;
 
options["Pos.top"].v = 400;
Line 48: Line 48:
 
PDFXEdit.IAFS_Name destPath = fsInst.DefaultFileSys.StringToName("D:\\TestImage.png"); //Converting string to name
 
PDFXEdit.IAFS_Name destPath = fsInst.DefaultFileSys.StringToName("D:\\TestImage.png"); //Converting string to name
 
options["Src"].v = destPath;
 
options["Src"].v = destPath;
pOp.Do();
+
Op.Do();
 
}
 
}
 
</pre>
 
</pre>

Latest revision as of 00:46, 19 April 2016

Available since API version

1.3.0.0


Overview

The operation allows to place an image onto document's page as a part of the page's content or as stamp.

Parameters

Name Type Description
Input Array IUnknown-based object containing the IPXC_Document where the image would be placed at.
Output Array IUnknown-based object containing the IPXC_Annotation when adding image as stamp or the INumArray when adding image as content.
Options Dictionary Dictionary with options of the operation.

Sample

//C#
private void AddImageToFirstPage(PDFXEdit.IPXV_Document Doc, PDFXEdit.PXV_Inst Inst)
{
	if (Doc == null)
		return;
	int nID = Inst.Str2ID("op.document.addImage", false);
	PDFXEdit.IOperation Op = Inst.CreateOp(nID);
	PDFXEdit.ICabNode input = Op.Params.Root["Input"];
	input.v = Doc;
	PDFXEdit.ICabNode options = Op.Params.Root["Options"];
	options["Page"].v = 0;	//First page
	options["Pos.top"].v = 400;
	options["Pos.left"].v = 50;
	options["Pos.right"].v = 400;
	options["Pos.bottom"].v = 50;
	options["AlignMode"].v = 1 | 4; //Horizontal and vertical center
	options["AsStamp"].v = false; //Inserting as a part of the content
	PDFXEdit.IAFS_Inst fsInst = (PDFXEdit.IAFS_Inst)Inst.GetExtension("AFS");
	PDFXEdit.IAFS_Name destPath = fsInst.DefaultFileSys.StringToName("D:\\TestImage.png"); //Converting string to name
	options["Src"].v = destPath;
	Op.Do();
}