Remove メソッド(ActiveX)

名前の付いたオブジェクトをディクショナリから除去します。

サポートされているプラットフォーム: Windows のみ

構文と要素

VBA:

RetVal = object.Remove(Name)

object

タイプ: Dictionary

このメソッドが適用されるオブジェクト。

Name

アクセス: 入力のみ

タイプ: 文字列

ディクショナリから除去されるオブジェクトの名前(キーワード)。

戻り値(RetVal)

タイプ: Object

ディクショナリから除去されるオブジェクト。

注意

たとえば、「FirstKeyword」という名前のオブジェクトを次のようなディクショナリから除去します。

• MyDictionary
• Keyword オブジェクト
• FirstKeyword Object1
• SecondKeyword Object2

ディクショナリは次のようになります。

• MyDictionary
• Keyword Object
• SecondKeyword Object2

例

VBA:

Sub Example_Remove()
    ' This example creates a dictionary and adds
    ' a custom object to that dictionary. It then
    ' removes the object from the dictionary.
    
    Dim dictObj As AcadDictionary
    Set dictObj = ThisDrawing.Dictionaries.Add("TEST_DICTIONARY")
    
    ' Load the ObjectARX application that defines the custom object.
    ' Note: The application listed here does not exist and
    ' will cause an error when run. Change the application name
    ' to the path and name of your ObjectARX Application.
    ThisDrawing.Application.LoadArx "MyARXApp.arx"
    
    ' Create the custom object in the dictionary
    Dim keyName As String
    Dim className As String
    Dim customObj As AcadObject
    
    keyName = "OBJ1"
    className = "CAsdkDictObject"
    
    Set customObj = dictObj.AddObject(keyName, className)
    
    ' Remove the object from the dictionary using the keyName
    dictObj.Remove keyName
    
End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_Remove()
    ;; This example creates a dictionary and adds
    ;; a custom object to that dictionary. It then
    ;; removes the object from the dictionary.
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))
    (setq dictionaries (vla-get-Dictionaries doc))
  
    (setq dictObj (vla-Add dictionaries "TEST_DICTIONARY"))
    
    ;; Load the ObjectARX application that defines the custom object.
    ;; Note: The application listed here does not exist and
    ;; will cause an error when run. Change the application name
    ;; to the path and name of your ObjectARX Application.
    (vla-LoadArx acadObj "MyARXApp.arx")
    
    ;; Create the custom object in the dictionary
    (setq keyName "OBJ1")
    (setq className "CAsdkDictObject")
    
    (setq customObj (vla-AddObject dictObj keyName className))
    
    ;; Remove the object from the dictionary using the keyName
    (vla-Remove dictObj keyName)
)