IVsToolboxDataProvider2.ReconstituteItem(String, String, String, IDataObject, TBXITEMINFO[]) Methode

Definition

Erstellt ein Toolbox Element aus Daten, die mithilfe des Einstellungs Mechanismus gespeichert werden, wenn ein Benutzer die Einstellungen mithilfe der Funktion zum Importieren/Exportieren von Einstellungen abrufen möchte, die im Menü Extras der IDE verfügbar ist.

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

Parameter

lpszCurrentName
String

[in] Der aktuelle (lokalisierte) Name des Werkzeugkastenelements.

lpszID
String

[in] Die kanonische ID des Toolboxelements.

lpszData
String

[in] Eine Zeichenfolge, die alle zusätzlichen Informationen enthält, die für die Wiederherstellung des Elements benötigt werden.

ppDO
IDataObject

vorgenommen Ein Datenobjekt, das dem Toolbox Element entspricht.

ptif
TBXITEMINFO[]

[out] Eine TBXITEMINFO-Struktur, die zusätzliche Informationen über das Toolboxelement enthält.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Aus vsshell80. idl:

HRESULT IVsToolboxDataProvider2::ReconstituteItem(  
   [in] LPCOLESTR lpszCurrentName,  
   [in] LPCOLESTR lpszID,  
   [in] LPCOLESTR lpszData,  
   [out] IDataObject **ppDO,  
   [out] TBXITEMINFO *ptif  
);  

Die Umgebung Ruft die IVsToolboxDataProvider2.ReconstituteItem Methode auf, wenn ein Benutzer die Import Option der Funktion Import/Export-Einstellungen der IDE auswählt.

Die Eingabeargumente für IVsToolboxDataProvider2.ReconstituteItem werden von der IDE aus den exportierten Einstellungen abgerufen, insbesondere:

  • Das Toolbox Element Canonical ID ( lpszID ) wurde ursprünglich exportiert, als die Umgebung aufgerufen wurde GetItemID .

  • Der aktuelle Registerkarten Name ( lpszCurrentName ) wurde ursprünglich exportiert, als die Umgebung aufgerufen wurde GetDisplayName .

  • Alle zusätzlichen Informationen, die erforderlich sind, um das Toolbox Element () wiederherzustellen, lpszData wurden ursprünglich exportiert, als die Umgebung aufgerufen wurde GetProfileData .

Jeder Datenanbieter sollte in der Lage sein, jeden beliebigen Elementtyp, den er erstellen kann, wiederherzustellen.

Wenn die importierten Profileinstellungen ein Element enthält, das zurzeit von keinem installierten Datenanbieter wieder hergestellt werden kann, wird davon ausgegangen, dass es sich bei dem Element entweder um ein Steuerelement handelt, das nicht auf dem aktuellen System installiert ist, oder ob der Datenanbieter, der normalerweise diese Steuerung wieder bildet, nicht auf dem System installiert ist. In beiden Fällen wird der Toolbox ein dauerhaft deaktiviertes Platzhalter Steuerelement hinzugefügt, das das unbekannte Element darstellt.

Gilt für