Insert Notes with Background Mask Example (VB.NET)

This example shows how to insert Notes with a background Mask 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.
' 5. Press F5.
'
' Postconditions:
' 1. Inserts two Notes with a blue background Mask in the drawing.
' 2. Zooms to fit the two Notes in the drawing.
' 3. Examine the drawing.
'----------------------------------------------------------------
 
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 dsNote As Note
        Dim dsColor As Color
        Dim x1, y1, z1, x2, y2, z2 As Double
        Dim strArray(0 To 1) As String
 
        'Connect to DraftSight
        dsApp = GetObject(, "DraftSight.Application")
 
        'Get active document
        dsDoc = dsApp.GetActiveDocument()

        If Not dsDoc Is Nothing Then
 
            'Get model space
            dsModel = dsDoc.GetModel()
 
            'Get Sketch Manager
            dsSketchManager = dsModel.GetSketchManager()
 
            'Note parameters
            x1 = 10.0#
            y1 = 10.0#
            z1 = 0.0#
            x2 = 60.0#
            y2 = 20.0#
            z2 = 0.0#
            strArray(0) = "First Note's text line."
            strArray(1) = "Second Note's text line."
 
            'Add a note
            dsNote = dsSketchManager.InsertNote(x1, y1, z1, x2, y2, z2, strArray)
 
            'Change height of Note text
            dsNote.TextHeight = 2
 
            'Change Note to use blue background Mask
            dsNote.UseDrawingBackgroundColor = False
            dsNote.BackgroundMask = True
            dsColor = dsNote.Color
            dsColor.SetNamedColor(dsNamedColor_e.dsNamedColor_Blue)
            dsNote.BackgroundFillColor = dsColor
 
            'Zoom to fit the Note
            dsApp.Zoom(dsZoomRange_e.dsZoomRange_Fit, NothingNothing)
 
 
        Else
 
            MsgBox("There are no open documents in DraftSight.")
 
        End If
 
    End Sub
 
End Module