DoLabel(Project,String,String,String,String,String,UInt32,UInt32,Boolean) Method

In This Topic

do a labeling for a project.

Syntax

C#
C++/CLI

public void DoLabel( 
   Project oProject,
   string strConfigScheme,
   string strFilterScheme,
   string strSortScheme,
   string strLanguage,
   string strDestinationFile,
   uint nRecordRepeat,
   uint nTaskRepeat,
   bool bShowOutput
)

public:
void DoLabel( 
   Project^ oProject,
   String^ strConfigScheme,
   String^ strFilterScheme,
   String^ strSortScheme,
   String^ strLanguage,
   String^ strDestinationFile,
   uint nRecordRepeat,
   uint nTaskRepeat,
   bool bShowOutput
)

Parameters

Parameter Name	Description
oProject	Project, for which a labeling will be done.
strConfigScheme	Name of the configuration scheme.
strFilterScheme	Name of the filter scheme.If this value is empty filter scheme name will be taken from configuration scheme
strSortScheme	Name of the sorting scheme. If this value is empty sorting scheme name will be taken from configuration scheme
strLanguage	Language used by the labeling operation, ex. de_DE, en_EN, or ??_?? for all display languages.
strDestinationFile	Destination file where the labeling results will be stored. If this parameter is empty, the destination file name is taken from the configuration selected by the strConfigScheme parameter.
nRecordRepeat	Repeating number per each record. It must be greater or equal 1
nTaskRepeat	Repeating number per task. It must be greater or equal 1.
bShowOutput	Show output file.

Exceptions

Exception	Description
System.ArgumentException	Thrown in case of invalid parameters.
System.ApplicationException	Thrown if a required internal interface could not be created.
System.ArgumentNullException	Thrown if a parameter is a `NULL` reference.
Eplan.EplApi.Base.BaseException	Thrown if an error occurred during the labeling process.

Remarks

If a user scheme is not empty, so it will be checked for existence. An ArgumentException will be thrown if it does not exist. If the user configuration scheme is empty or NULL, so the last used configuration scheme will be implicitly reused which is currently set in GUI. If filter or sort scheme is empty or NULL, its name will be taken from configuration scheme.

The destination file should have the extension .txt, .xls, .xlsx or .xml. Otherwise the given extension will be replaced with .txt per default.

Microsoft Excel application is necessary to run Labeling with output file extension set to .xls (Excel format).

In contrary to the behavior, when Labeling is executed via the Eplan ribbon, the API never considers the current selection in the project. In Eplan GUI the selection causes the filters to be ignored, in API, the filters are never ignored, when set.

Reference

Label Class
Label Members
Overload List

Use the Eplan Global Support Portal for feedback and support