Hide Table of Contents

Insert SimpleNote Example (VB.NET)

This example shows how to insert and change a SimpleNote in a drawing document.

' Preconditions:
' 1. Create a VB.NET Windows console project.
' 2. Copy and paste this example into the VB.NET IDE.
' 3. Add a reference to:
'    install_dir\APISDK\tlb\DraftSight.Interop.dsAutomation.dll
' 4. Start DraftSight and open a document.
' 5. Start debugging the project.
' Postconditions: 
' 1. A message box pops up when a SimpleNote is
'    inserted in the drawing.
' 2. The selection filter is set to select SimpleNotes only and
'    is activated.
' 3. The SimpleNote is selected and its text changed. Examine 
'    the drawing to verify.
Imports DraftSight.Interop.dsAutomation
Module Module1
    Sub Main()
        Dim dsApp As Application
        Dim dsDoc As Document
        Dim dsModel As Model
        Dim dsSketchManager As SketchManager
        Dim dsSimpleNote As SimpleNote
        Dim startX, startY, startZ As Double
        Dim noteValue As String
        Dim angle, height As Double
        'Connect to DraftSight
        dsApp = GetObject(, "DraftSight.Application")
	dsApp.AbortRunningCommand() ' abort any command currently running in DraftSight to avoid nested commands
        'Get active document
        dsDoc = dsApp.GetActiveDocument()
        If Not dsDoc Is Nothing Then
            'Get model space
            dsModel = dsDoc.GetModel()
            'Get Sketch Manager
            dsSketchManager = dsModel.GetSketchManager()
            'SimpleNote parameters (angle value should be passed in radians)
            startX = 0.0#
            startY = 0.0#
            startZ = 0.0#
            noteValue = "Sample text"
            angle = 3.14159265358979 / 4 '45 degrees in radians
            height = 1.0#
            'Add a SimpleNote
            dsSimpleNote = dsSketchManager.InsertSimpleNote(startX, startY, startZ, height, angle, noteValue)
            If Not dsSimpleNote Is Nothing Then
                MsgBox("A SimpleNote was added to drawing.")
            End If
            MsgBox("There are no open documents in DraftSight.")
        End If

	'Change SimpleNote text
        ChangeSimpleNotesText(dsDoc, dsSketchManager)
    End Sub
    Sub ChangeSimpleNotesText(ByVal dsDoc As Document, ByVal dsSketchManager As SketchManager)
        'Get Selection Manager
        Dim dsSelectionMgr As SelectionManager = dsDoc.GetSelectionManager()
        'Get selection filter
        Dim dsSelectioFilter As SelectionFilter = dsSelectionMgr.GetSelectionFilter()
        'Clear selection filter
        'Add filter to get only SimpleNotes
        'Activate selection filter
        dsSelectioFilter.Active = True
        'Get all Layers in drawing
        Dim layerNames As String() = GetLayerNames(dsDoc)
        'Get SimpleNote entities
        Dim entityObjects As Object
        Dim entityTypes As Object
        dsSketchManager.GetEntities(dsSelectioFilter, layerNames, entityTypes, entityObjects)
        If entityObjects IsNot Nothing AndAlso entityTypes IsNot Nothing Then
            Dim dsEntityArray As Object() = DirectCast(entityObjects, Object())
            Const newNoteValue As String = "New sample text"
            'Iterate through all SimpleNote entities
            For index As Integer = 0 To dsEntityArray.Length - 1
                'Cast the selected object to SimpleNote
                Dim dsSimpleNote As SimpleNote = TryCast(dsEntityArray(index), SimpleNote)
                'Get SimpleNote text
                Dim noteValue As String = dsSimpleNote.Contents
                'Set new text for SimpleNote
                dsSimpleNote.Contents = newNoteValue
        End If
    End Sub
    Function GetLayerNames(ByVal dsDoc As Document) As String()
        Dim layerNames As String() = Nothing
        Dim dsLayerManager As LayerManager = dsDoc.GetLayerManager()
        Dim dsLayers As Object() = DirectCast(dsLayerManager.GetLayers(), Object())
        If dsLayers IsNot Nothing Then
            layerNames = New String(dsLayers.Length - 1) {}
            For index As Integer = 0 To dsLayers.Length - 1
                Dim dsLayer As Layer = TryCast(dsLayers(index), Layer)
                layerNames(index) = dsLayer.Name
        End If
        Return layerNames
    End Function
End Module

End Module

Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

Subject:   Feedback on Help Topics
Page:   Insert SimpleNote Example (VB.NET)
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:


We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again

Web Help Content Version: API Help (English only) 2024 SP02

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.