IVsSolution2.GetItemOfProjref(String, IVsHierarchy, UInt32, String, VSUPDATEPROJREFREASON[]) Methode

Definition

Gibt ein Hierarchie- und Hierarchieelementpaar für die angegebene Projektverweiszeichenfolge zurück.

public:
 int GetItemOfProjref(System::String ^ pszProjref, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^ % ppHierarchy, [Runtime::InteropServices::Out] System::UInt32 % pitemid, [Runtime::InteropServices::Out] System::String ^ % pbstrUpdatedProjref, cli::array <Microsoft::VisualStudio::Shell::Interop::VSUPDATEPROJREFREASON> ^ puprUpdateReason);
int GetItemOfProjref(std::wstring const & pszProjref, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsHierarchy const & & ppHierarchy, [Runtime::InteropServices::Out] unsigned int & pitemid, [Runtime::InteropServices::Out] std::wstring const & & pbstrUpdatedProjref, std::Array <Microsoft::VisualStudio::Shell::Interop::VSUPDATEPROJREFREASON> const & puprUpdateReason);
public int GetItemOfProjref (string pszProjref, out Microsoft.VisualStudio.Shell.Interop.IVsHierarchy ppHierarchy, out uint pitemid, out string pbstrUpdatedProjref, Microsoft.VisualStudio.Shell.Interop.VSUPDATEPROJREFREASON[] puprUpdateReason);
abstract member GetItemOfProjref : string * IVsHierarchy * uint32 * string * Microsoft.VisualStudio.Shell.Interop.VSUPDATEPROJREFREASON[] -> int
Public Function GetItemOfProjref (pszProjref As String, ByRef ppHierarchy As IVsHierarchy, ByRef pitemid As UInteger, ByRef pbstrUpdatedProjref As String, puprUpdateReason As VSUPDATEPROJREFREASON()) As Integer

Parameter

pszProjref
String

[in] Zeiger auf die vorhandene Projektelementverweiszeichenfolge, falls zutreffend. Kann null sein.

ppHierarchy
IVsHierarchy

[out] Zeiger auf die IVsHierarchy-Schnittstelle, die durch den Projektverweis angegeben wird.

pitemid
UInt32

[out] Zeiger auf den Elementbezeichner, verwiesen durch den Projektverweis. Eine Liste der aufgelisteten pitemid Werte finden Sie unter VSITEMID .

pbstrUpdatedProjref
String

[out] Zeiger auf die aktualisierte Projektverweiszeichenfolge.

puprUpdateReason
VSUPDATEPROJREFREASON[]

[out] Bezeichner, der den Grund für eine Änderung der Projektverweiszeichenfolge beschreibt. Eine Liste der puprUpdateReason-Werte finden Sie unter VSUPDATEPROJREFREASON.

Gibt zurück

Int32

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

Implementiert

Hinweise

COM-Signatur

Aus vsshell. idl:

HRESULT IVsSolution2::GetItemOfProjref(  
   [in] LPCOLESTR pszProjref,   
   [out] IVsHierarchy **ppHierarchy,   
   [out] VSITEMID *pitemid,   
   [out] BSTR *pbstrUpdatedProjref,   
   [out] VSUPDATEPROJREFREASON *puprUpdateReason  
);  

Während eines Drag & Drop-oder Ausschneide-und Einfügevorgangs fügt die Umgebung einen Satz von Projekt verweisen in die Zwischenablage für das Quell Element im Vorgang ein. Diese Methode wird vom Ziel in diesen Vorgängen verwendet, um die Projekt Verweise von der Zwischenablage zurück in Hierarchie-und Hierarchie Element Paare zu ändern. Das Ziel kann dann die Quelle Benachrichtigen, dass diese Elemente integriert wurden.

Im folgenden wird beschrieben, wie die GetItemOfProjref -Methode zur Unterstützung von Drag & Drop-Vorgängen verwendet wird:

Die CF_VSPROJECTITEMS -und- CF_VSPROJECTS Zwischenablage Formate verwenden die- DROPFILES Struktur auf die gleiche Weise wie CF_HDROP oder CF_PRINTERS. Bei den Daten, die DROPFILES auf die Struktur folgen, handelt es sich um eine Liste von Zeichen folgen mit doppelter NULL endend Projref Der Consumer des Drop-Vorgangs kann die Microsoft Windows-API verwenden DragQueryFile , um die Daten in der Struktur zu untersuchen DROPFILES . CF_VSPROJECTS Format wird angeboten, wenn die Zeichen folgen Projref Projekte als Ganzes identifizieren, d. h pitemid . * = = VSITEMID_ROOT. Das CF_VSPROJECTITEMS-Format wird angeboten, wenn die Zeichenfolge Projref ein oder mehrere einzelne Projekt Elemente identifiziert. Es sollten entweder CF_VSPROJECTS oder CF_VSPROJECTITEMS angeboten werden, aber nicht beides.

Gilt für