API Help
Eplan.EplApi.DataModel Namespace / Page Class
Members Example

In This Topic
    Page Class
    In This Topic
    Page class represents an EPLAN project's page.
    Inheritance Hierarchy

    System.Object
       Eplan.EplApi.DataModel.StorableObject
          Eplan.EplApi.DataModel.Placement
             Eplan.EplApi.DataModel.Group
                Eplan.EplApi.DataModel.DocumentBase
                   Eplan.EplApi.DataModel.Page

    Syntax
    public class Page : DocumentBase, IWriteProtection  
    public ref class Page : public DocumentBase, IWriteProtection  
    Remarks
    Some properties of the class are not linked with their owners even if from the syntax it may seem otherwise. This concerns NameParts property and array properties like : AllFirstLevelPlacements, AllGraphicalPlacements, AllPlacements, Functions, PLCs, PlugStrips, TerminalStrips.
    Example
    The following example shows how to use class Page.
    PagePropertyList oPPL = new PagePropertyList();
    oPPL.DESIGNATION_LOCATION = "A";
    oPPL.DESIGNATION_PLANT = "O";
    Page oPage = new Page(m_oTestProject, DocumentTypeManager.DocumentType.Circuit, oPPL);
    
    
    Public Constructors
     NameDescription
    Public ConstructorOverloaded.   
    Top
    Public Properties
     NameDescription
    Public PropertyAll Placements including Groups placed on this page. They are not filtered. All returned Placements are placed directly on this page. This method does not return embedded objects (like for example Eplan.EplApi.DataModel.Graphics.Shielding).  
    Public PropertyAll Eplan.EplApi.DataModel.Graphics.GraphicalPlacements placed on this page. They are not filtered. This method does not return embedded objects (like for example Eplan.EplApi.DataModel.Graphics.Shielding).  
    Public PropertyAll Placements, placed on this page. Groups are ungrouped and contained Placements are returned. They are not filtered. This method does not return embedded objects (like for example Eplan.EplApi.DataModel.Graphics.Shielding). This method does not return Eplan.EplApi.DataModel.Graphics.PropertyPlacement.  
    Public PropertyReturns all BoxedDevices placed on the page. If the filter was set up, returns BoxedDevices matching the filter.  
    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 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 PropertyPage's property that allows to access current page's filter. It affects properties "Functions", "Terminals", "TerminalStrips", "Plugs", "PlugStrips" and "PLCs".  
    Public PropertyReturns all Functions placed on the page. If the filter was set up, returns Functions matching the filter.  
    Public PropertyGets/sets the size of the page's grid.  
    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 identifying name of the page.  
    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 if the page is a logical page.  
    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 Page and it was not assigned a Project,

    it is a Placement or any class derived from it and was not assigned a 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 PropertyGet or set the placement's location. (Inherited from Eplan.EplApi.DataModel.DocumentBase)
    Public PropertyPage's property describing type of macro. This type is used to find a suitable variant of macro, which can be insert on this page. While inserting macro on page, inserting variant of macro is get from page's MacroRepresentationType and variant of macro defined by user. This property depends on property PageType.  
    Public PropertyGet or set name of the page. When setting this property, it is not checked whether the given name already exists in project.  
    Public PropertyGets/Sets the name of a page.  
    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 PropertyGets/sets a page's property describing type of document  
    Public PropertyReturns name of the page's type.  
    Public PropertyGet or set planning objects to which this page is assigned or null.  
    Public PropertyReturns all Eplan.EplApi.DataModel.EObjects.PLCs placed on the page. If the filter was set up, returns BoxedDevices matching the filter.  
    Public PropertyReturns the page PlotFrame.  
    Public PropertyReturns all Eplan.EplApi.DataModel.EObjects.PlugStrips placed on the page. If the filter was set up, returns Eplan.EplApi.DataModel.EObjects.PlugStrips matching the filter.  
    Public PropertyReturns the project the StorableObject belongs to. (Inherited from Eplan.EplApi.DataModel.StorableObject)
    Public PropertyProperty enabling access to internal properties of the Page object.  
    Public PropertyReportBlock which contains data describing report from this page.  
    Public PropertyReturns the exact size of the page, takes into account page scale. The size is calculated from center of border lines.  
    Public PropertyReturns all grouped Placements. (Inherited from Eplan.EplApi.DataModel.Group)
    Public PropertyReturns all Eplan.EplApi.DataModel.EObjects.TerminalStrips placed on the page. If the filter was set up, returns Eplan.EplApi.DataModel.EObjects.TerminalStrips matching the filter.  
    Public PropertyReturns the type of the object as number. (Inherited from Eplan.EplApi.DataModel.StorableObject)
    Public PropertyCheck if object is currently write protected or sets Manual write protection  
    Top
    Public Methods
     NameDescription
    Public MethodConverts all symbols and connections on the page into graphical instances. Graphical instances of a given symbol are automatically grouped.  
    Public MethodOverloaded. Creates copy of this page.  
    Public MethodOverloaded. Creates a new Page object. It is placed in the project under location given as parameters.  
    Public MethodOverloaded. Remove all Placements only from a group and it's sub groups. If true method will remove also SubGroups. (Inherited from Eplan.EplApi.DataModel.Group)
    Public MethodDestructor. (Inherited from Eplan.EplApi.DataModel.StorableObject)
    Public MethodOperator of comparison implementation. Checks if two StorableObjects refer to the same object in the project. (Inherited from Eplan.EplApi.DataModel.StorableObject)
    Public MethodOverridden. Placement bounding box. Bounding box is a rectangle which contain this placement. It can be also used to determine placement size.  
    Public MethodServes as the default hash function. (Inherited from Eplan.EplApi.DataModel.StorableObject)
    Public MethodChecks if a specific write protection kind was set.  
    Public MethodInsert Placement to a group. (Inherited from Eplan.EplApi.DataModel.Group)
    Public MethodInsert Placements to a group. (Inherited from Eplan.EplApi.DataModel.Group)
    Public MethodCheck if the Group is editable. (Inherited from Eplan.EplApi.DataModel.Group)
    Public MethodReturns true, if group is valid if not, the group should be dissolved (Inherited from Eplan.EplApi.DataModel.Group)
    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 MethodMove all Placements in a group by a Eplan.EplApi.Base.PointD given as param. (Inherited from Eplan.EplApi.DataModel.Group)
    Public MethodTemporarily disables write protection. Note that current write protection  
    Public MethodOverridden. Removes placement.  
    Public MethodOverloaded. Remove Placement from the group and from the project. The Placement object passed into this method is no longer valid. (Inherited from Eplan.EplApi.DataModel.Group)
    Public MethodOverloaded. Remove Placements from the group and from the project. The Placement objects passed into this method are no longer valid. (Inherited from Eplan.EplApi.DataModel.Group)
    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 X axis factor. E.g. value of 2 makes the width two times bigger.Y axis factor. E.g. value of 0.5 makes the height two times smaller.Scaling origin point. (Inherited from Eplan.EplApi.DataModel.Placement)
    Public MethodSets the name of the page. Name parts should be given in the PagePropertyList.  
    Public MethodAssigns a page to a given project.  
    Public MethodTries to lock current object. If object is Placement - it's page will be locked as well; Eplan.EplApi.DataModel.E3D.Placement3D locks it's installation space; Function locks all it's connections and connection definition points; Page locks all placements from this page. Throws Eplan.EplApi.Base.LockingException on failure. (Inherited from Eplan.EplApi.DataModel.StorableObject)
    Public MethodReturns this object as string identifier. (Inherited from Eplan.EplApi.DataModel.StorableObject)
    Public MethodOverloaded. Remove Placements only from a group. (Inherited from Eplan.EplApi.DataModel.Group)
    Top
    See Also