Udostępnij za pośrednictwem

Interfejs IVsToolboxItemProvider

  • Artykuł

 

Wdrożone przez pakiety, które chcą zapewnić statycznie zarejestrowanych toolbox items (w tym samym obiekcie jako IVsPackage).

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

Składnia

[InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)]
[GuidAttribute("F2F94425-E001-4C4D-816C-70202E9A594C")]
public interface IVsToolboxItemProvider

[InterfaceTypeAttribute(ComInterfaceType::InterfaceIsIUnknown)]
[GuidAttribute("F2F94425-E001-4C4D-816C-70202E9A594C")]
public interface class IVsToolboxItemProvider

[<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)>]
[<GuidAttribute("F2F94425-E001-4C4D-816C-70202E9A594C")>]
type IVsToolboxItemProvider = interface end

<InterfaceTypeAttribute(ComInterfaceType.InterfaceIsIUnknown)>
<GuidAttribute("F2F94425-E001-4C4D-816C-70202E9A594C")>
Public Interface IVsToolboxItemProvider

Metody

Nazwa Opis
System_CAPS_pubmethod GetItemContent(String, UInt16, IntPtr)

Zwraca uchwyt globalnego zawartości element interfejsu użytkownika.

Uwagi

Jeśli zawartość przybornika deklaruje się w rejestrze, ten interfejs jest wywoływana przez przybornika, aby pobierać zawartość elementu, na żądanie (zamiast tworzyć go z pojedyncze wywołanie ResetDefaults).Jeśli zawartość jest podana w rejestrze, ale ten interfejs nie jest zaimplementowana, ResetDefaults nadal jest wywoływana, ale wywołanie jest opóźnione aż potrzebne jest element przybornika zawartości (na przykład, gdy użytkownik przeciągnie element na projektanta).

Aby zadeklarować zawartość przybornika w rejestrze, należy utworzyć klucz rejestru Toolbox\DefaultContent pod HKLM\Software\Microsoft\<appid>\<version>\Packages\<package GUID>.

W kluczu DefaultContent utworzyć jeden klucz dla każdej grupy przybornik, którą chcesz utworzyć lub umieść elementy.Nazwa klucza jest "Unikatowy identyfikator" (np.-zlokalizowana nazwa); Wartość domyślna klucza jest nazwą.Jeśli nazwa jest lokalizowalnym, należy ustawić wartość domyślna "# 123", gdzie 123 jest identyfikator zasobu w sieci satelitarnych biblioteki DLL.W każdym kluczu grupy należy utworzyć jeden klucz dla każdego elementu przybornika, który chcesz dodać do grupy.

Nazwa klucza i wartości domyślne są unikatowy identyfikator i nazwę (taki sam, jak dla grupy kluczy).Wymagane są następujące wartości:

  • HelpKeyword: string

  • Formaty: rozdzielaną średnikami listę nazw formatu danych.

  • Albo bitmapy: dane binarne piksele obrazu z czterech bajtów na piksel reprezentujący (<unused>, red, green, blue) rozmieszczone od lewej do prawej i z góry do dołu (tak jak pobrane przez funkcję GetDIBits, korzystając z DIB_RGB_COLORS, 1 płaszczyzny, kompresja BI_RGB, and32 bitów na piksel).Mapa bitowa musi być 16 x 16 pikseli, chyba że jest to obraz strip (patrz poniżej BitmapIndex), w którym to przypadku musi być 16 pikseli i wide.or pikseli multipleof 16...BitmapResourceID: ciąg identyfikujący zasób bitmapy w pakiecie satelliteDLL.Ograniczenia rozmiaru opisane dla "Mapy bitowej" zastosowanie tutaj zbyt.

  • TransparentColor: DWORD (z <unused> bajtów red, green, blue) wskazujący kolor, który powinien być odwzorowywany w sposób przezroczysty w mapie bitowej towaru.

  • Następujące opcjonalne wartości mogą być również określone:

    1. Ciąg wartości TipTitle, TipVersion, TipPublisher, TipType i TipDescription (patrz uwagi na IVsToolboxDataProvider2::GetItemTipInfo.

    2. Ciąg wartości AssemblyName, TypeName, TFMs i TargetedItemProvider.

    3. Ciąg wartości, MinimumFrameworkVersion, również jest obsługiwana dla zachowania zgodności z VS 2008.

    4. Wartość DWORD BitmapIndex, która wskazuje, że mapa bitowa jest faktycznie paska obrazu i identyfikuje obraz ma być wyodrębniony z niego.

Każdy klucz elementu opcjonalnie może być podklucz o nazwie "ItemContent", zawierające formaty danych, którego zawartość jest znany w zainstalować czasu.Dla każdego z tych wartości jest tworzony w tym kluczu, którego nazwa jest nazwą formatu danych, i których wartość jest w pliku binarnym blob, zawierające bajty formatu.

Zawartość formatów danych będą ładowane na żądanie przy użyciu IVsToolboxItemProvider lub ResetDefaults jak opisano powyżej.

Zobacz też

Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku