Udostępnij za pośrednictwem


Kontrolka Glyph (kontrola źródła VSPackage)

Częścią głębokiej integracji dostępnej dla pakietów VSPackage kontroli źródła jest możliwość wyświetlania własnych glifów w celu wskazania stanu elementów pod kontrolą źródła.

Poziomy kontrolki glif

Glyph stanu to ikona wskazująca bieżący stan elementu, na przykład w Eksplorator rozwiązań lub w widoku klasy. Pakiet VSPackage kontroli źródła może wykonywać dwa poziomy kontrolki glif. Może ograniczyć wybór glifów do wstępnie zdefiniowanego zestawu glifów dostarczonych przez środowisko IDE programu Visual Studio lub może zdefiniować niestandardowy zestaw glifów do wyświetlenia.

Domyślny zestaw glifów

Aby określić glyphs stanu, które są skojarzone z elementem w Eksplorator rozwiązań, projekt żąda glyph stanu z kontroli źródła przy użyciu .GetSccGlyph Pakiet VSPackage kontroli źródła może zdecydować o zachowaniu wyboru glifów ograniczonych do wstępnie zdefiniowanych glyphs dostarczonych przez środowisko IDE. W tym przypadku pakiet VSPackage przekazuje z powrotem tablicę wartości reprezentujących wyliczenia glyph zdefiniowane w pliku vsshell.idl. W celu uzyskania więcej informacji, zobacz następujący temat: VsStateIcon. Jest to wstępnie zdefiniowany zestaw glifów ustawiony przez środowisko IDE, taki jak kłódka dla zaewidencjonowanego glifu i znacznik wyboru dla wyewidencjonowanego glifu.

Niestandardowy zestaw glifów

Pakiet VSPackage kontroli źródła może używać własnych glyphs do unikatowego wyglądu i działania po zainstalowaniu. Gdy nowy pakiet VSPackage kontroli źródła jest aktywny, powinien być w stanie rozpocząć korzystanie z własnych glifów, nawet jeśli poprzedni pakiet VSPackage kontroli źródła jest nadal ładowany, ale nieaktywny. W tym trybie pakiet VSPackage kontroli źródła nadal może używać istniejących ikon, aby zachować wygląd spójny z programem Visual Studio, jeśli zostanie wybrany.

Usługa SVsSccManager obsługuje interfejs , IVsSccGlyphsktóry pakiet VSPackage może opcjonalnie zaimplementować i który zostanie poproszony przez środowisko IDE. Gdy środowisko IDE wysyła żądanie, program Visual Studio spróbuje pobrać ten interfejs z aktualnie zarejestrowanego pakietu VSPackage kontroli źródła. Jeśli interfejs istnieje w zarejestrowanej usłudze VSPackage, żądanie środowiska IDE dla niestandardowych glyphs powiedzie się; w przeciwnym razie środowisko IDE programu Visual Studio używa domyślnego zestawu glifów.

Metoda GetCustomGlyphList jest używana przez program Visual Studio do uzyskania listy obrazów przedstawiających różne stany kontroli źródła. Kontrolka źródła VSPackage powraca do środowiska IDE dojścia do listy obrazów dla niestandardowych glyphs. Środowisko IDE tworzy kopię listy obrazów w tym momencie i używa jej później do wybrania glifów do wyświetlenia. Jeśli nowy interfejs nie jest obsługiwany lub IVsSccGlyphs::GetCustomGlyphList metoda zwraca E_NOTIMPLwartość , środowisko IDE pobiera jego glify z domyślnej listy glifów dostarczonych przez program Visual Studio.