Metoda IVsSccManager2.GetSccGlyph — (Int32, String[], VsStateIcon[], UInt32 )

Artykuł
10/14/2015

Metoda ta jest wywoływana przez projekty, aby wykryć glify kontroli źródła, aby używać plików i status kontroli źródła te pliki; jest to jedyny sposób, aby uzyskać status.

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

Składnia

int GetSccGlyph(
    int cFiles,
    string[] rgpszFullPaths,
    VsStateIcon[] rgsiGlyphs,
    uint[] rgdwSccStatus
)

int GetSccGlyph(
    int cFiles,
    array<String^>^ rgpszFullPaths,
    array<VsStateIcon>^ rgsiGlyphs,
    array<unsigned int>^ rgdwSccStatus
)

abstract GetSccGlyph : 
        cFiles:int *
        rgpszFullPaths:string[] *
        rgsiGlyphs:VsStateIcon[] *
        rgdwSccStatus:uint32[] -> int

Function GetSccGlyph (
    cFiles As Integer,
    rgpszFullPaths As String(),
    rgsiGlyphs As VsStateIcon(),
    rgdwSccStatus As UInteger()
) As Integer

Parametry

cFiles
[w] Liczba plików.Powinna istnieć większa niż 0, jeśli istnieją pliki kontroli kodu źródłowego.Obecnie środowisko obsługuje tylko liczba 1.

rgpszFullPaths
[w] Tablica ścieżki do plików; nie może być null.

rgsiGlyphs
[out] Tablica ikony odpowiadające rgpszFullPaths; nie może być null.Zobacz VsStateIcon Aby uzyskać dodatkowe informacje.

rgdwSccStatus
[out] Określa stan odpowiadający rgpszFullPaths wpisu.Dla listy możliwych wartości Zobacz moduł wyliczający kod stanu pliku.Ten parametr może być null.

Wartość zwracana

Type: System.Int32

Metoda zwraca S_OK , jeśli co najmniej jeden z plików jest kontrolowana, S_FALSE , jeżeli brak jest kontrolowany.

Uwagi

Podpis COM

Z ivssccmanager2.idl

HRESULT GetSccGlyph(
   [in] int cFiles,
   [in, size_is(cFiles)] const LPCOLESTR rgpszFullPaths[],
   [out, size_is(cFiles)] VsStateIcon rgsiGlyphs[],
   [out, size_is(cFiles)] DWORD rgdwSccStatus[]
);

Metoda ta jest wywoływana przez projekty, aby wykryć glify kontroli źródła na pliki.Projekt najpierw otwierany przy uruchamianiu, wywołuje tę metodę, aby uzyskać glify dla projektu.Po uruchomieniu środowiska przewiduje glify do projektu za pomocą SccGlyphChanged.Glify są opatrzone przez indeks ikony środowiska (VsStateIcon wyliczenie).

W jaki sposób ta metoda jest używane przez projekty

Status kontroli źródła na plik jest również opcjonalnie zwrócone; Jednakże projekty są zachęcać do wykorzystywania glify, ale nie do statusu kontroli źródła w pamięci podręcznej.Wywołanie tej metody, każdy stan czasu nie jest potrzebne, zamiast utrzymywania własnego rekordu bitów stanu.

Kiedy projekt otrzymuje GetProperty metody (VSHPROPID_StateIconIndex) wywoływać ze środowiska, należy wywołać GetSccGlyph odpowiedni plik lub pliki VSITEMID w wywołaniu tej.Projekt nie trzeba przechowywać ikona stanu zwracane — środowiska będą przechowywać go.Należy pamiętać, że projekt jest dozwolone do wywołania GetSccGlyph po wywołaniu przez środowisko z GetProperty, ale gdy jest wywoływana SccGlyphChanged, projekt jest przekazywany glify i nie trzeba wywołać GetSccGlyph ponownie.Projekt można natychmiast przekazać glify danej przy użyciu środowiska SetProperty metody, chyba że parametry do SccGlyphChanged są null.W przypadku wywołania środowiska dla wszystkich projektu VSITEMID s w projekcie.

Należy pamiętać o następujących czynności:

Jeżeli plik jest pod kontrolą źródła SCC_STATUS_CONTROLLED jest ustawiona flaga.
Jeśli bieżący użytkownik wyewidencjonuje plik do wyznaczonego katalogu roboczego, SCC_STATUS_CHECKEDOUT jest ustawiona flaga.

Zobacz też

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

Powrót do początku

Udostępnij za pośrednictwem