Método IVsToolboxDataProvider2.GetItemID (IDataObject, String)

Artigo
04/23/2016

Usado pelo ambiente para recuperar e salva a identificação canônica determinada guia caixa de ferramentas, quando um usuário seleciona a opção de exportação a partir do Configurações de importação/exportação recurso disponível em do IDE Ferramentas menu.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (em Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Sintaxe

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

Parâmetros

pDO
[in] O objeto de dados correspondente a esse item.

pbstrID
[out] A localidade invariável canônica ID da guia caixa de ferramentas.

Valor de retorno

Type: System.Int32

Se o método for bem-sucedido, ele retorna S_OK.Se ele falhar, ele retorna um código de erro.

Comentários

COM assinatura

De vsshell80.idl:

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

As chamadas de ambiente IVsToolboxDataProvider2.GetItemID quando um usuário escolhe a opção de exportação do IDE Configurações de importação/exportação recurso.

Na importação de configurações, o ambiente irá recuperar esse ID de uma passagem para o ReconstituteItem método para recriar o item da caixa de ferramentas.

A identificação de canônica, são retornados como pbstrID, é diferente do nome do guia localizáveis definido quando AddTab é chamado.

Embora, nomes de guias canônico precisam ser exclusivos, seqüências de caracteres localizadas mudam de acordo com a localidade em que o IDE está executando.

Portanto, a identificação de canônica deve ser constante de localidade.

Não existem restrições específicas sobre o formato da seqüência de caracteres de identificação canônica, pode ser usado um GUID ou uma seqüência de caracteres lembrada no idioma do desenvolvedor fácil poderia ser empregada.

Qualquer VSPackage que cria uma guia da caixa de ferramentas deve chamar o SetIDOfTab.

Consulte também

Interface IVsToolboxDataProvider2
Namespace Microsoft.VisualStudio.Shell.Interop

Retornar ao topo

Partilhar via