IVsToolboxDataProvider2.ReconstituteItem(String, String, String, IDataObject, TBXITEMINFO[]) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Recria um item da caixa de ferramentas a partir dos dados armazenados usando o mecanismo de configurações quando um usuário opta por recuperar as configurações usando o recurso de configurações de importação/exportação disponível no menu ferramentas do IDE.
public:
int ReconstituteItem(System::String ^ lpszCurrentName, System::String ^ lpszID, System::String ^ lpszData, [Runtime::InteropServices::Out] Microsoft::VisualStudio::OLE::Interop::IDataObject ^ % ppDO, cli::array <Microsoft::VisualStudio::Shell::Interop::TBXITEMINFO> ^ ptif);
int ReconstituteItem(std::wstring const & lpszCurrentName, std::wstring const & lpszID, std::wstring const & lpszData, [Runtime::InteropServices::Out] Microsoft::VisualStudio::OLE::Interop::IDataObject const & & ppDO, std::Array <Microsoft::VisualStudio::Shell::Interop::TBXITEMINFO> const & ptif);
public int ReconstituteItem (string lpszCurrentName, string lpszID, string lpszData, out Microsoft.VisualStudio.OLE.Interop.IDataObject ppDO, Microsoft.VisualStudio.Shell.Interop.TBXITEMINFO[] ptif);
abstract member ReconstituteItem : string * string * string * IDataObject * Microsoft.VisualStudio.Shell.Interop.TBXITEMINFO[] -> int
Public Function ReconstituteItem (lpszCurrentName As String, lpszID As String, lpszData As String, ByRef ppDO As IDataObject, ptif As TBXITEMINFO()) As Integer
Parâmetros
- lpszCurrentName
- String
no O nome atual (localizado) do item da caixa de ferramentas.
- lpszID
- String
no A ID canônica do item da caixa de ferramentas.
- lpszData
- String
no Uma cadeia de caracteres que contém informações adicionais necessárias para reconstituir o item.
- ppDO
- IDataObject
fora Um objeto de dados correspondente ao item da caixa de ferramentas.
- ptif
- TBXITEMINFO[]
fora Uma TBXITEMINFO estrutura que contém informações adicionais sobre o item da caixa de ferramentas.
Retornos
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Assinatura COM
De vsshell80. idl:
HRESULT IVsToolboxDataProvider2::ReconstituteItem(
[in] LPCOLESTR lpszCurrentName,
[in] LPCOLESTR lpszID,
[in] LPCOLESTR lpszData,
[out] IDataObject **ppDO,
[out] TBXITEMINFO *ptif
);
O ambiente chama o IVsToolboxDataProvider2.ReconstituteItem método quando um usuário escolhe a opção de importação do recurso de configurações de importação/exportação do IDE.
Os argumentos de entrada para o IVsToolboxDataProvider2.ReconstituteItem são obtidos pelo IDE a partir de configurações exportadas, especificamente:
O item da caixa de ferramentas ID canônica (
lpszID) foi exportado originalmente quando o ambiente foi chamado GetItemID .O nome da guia atual (
lpszCurrentName), foi exportado originalmente quando o ambiente foi chamado GetDisplayName .Todas as informações adicionais necessárias para reconstituir o item da caixa de ferramentas (
lpszData) foram exportadas originalmente quando o ambiente foi chamado GetProfileData .
Cada provedor de dados deve ser capaz de reconstituir qualquer tipo de item que possa ser criado.
Se um perfil importado configurações contiver um item que nenhum provedor de dados instalado atualmente seja capaz de reconstituir, supõe-se que o item é um controle que não está instalado no sistema atual ou que o provedor de dados que normalmente reconstitui esse controle não foi instalado no sistema. Em ambos os casos, um controle de espaço reservado permanentemente desabilitado é adicionado à caixa de ferramentas para representar o item desconhecido.