VCCodeModel.AddIDLLibrary メソッド

[アーティクル]
01/29/2008

特定の .idl ファイルに新しい library ステートメントを追加します。

名前空間 : Microsoft.VisualStudio.VCCodeModel
アセンブリ : Microsoft.VisualStudio.VCCodeModel (Microsoft.VisualStudio.VCCodeModel.dll 内)

構文

'宣言
Function AddIDLLibrary ( _
    Name As String, _
    Location As Object, _
    Position As Object _
) As VCCodeIDLLibrary
'使用
Dim instance As VCCodeModel
Dim Name As String
Dim Location As Object
Dim Position As Object
Dim returnValue As VCCodeIDLLibrary

returnValue = instance.AddIDLLibrary(Name, _
    Location, Position)

VCCodeIDLLibrary AddIDLLibrary(
    string Name,
    Object Location,
    Object Position
)

VCCodeIDLLibrary^ AddIDLLibrary(
    String^ Name, 
    Object^ Location, 
    Object^ Position
)

function AddIDLLibrary(
    Name : String, 
    Location : Object, 
    Position : Object
) : VCCodeIDLLibrary

パラメータ

Name
型 : System.String

必ず指定します。新しいライブラリの名前を指定します。

Location
型 : System.Object

必ず指定します。変更する .idl ファイルのパスまたはファイル名。ファイルが存在しない場合は、自動的に作成されます。ファイルが既にプロジェクト項目になっていない場合は、ファイルがプロジェクトに追加されます。ファイルを作成してプロジェクトに追加できない場合、AddIDLLibrary は失敗します。

Position
型 : System.Object

省略可能です。既定では 0 が指定されます。ここで指定したコード要素の後に、新しい要素を追加します。値が CodeElement の場合は、その値の直後に新しい要素が追加されます。

コレクションは 1 からカウントを開始するので、0 が渡された場合は、新規の要素はコレクションの先頭に配置されます。値 -1 は要素を末尾に配置することを示します。

戻り値

型 : Microsoft.VisualStudio.VCCodeModel.VCCodeIDLLibrary

VCCodeIDLLibrary オブジェクト。

解説

この関数は、VCCodeModel オブジェクトの特定の .idl ファイルに library ステートメントを挿入するために呼び出します。

このサンプルコードをコンパイルして実行する方法については、「方法 : Visual C++ コードモデル機能拡張のプログラム例をコンパイルする」を参照してください。

例

次の例では、Project.idl ファイルの末尾に library ステートメントを追加します。

Sub AddIDLLibrary()
    Dim codeModel As VCCodeModel
    codeModel = DTE.Solution.Item(1).CodeModel
    Dim idlLibrary As VCCodeIDLLibrary
    idlLibrary = codeModel.AddIDLLibrary("MyLibrary", "Project.idl", -1)
End Sub