CreateEntry Method （ActiveX）

签名

工 务 局：

object.CreateEntry Feature, FullFileName, AffectsGraphics, noIncrement

对象

类型：文件依赖关系

此方法适用的对象。

特征

访问：仅输入

类型：字符串

创建条目的应用程序或功能的说明。

完整文件名

访问：仅输入

类型：字符串

要存储在文件依赖关系列表中的文件的名称（必须是现有文件）。

影响图形

访问：仅输入

类型：布尔

True 表示该条目会影响图形文件的屏幕视图，特别是图形缓存;false 表示它不会影响屏幕上的视图。

无增量

访问：仅输入

类型：布尔

如果为 true，则不会增加现有条目的引用计数;false 在添加现有条目时递增引用计数。

返回值（RetVal）

无返回值。

言论

此方法采用指示功能说明的字符串。该字符串与文件依赖项列表 （FDL） 条目一起存储，并标识创建此条目的应用程序或功能，例如 Acad：：xref。不会对功能字符串执行唯一的应用程序名称检查。此方法还采用一个参数来指示存储在 FDL 中的文件的名称，并且可以包含存储的路径（如果有）。

如果未包含路径，AutoCAD 将在当前目录和 AutoCAD 支持文件搜索路径中搜索文件，并将找到的文件与条目一起存储。如果找不到文件或无法打开该文件，则不会创建任何条目并返回 0。如果找到该文件，则其时间/日期和文件大小将与条目一起存储，并为条目分配唯一索引并返回。

可以使用此方法通过将noIncrement设置为 来重新创建一组条目。这可以防止当条目已在 FDL 中时引用计数的增加。如果将noIncrement设置为 ，则可以多次添加同一条目。在这种情况下，条目的引用计数将递增，以记录该条目在FDL中引用的次数。永远不会创建重复记录。TrueFalse

发布信息

释放：AutoCAD 2000 至 AutoCAD 2017

• 此方法不再支持与文件依赖项对象一起使用。

例子

工 务 局：

Sub Example_CreateEntry()
    ' This example adds an entry to the File Dependency List, returns its Index, updates
    ' the entry, and then removes the entry.

    Dim objFDLCol As AutoCAD.AcadFileDependencies
    Dim objFDL As AutoCAD.AcadFileDependency
    
    Set objFDLCol = ThisDrawing.FileDependencies
    MsgBox "The number of entries in the File Dependency List is " & objFDLCol.Count & "."
    
    Dim FDLIndex As Long
    FDLIndex = objFDLCol.CreateEntry("acad:xref", "c:\referenced.dwg", True, True)
    MsgBox "The number of entries in the File Dependency List is " & objFDLCol.Count & "."
    
    Dim IndexNumber As Long
    IndexNumber = objFDLCol.IndexOf("acad:xref", "c:\referenced.dwg")
    Dim IndexString As String
    IndexString = CStr(IndexNumber)
    MsgBox "The index of the new entry is " & IndexString & "."
    
    objFDLCol.UpdateEntry FDLIndex
    
    objFDLCol.RemoveEntry FDLIndex, True
    MsgBox "The number of entries in the File Dependency List is " & objFDLCol.Count & "."
End Sub

Visual LISP：

(vl-load-com)
(defun c:Example_CreateEntry()
    ;; This example adds an entry to the File Dependency List, returns its Index, updates
    ;; the entry, and then removes the entry.
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))
  
    (setq objFDLCol (vla-get-FileDependencies doc))
    (alert (strcat "The number of entries in the File Dependency List is " (itoa (vla-get-Count objFDLCol)) "."))
    
    (setq FDLIndex (vla-CreateEntry objFDLCol "acad:xref" (findfile ".\\Sample\\Sheet Sets\\Architectural\\Res\\Wall Base.dwg") :vlax-true :vlax-true))
    (alert (strcat "The number of entries in the File Dependency List is " (itoa (vla-get-Count objFDLCol)) "."))
    
    (setq IndexNumber (vla-IndexOf objFDLCol "acad:xref" (findfile ".\\Sample\\Sheet Sets\\Architectural\\Res\\Wall Base.dwg")))
    (setq IndexString (itoa IndexNumber))
    (alert (strcat "The index of the new entry is " IndexString "."))
    
    (vla-UpdateEntry objFDLCol FDLIndex)
    
    (vla-RemoveEntry objFDLCol FDLIndex :vlax-true)
    (alert (strcat "The number of entries in the File Dependency List is " (itoa (vla-get-Count objFDLCol)) "."))
)