GraphicPageEx(String,String,String,String,Boolean) Method

In This Topic

Exports a page of a project as image file. Eplan.EplApi.DataModel.Page.PageType of page can not be Eplan.EplApi.DataModel.DocumentTypeManager.DocumentType Returns the name of the created file.

Syntax

C#
C++/CLI

public string GraphicPageEx( 
   string strFullLinkFileName,
   string strPageName,
   string strImageDir,
   string strSchemeName,
   bool bBlackAndWhite
)

public:
String^ GraphicPageEx( 
   String^ strFullLinkFileName,
   String^ strPageName,
   String^ strImageDir,
   String^ strSchemeName,
   bool bBlackAndWhite
)

Parameters

strFullLinkFileName: Full link file name of the project, which contains the page to export.
strPageName: Name of the page to be exported.
strImageDir: Directory to which the image files will be written. If NULL or empty, a directory specified in the schema will be used. If the folder does not exist, it will be created. If the user does not have the necessary rights to access the file system, an exception will be thrown.
strSchemeName: Name of the configuration scheme to use during the export.
bBlackAndWhite: If set to true b/w images will be created. This does not influence the image format or the image size.

Return Value

The name of the created file.

Exceptions

Exception	Description
ArgumentException	Thrown in case of invalid arguments.
UnauthorizedAccessException	No user rights to create files on the \file system.
ApplicationException	The internal interface for image export could not be created.
BaseException	Errors occurred during export. See the exception message for details.
ArgumentException	Thrown when one of the arguments passed to the method was not valid.
OutOfMemoryException	Thrown when the operating system is out of memory and could not allocate memory to process the method call. For an explanation of how constructors use the OutOfMemory status, see the Remarks section at the end of this topic.
MemberAccessException	Thrown when one of the arguments specified in the application programming interface (API) call is already in use in another thread.
	Thrown when a buffer specified as an argument in the API call is not large enough to hold the data to be received.
NotSupportedException	Thrown when the method is not implemented.
	Thrown when the object is in an invalid state to satisfy the API call. For example, calling Pen::GetColor from a pen that is not a single, solid color results in a WrongState status.
UnauthorizedAccessException	Thrown when a write operation is not allowed on the specified file.
NotSupportedException	Thrown when the specified image file format is not known.
NotImplementedException	Thrown when the method is not implemented.
ArgumentException	Thrown when the object is in an invalid state to satisfy the API call. For example, calling Pen::GetColor from a pen that is not a single, solid color results in a WrongState status.
Eplan.EplApi.HEServices.Exceptions.HEServicesBase	Thrown in other cases when error hasn't own exception class or it's unspecified. Please refer to message content.

Remarks

The project "strFullLinkFileName" may be open in EPLAN or not. If the project was not already open, it will be opened and after the export it will be closed again. This function uses GDI+ library which is also used by .NET. See System.Drawing.Image

Reference

Export Class
Export Members
Overload List

Send Feedback