CreateEntry メソッド(ActiveX)

[File Dependency List]の中に新しいエントリを作成します。

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

構文と要素

VBA:

object.CreateEntry Feature, FullFileName, AffectsGraphics, noIncrement

object

タイプ: FileDependencies

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

Feature

アクセス: 入力のみ

タイプ: 文字列

エントリを作成するアプリケーションまたは機能の説明。

FullFileName

アクセス: 入力のみ

タイプ: 文字列

File Dependency List に格納するファイルの名前(既存のファイルであることが必要)。

AffectsGraphics

アクセス: 入力のみ

タイプ: ブール型

True の場合は、このエントリは図面ファイルの画面表示(特にグラフィックス キャッシュ)に影響を与えます。False の場合は、画面表示には影響しません。

noIncrement

アクセス: 入力のみ

タイプ: ブール型

True の場合は、既存のエントリの参照カウントを増加させません。False の場合は、既存のエントリが追加されると参照カウントが増加します。

戻り値(RetVal)

戻り値はありません。

注意

このメソッドは、機能説明を示す文字列をとります。この文字列は File Dependency List (FDL)エントリとともに格納され、このエントリを作成したアプリケーションまたは機能を識別します（たとえば、Acad::xref）。機能文字列に対しては、一意的なアプリケーション名のチェックは行われません。このメソッドも、FDL に格納されているファイル名を示すパラメータをとります。格納されているパスも含めることができます。

パスを含めないと、AutoCAD は現在のフォルダおよび AutoCAD サポート ファイル検索パスの中でファイルを検索し、見つかったものをエントリとともに格納します。ファイルが見つからないか、開くことができない場合は、エントリは作成されず、0 が返されます。ファイルが見つかった場合は、ファイルの時刻/日付およびファイル サイズがエントリとともに格納され、エントリに一意的なインデックスが割り当てられ、返されます。

このメソッドを使用して、nonIncrement を True に設定してエントリのセットを再作成することができます。これによって、エントリが FDL にすでに存在する場合に、参照カウントが増加しないようにできます。nonIncrement を False に設定すると、同じエントリを複数回追加することができます。この場合は、エントリの参照カウントが増加し、FDL のエントリが参照された回数が記録されます。記録の重複は起こりません。

例

VBA:

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)) "."))
)