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

Parameter Name	Description
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 scheme 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
System.ArgumentException	Thrown in case of invalid arguments. Thrown when one of the arguments passed to the method was not valid. 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.
System.UnauthorizedAccessException	Thrown when the user has no rights to create files on the file system or when a write operation is not allowed on the specified file.
System.ApplicationException	The internal interface for image export could not be created.
Eplan.EplApi.Base.BaseException	Errors occurred during export. See the exception message for details.
System.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.
System.MemberAccessException	Thrown when one of the arguments specified in the application programming interface (API) call is already in use in another thread.
System.IO.InternalBufferOverflowException	Thrown when a buffer specified as an argument in the API call is not large enough to hold the data to be received.
System.NotSupportedException	Thrown when the method is not implemented or when the specified image file format is not known.
System.IO.FileNotFoundException	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.
System.NotImplementedException	Thrown when the method is not implemented.
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

Use the Eplan Global Support Portal for feedback and support