SetNames Method (ActiveX)

Specifies the color name and book name of the color.

Supported platforms: Windows only

Signature

VBA:

object.SetNames ColorName, ColorBook

object

Type: AcCmColor

The object this method applies to.

ColorName

Access: Input-only

Type: String

The name of the color.

BookName

Access: Input-only

Type: String

The color book name of the color.

Return Value (RetVal)

No return value.

Remarks

No additional remarks.

Examples

VBA:

Sub Example_SetNames()
    'This example draws a circle and
    'returns the color name and color book name of the color.

    Dim cir As AcadCircle
    Dim pt(0 To 2) As Double
    Set cir = ThisDrawing.ModelSpace.AddCircle(pt, 2)

    Dim col As AcadAcCmColor
    Set col = cir.TrueColor
    col.SetRGB 125, 175, 235
    col.SetNames "MyColor", "MyColorBook"
    cir.TrueColor = col

    ZoomAll
    
    Dim retCol As AcadAcCmColor
    Set retCol = cir.TrueColor
    MsgBox "BookName=" & col.BookName & vbLf & _
           "ColorName=" & col.ColorName
End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_SetNames()
    ;; This example draws a circle and
    ;; returns the color name and color book name of the color.
    (setq acadObj (vlax-get-acad-object)
          doc (vla-get-ActiveDocument acadObj))
        
    (setq pt (vlax-3d-point 0 0 0))

    (setq modelSpace (vla-get-ModelSpace doc) 
          cir (vla-AddCircle modelSpace pt 2))

    (setq col (vla-get-TrueColor cir))
    (vla-SetRGB col 125 175 235)
    (vla-SetNames col "MyColor" "MyColorBook")
    (vla-put-TrueColor cir col)

    (vla-ZoomAll acadObj)
    
    (setq retCol (vla-get-TrueColor cir))
    (alert (strcat "BookName=" (vla-get-BookName col)
                   "\nColorName=" (vla-get-ColorName col)
           )
    )
)