Udostępnij za pośrednictwem

Metoda IVsToolboxDataProvider2.GetItemID — (IDataObject, String)

  • Artykuł

 

Używany przez środowisko do pobierania i zapisuje kanoniczny identyfikator dla danej karty przybornik, gdy użytkownik wybierze opcję eksportu z Ustawienia importu i eksportu funkcji dostępnych na IDE Narzędzia menu.

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

Składnia

int GetItemID(
    IDataObject pDO,
    out string pbstrID
)

int GetItemID(
    IDataObject^ pDO,
    [OutAttribute] String^% pbstrID
)

abstract GetItemID : 
        pDO:IDataObject *
        pbstrID:string byref -> int

Function GetItemID (
    pDO As IDataObject,
    <OutAttribute> ByRef pbstrID As String
) As Integer

Parametry

  • pDO
    [w] Obiekt danych odpowiadających element przybornika.
  • pbstrID
    [out] Identyfikator kanoniczny niezmienny ustawienia regionalne na karcie przybornika.

Wartość zwracana

Type: System.Int32

Jeśli metoda się powiedzie, zwraca S_OK.Jeśli nie powiedzie się, zwraca kod błędu.

Uwagi

Podpis COM

Z vsshell80.idl:

HRESULT IVsToolboxDataProvider2::GetItemID(
   [in] IDataObject *pDO,
   [out] BSTR *pbstrID
);

Wywołania środowiska IVsToolboxDataProvider2.GetItemID kiedy użytkownik wybierze opcję eksportu IDE Ustawienia importu i eksportu funkcji.

Podczas importowania ustawień środowiska skopiuje ten identyfikator przebiegu go do ReconstituteItem metodę, aby odtworzyć element przybornika.

Zwracane w postaci kanonicznej identyfikator pbstrID, różni się od nazwy lokalizowalna kartę zdefiniowane podczas AddTab jest wywoływana.

Chociaż nazwy kanonicznej kartę muszą być unikatowe, zlokalizowane ciągi zmienia się w zależności od ustawień regionalnych, na którym uruchomiono IDE.

W związku z tym kanoniczny ID musi być niezmienny ustawień regionalnych.

Nie ma żadnych szczególnych ograniczeń na format kanoniczny ciąg Identyfikatora, identyfikator GUID może być używany lub łatwe do zapamiętania ciąg znaków w języku autora może być zatrudniony.

Wszelkich VSPackage, który tworzy Karta przybornika powinna wywołać SetIDOfTab.

Zobacz też

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

Powrót do początku