Eplan Platform API
Eplan.EplApi.DataModel.Graphics Namespace / Comment Class
Members Example

Comment Class
Represents a comment on page which was imported from PDF file.
Inheritance Hierarchy

System.Object
   Eplan.EplApi.DataModel.StorableObject
      Eplan.EplApi.DataModel.Placement
         Eplan.EplApi.DataModel.Graphics.GraphicalPlacement
            Eplan.EplApi.DataModel.Graphics.TextBase
               Eplan.EplApi.DataModel.Graphics.Text
                  Eplan.EplApi.DataModel.Graphics.Comment

Syntax
public class Comment : Text 
Example
The following example shows how to collect comments from opened project.
//find all comment objects in project
DMObjectsFinder oFinder = new DMObjectsFinder(m_oTestProject);
Comment[] arrComments = oFinder.GetStorableObjects(null).OfType<Comment>().ToArray();

//Work on all found comments
foreach (Comment oComment in arrComments)
{
    Console.WriteLine("--- New comment found ---\n");

    //Write to console needed information about comment
    Console.WriteLine(
        "Author: {0}\nContent: {1}\nAnswer: {2}\n Page name: {3}\n",
        oComment.Author,
        oComment.Contents.GetAsString(),
        oComment.Answer,
        oComment.Page.Name);

    //change the state of comment
    oComment.ReviewState = Comment.Enums.ReviewStateType.Accepted;
}

Public Constructors
 NameDescription
Public ConstructorConstructor.  
Top
Public Properties
 NameDescription
Public PropertySpecifies that height is fixed. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySpecifies that width is fixed. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySpecifies the height of alignment box. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySpecifies that words are wrapped. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySpecifies that breaks are removed. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySpecifies the width of alignment box. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyAll answers given to this comment combined into one text.  
Public PropertyWindows login name of the person who originally created the PDF comment.  
Public PropertyContents of object represented by this type. (Inherited from Eplan.EplApi.DataModel.Graphics.Text)
Public PropertyDate and time when PDF comment was created by the author.  
Public PropertyReturns an array of objects cross-referenced with this object (i.e. having the same name - in case of functions - or otherwise associated) (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public PropertyReturns the project as number. The number is unique for all open projects in one session. The number changes when the project is closed and opened again. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public PropertySpecifies docking direction for text. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyReturns the alignment box type (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySets display sequence. The drawing order flag will be used to sort elements according to drawing order within a group. If elements chare the same value the drawing order will result from order of the data model. Default value is 67. (Inherited from Eplan.EplApi.DataModel.Placement)
Public PropertyReturns the text box type (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySpecifies language for text when property LanguageMode value is set to LangModeFix. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyFont for displayed text. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyReturns a group that the Placement object belongs to. If the Placement object doesn't belong to any group, NULL is returned. (Inherited from Eplan.EplApi.DataModel.Placement)
Public PropertyReturns true if the Text has an alignment box. In GUI it's 'Activate alignment box' checkbox. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyReturns height of the Text. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyGets/sets the flag which corresponds to "Do not translate automatically" checkbox in GUI. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyGets/Sets a value that indicates whether the text is docked or not. Setting IsDocked to true is possible only on PropertyPlacement object which Parent is a SymbolReference object. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyReturns true if the leader line is activated (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public Property

Determines if the the StorableObject is locked.

The StorableObject is locked when it was explicitly or implicitly locked.

(Inherited from Eplan.EplApi.DataModel.StorableObject)
Public PropertyReturns true if the placement is placed (Inherited from Eplan.EplApi.DataModel.Placement)
Public PropertyDetermines if StorableObject is read-only (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public PropertyGets/Sets visibility of the object as set in its properties dialog. (Inherited from Eplan.EplApi.DataModel.Placement)
Public Property

Determines if the the StorableObject is transient.

The StorableObject is transient when it was created by default constructor and:

it is a Eplan.EplApi.DataModel.Page and it was not assigned a Eplan.EplApi.DataModel.Project,

it is a Eplan.EplApi.DataModel.Placement or any class derived from it and was not assigned a Eplan.EplApi.DataModel.Page.

(Inherited from Eplan.EplApi.DataModel.StorableObject)
Public PropertyDetermines if StorableObject is correct database object and is not deleted. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public PropertyGets/Sets the actual visibility state of the object. (Inherited from Eplan.EplApi.DataModel.Graphics.GraphicalPlacement)
Public PropertyReturns the justification of the Text. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySpecifies language mode of text. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyGets or sets object's graphical layer. If object is not assigned to a project (Project is null), null is returned (Inherited from Eplan.EplApi.DataModel.Graphics.GraphicalPlacement)
Public PropertyGets layer id of layer assigned to this object. (Inherited from Eplan.EplApi.DataModel.Graphics.GraphicalPlacement)
Public PropertyGet or set the placement's location. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyShows when the PDF comment was last changed by the author.  
Public PropertyReturns the object identifier as number. The number is unique for all objects of this type. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public PropertyReturns the page the Placement is on, or assigns a Page object to the placement. If the placement was previously assigned to another page, it is removed from old one and assigned to the page given as an argument. (Inherited from Eplan.EplApi.DataModel.Placement)
Public PropertySpecifies the Paragraph Spacing. This property is used for PropertyPlacemets attributes. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySet / Get Parameters of the text (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySets Pen related to this object. (Inherited from Eplan.EplApi.DataModel.Graphics.GraphicalPlacement)
Public PropertyReturns the project the StorableObject belongs to. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public Property.NET Property enabling access to P8 properties of the Comment object.  
Public PropertyState of the comment.  
Public PropertyReturns the rotation of the Text, in radians. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertySpecifies the Row Spacing. This property is used for PropertyPlacemets attributes. From layer: -16002, Single: 100, 1.5 lines: 150, Double: 200. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyColor for displayed text. Color index (0-255) Please use -16002 as "From layer" value.

Predefined values for line color index are:

0 = black

1 = red

2 = yellow

3 = green

4 = cyan

5 = blue

6 = magenta

7 = white

252 = darkgray

253 = gray

(Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public PropertyReturns the type of the object as number. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Top
Public Methods
 NameDescription
Public MethodOverloaded. Copy Placement and insert the Copy into destination group. Copied placement will be inserted into desired project of destination group. If this placement is temporary, the copy will be persistent, if the destination group is also persistent. Group or Page, where the placement will be inserted. Defines whether a layer should be matched by name. (Inherited from Eplan.EplApi.DataModel.Placement)
Public MethodOverloaded. Creates the Text object. (Inherited from Eplan.EplApi.DataModel.Graphics.Text)
Public MethodCreates transient and not placed Text object. (Inherited from Eplan.EplApi.DataModel.Graphics.Text)
Public MethodDestructor. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public MethodDocks one text to another. You can see how it works in GUI. Select element on schematic, display properties, show property placements and dock / undock them. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public MethodOperator of comparison implementation. Checks if two StorableObjects refer to the same object in the project. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public MethodPlacement bounding box. Bounding box is a rectangle which contain this placement. It can be also used to determine placement size. (Inherited from Eplan.EplApi.DataModel.Graphics.Text)
Public MethodReturns formated display string of the content (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Public MethodServes as the default hash function. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public MethodReturns object type name. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public MethodTries to lock current object in database for exclusive access. Throws Eplan.EplApi.Base.LockingException on failure. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public MethodRemoves placement. (Inherited from Eplan.EplApi.DataModel.Placement)
Public MethodOverloaded. Scales the placement (or group of placements) by the specified factors in X and Y axis with scaling origin point specified by the ptOrigin parameter. (Inherited from Eplan.EplApi.DataModel.Placement)
Public MethodThis method sets the visibility of the graphical instance to depend on the layer setting (Inherited from Eplan.EplApi.DataModel.Graphics.GraphicalPlacement)
Public MethodTries to lock current object. If object is Eplan.EplApi.DataModel.Placement - it's page will be locked as well; Eplan.EplApi.DataModel.E3D.Placement3D locks it's installation space; Eplan.EplApi.DataModel.Function locks all it's connections and connection definition points; Eplan.EplApi.DataModel.Page locks all placements from this page. Throws Eplan.EplApi.Base.LockingException on failure. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public MethodTransforms this Text instance into a PathText instance. (Inherited from Eplan.EplApi.DataModel.Graphics.Text)
Public MethodReturns this object as string identifier. (Inherited from Eplan.EplApi.DataModel.StorableObject)
Public MethodUndock text from another oner one. You can see how it works in GUI. Select element on schematic, display properties, show property placements and dock / undock them. (Inherited from Eplan.EplApi.DataModel.Graphics.TextBase)
Top
See Also