Interfejs IVsTrackProjectDocumentsEvents2

Artykuł
10/14/2015

Powiadamia klientów o zmianach wprowadzonych do projektu plików lub katalogów.

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

Składnia

[InterfaceTypeAttribute(1)]
[GuidAttribute("53544C4D-663D-11D3-A60D-005004775AB1")]
public interface IVsTrackProjectDocumentsEvents2

[InterfaceTypeAttribute(1)]
[GuidAttribute("53544C4D-663D-11D3-A60D-005004775AB1")]
public interface class IVsTrackProjectDocumentsEvents2

[<InterfaceTypeAttribute(1)>]
[<GuidAttribute("53544C4D-663D-11D3-A60D-005004775AB1")>]
type IVsTrackProjectDocumentsEvents2 = interface end

<InterfaceTypeAttribute(1)>
<GuidAttribute("53544C4D-663D-11D3-A60D-005004775AB1")>
Public Interface IVsTrackProjectDocumentsEvents2

Metody

	Nazwa	Opis
	OnAfterAddDirectoriesEx(Int32, Int32, IVsProject[], Int32[], String[], VSADDDIRECTORYFLAGS[])	Metoda ta powiadamia klienta po katalogi są dodawane do projektu.
	OnAfterAddFilesEx(Int32, Int32, IVsProject[], Int32[], String[], VSADDFILEFLAGS[])	Metoda ta powiadamia klienta po projekcie dodał pliki.
	OnAfterRemoveDirectories(Int32, Int32, IVsProject[], Int32[], String[], VSREMOVEDIRECTORYFLAGS[])	Metoda ta powiadamia klienta, gdy katalogi zostały usunięte z projektu.
	OnAfterRemoveFiles(Int32, Int32, IVsProject[], Int32[], String[], VSREMOVEFILEFLAGS[])	Metoda ta powiadamia klienta, po usunięciu plików projektu.
	OnAfterRenameDirectories(Int32, Int32, IVsProject[], Int32[], String[], String[], VSRENAMEDIRECTORYFLAGS[])	Ta metoda powiadamia klienta, gdy nazwy katalogów zostały zmienione w projekcie.
	OnAfterRenameFiles(Int32, Int32, IVsProject[], Int32[], String[], String[], VSRENAMEFILEFLAGS[])	Metoda ta powiadamia klienta, gdy plików zostały zmienione w projekcie.
	OnAfterSccStatusChanged(Int32, Int32, IVsProject[], Int32[], String[], UInt32[])	Metoda ta powiadamia klienta po zmianie statusu kontroli źródła.
	OnQueryAddDirectories(IVsProject, Int32, String[], VSQUERYADDDIRECTORYFLAGS[], VSQUERYADDDIRECTORYRESULTS[], VSQUERYADDDIRECTORYRESULTS[])	Ta metoda powiadamia klienta, gdy projekt zażądał, aby dodać katalogi.
	OnQueryAddFiles(IVsProject, Int32, String[], VSQUERYADDFILEFLAGS[], VSQUERYADDFILERESULTS[], VSQUERYADDFILERESULTS[])	Ta metoda powiadamia klienta, gdy projekt zażądał, aby dodać pliki.
	OnQueryRemoveDirectories(IVsProject, Int32, String[], VSQUERYREMOVEDIRECTORYFLAGS[], VSQUERYREMOVEDIRECTORYRESULTS[], VSQUERYREMOVEDIRECTORYRESULTS[])	Metoda ta powiadamia klienta, gdy żądanie projektu przez usuwanie katalogów.
	OnQueryRemoveFiles(IVsProject, Int32, String[], VSQUERYREMOVEFILEFLAGS[], VSQUERYREMOVEFILERESULTS[], VSQUERYREMOVEFILERESULTS[])	Metoda ta powiadamia klienta, gdy projekt poprosił o usunięcie plików.
	OnQueryRenameDirectories(IVsProject, Int32, String[], String[], VSQUERYRENAMEDIRECTORYFLAGS[], VSQUERYRENAMEDIRECTORYRESULTS[], VSQUERYRENAMEDIRECTORYRESULTS[])	Ta metoda powiadamia klienta, gdy projekt zwróciła się do zmiany nazwy katalogów.
	OnQueryRenameFiles(IVsProject, Int32, String[], String[], VSQUERYRENAMEFILEFLAGS[], VSQUERYRENAMEFILERESULTS[], VSQUERYRENAMEFILERESULTS[])	Metoda ta powiadamia klienta podczas projektu zwróciła się do nazw plików.

Uwagi

Gdy subskrybujesz IVsTrackProjectDocumentEvents2 zdarzenia, otrzymasz powiadomienie o zdarzeniu, dla wszystkich projektów.Ogólnie nie otrzymasz wsadowej powiadomienia o tych zdarzeniach, chyba że dwa projekty koordynować, jak w przypadku projektu zagnieżdżonego i projekt nadrzędny.

Przed dodaniem, zmiana nazwy lub usuwanie pliku lub katalogu, każdy projekt musi wywołać odpowiednie OnQuery* metody z IVsTrackProjectDocuments2 do sprawdzania, czy operacja jest dozwolona.Po ukończeniu operacji projektu musi następnie powiadomić OnAfter* metodę w IVsTrackProjectDocuments2.Środowisko wysyła powiadomienia o zdarzeniach właściwe po każdym wywołaniu.

Parametry w metodach IVsTrackProjectDocumentEvents2 zazwyczaj składa się:

Odpowiednie IVsProject2, lub w tablicy, z IVsProject2 wskaźniki.
Miejsce flagi dotyczące operacji, biorąc.
Tablica dokumentów posortowane wg projektu.Jeśli istnieje tylko jeden projekt, następnie porządkowania plików nie ma znaczenia.Jeśli istnieje więcej niż jeden projekt, pliki muszą pogrupowane według ich skojarzonych projektów.
Tablica pierwszy indeksów.Indeksy te dotyczą tablicy projektów tablicy dokumentów.Istnieje jeden indeks pierwszego dla każdego projektu, która wskazuje na pierwszy plik w tablicy dokumentów, która jest kontrolowana przez program project.Ponieważ tablica dokumentów jest sortowana według projektów, wszystkie wskaźniki większa niż jeden indeks pierwszego i mniej niż następnego pierwszego indeksu należą do danego projektu.Na przykład:

Projekty	Wskaźniki	Dokumenty
Visual Basic	0	0) a 1) b 2) c 3) d 4).
Visual C++	5	5) f 6) g 7) h
Program Visual C#	8	8) i 9) j 10) k 11) l

W tym przypadku:

Dokumenty a, b, c, d, e (wskaźniki 0–4) należą do projektu programu Visual Basic.

Dokumenty f, g, h (wskaźniki 5–7) należą do projektu programu Visual C++.

Dokumenty i, j, k, l (wskaźniki 8 i powyżej) należą do Visual C# projektu.

Uwagi dotyczące implementacji:

Pakiet kontroli źródła implementuje ten interfejs, jeżeli potrzebuje do śledzenia zmian w projekcie, takie jak kiedy plików lub katalogów są dodane, usunięte lub zmieniono jego nazwę.Zaleca się wykonanie tego interfejsu; w przeciwnym razie użytkownik może być konieczne ręcznie odświeżyć wyświetlanie formantu źródła zmiany stanu.

Uwagi dotyczące wywoływania:

Wywoływany przez środowisko w odpowiedzi na dodawanie, usuwanie, lub zmiana nazw plików lub katalogów w projekcie.

Zobacz też

Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku

Udostępnij za pośrednictwem