ZOrder Property

Description

Specifies the front-to-back order in which an object is displayed relative to other objects.

Property type

Read-only property

Syntax

Visual Basic
Public Property ZOrder As Long

Remarks

This relationship is maintained by storing a cardinal order position on each object. An object with a higher cardinal order is displayed in front of one with a lower cardinal number. A change in an object's ZOrder changes how objects are displayed if filled objects are displayed over other objects. The value assigned to this property can be changed internally to maintain unique values on all objects. Therefore, the value returned for this property may not be the same value to which the property was set.

Example

Example (Visual Basic)

Private Sub Form_Load()
    Dim objApp As SolidEdgeFramework.Application
    Dim objDoc As SolidEdgeDraft.DraftDocument
    Dim objSheet As SolidEdgeDraft.Sheet
    Dim objCircs As SolidEdgeFrameworkSupport.Circles2d
    Dim objCirc1 As SolidEdgeFrameworkSupport.Circle2d
    Dim objCirc2 As SolidEdgeFrameworkSupport.Circle2d
    Dim lngZorder As Long
    Dim lngZorder1 As Long
    ' Report errors
    Const PI = 3.14159265358979
    ' Create/get the application with specific settings
    On Error Resume Next
    Set objApp = GetObject(, "SolidEdge.Application")
    If Err Then
        Err.Clear
        Set objApp = CreateObject("SolidEdge.Application")
        Set objDoc = objApp.Documents.Add("SolidEdge.DraftDocument")
        objApp.Visible = True
    Else
        Set objDoc = objApp.ActiveDocument
    End If
    'getting the Active Sheet object
    Set objSheet = objDoc.ActiveSheet
    ' Get the Circles collection object
    Set objCircs = objSheet.Circles2d
    ' Ceate circle objects
    Set objCirc1 = objCircs.AddByCenterRadius(x:=0.25, y:=0.25, Radius:=0.06)
    ' Get the ZOrder of Circle objects
    lngZorder = objCirc1.ZOrder
    Set objCirc2 = objCircs.AddByCenterRadius(x:=0.25, y:=0.25, Radius:=0.06)
    ' Get the ZOrder of Circle objects
    lngZorder1 = objCirc2.ZOrder
    ' USER DISPLAY
    ' Release objects
    Set objApp = Nothing
    Set objDoc = Nothing
    Set objSheet = Nothing
    Set objCircs = Nothing
    Set objCirc1 = Nothing
    Set objCirc2 = Nothing
End Sub