Metoda IVsProject2.AddItem — (UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT )

Artykuł
08/06/2016

Tworzy nowe elementy w projekcie, dodaje istniejące pliki do projektu lub powoduje, że Dodaj element kreatorów do uruchomienia.

Przestrzeń nazw: Microsoft.VisualStudio.Shell.Interop
Zestaw: Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

int AddItem(
    uint itemidLoc,
    VSADDITEMOPERATION dwAddItemOperation,
    string pszItemName,
    uint cFilesToOpen,
    string[] rgpszFilesToOpen,
    IntPtr hwndDlgOwner,
    VSADDRESULT[] pResult
)

int AddItem(
    unsigned int itemidLoc,
    VSADDITEMOPERATION dwAddItemOperation,
    String^ pszItemName,
    unsigned int cFilesToOpen,
    array<String^>^ rgpszFilesToOpen,
    IntPtr hwndDlgOwner,
    array<VSADDRESULT>^ pResult
)

abstract AddItem : 
        itemidLoc:uint32 *
        dwAddItemOperation:VSADDITEMOPERATION *
        pszItemName:string *
        cFilesToOpen:uint32 *
        rgpszFilesToOpen:string[] *
        hwndDlgOwner:nativeint *
        pResult:VSADDRESULT[] -> int

Function AddItem (
    itemidLoc As UInteger,
    dwAddItemOperation As VSADDITEMOPERATION,
    pszItemName As String,
    cFilesToOpen As UInteger,
    rgpszFilesToOpen As String(),
    hwndDlgOwner As IntPtr,
    pResult As VSADDRESULT()
) As Integer

Parametry

itemidLoc
Type: System.UInt32

[in] Identyfikator folderu kontenera dla dodawanego elementu. Powinien być VSITEMID_ROOT lub innym prawidłowym identyfikatorem elementu. Zobacz wyliczenie VSITEMID. Należy zauważyć, że ten parametr jest ignorowany obecnie jest obsługiwany tylko dodawanie elementów jako elementy podrzędne węzła projektu. Projekty, które obsługuje pojęcia foldery będą chcieli dodawać elementy względem itemidLoc.

dwAddItemOperation
Type: Microsoft.VisualStudio.Shell.Interop.VSADDITEMOPERATION

[in] Operacja stosowane do nowo utworzony element. Może być VSADDITEMOP_OPENDIRECTORY tylko wtedy, gdy VSADDITEM_ShowAddFolderButton jest przekazywana do metody AddProjectItemDlg. Zobacz wyliczenie VSADDITEMOPERATION.

pszItemName
Type: System.String

[in] Nazwa elementu do dodania.

cFilesToOpen
Type: System.UInt32

[in] Liczba elementów w rgpszFilesToOpen. Może być równy zero. Musi to być 1, jeśli dwAddItemOperation jest VSADDITEMOP_CLONEFILE lub VSADDITEMOP_OPENDIRECTORY. Jeśli VSADDITEMOP_RUNWIZARD, musi być 1 lub 2.

rgpszFilesToOpen
Type: System.String[]

[in, size_is(cFilesToOpen)] Tablica wskaźników do OLESTR nazwy plików. Jeśli dwAddItemOperation jest VSADDITEMOP_CLONEFILE lub VSADDITEMOP_OPENDIRECTORY, pierwszy element (rgpszFilesToOpen[0]) w tablicy jest nazwa pliku do klonowania lub katalog, aby otworzyć. Jeśli jest VSADDITEMOP_RUNWIZARD, pierwszy element (rgpszFilesToOpen[0]) jest nazwą kreatora w celu uruchomienia i drugiego elementu (rgpszFilesToOpen[1]) jest podana przez użytkownika nazwa pliku (taka sama jak pszItemName).

hwndDlgOwner
Type: System.IntPtr

[in] Dojście do Dodaj element okno dialogowe.

pResult
Type: Microsoft.VisualStudio.Shell.Interop.VSADDRESULT[]

[out, retval] Wskaźnik do VSADDRESULT wyliczenia wskazująca, czy element został pomyślnie dodany do projektu.

Wartość zwracana

Type: System.Int32

Jeśli metoda zakończy się pomyślnie, zwraca S_OK. Jeśli nie, zwraca kod błędu.

Implementuje

IVsProject.AddItem(UInt32, VSADDITEMOPERATION, String, UInt32, String[], IntPtr, VSADDRESULT[])

Uwagi

Podpis COM

Z vsshell.idl:

HRESULT IVsProject2::AddItem(
   [in] VSITEMID itemidLoc, 
   [in] VSADDITEMOPERATION dwAddItemOperation,
   [in] LPCOLESTR pszItemName,
   [in] ULONG cFilesToOpen,
   [in, size_is(cFilesToOpen)] LPCOLESTR rgpszFilesToOpen[],
   [in] HWND hwndDlgOwner,
   [out, retval] VSADDRESULT * pResult
);

Ta metoda jest używana przez Dodaj element okno dialogowe. Metoda można tworzyć nowe elementy, Dodaj istniejące pliki lub spowodować Dodaj element kreatorów do uruchomienia.

Ta metoda powinna być wywoływana tylko z w wątku interfejsu użytkownika, w przeciwnym razie będzie sygnalizować COMException.

Zobacz też

Interfejs IVsProject2
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku

Udostępnij za pośrednictwem