IVsUIShell.FindToolWindow(UInt32, Guid, IVsWindowFrame) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt den IVsWindowFrame-Zeiger für das angeforderte Einzelinstanz-Toolfenster zurück.
public:
int FindToolWindow(System::UInt32 grfFTW, Guid % rguidPersistenceSlot, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsWindowFrame ^ % ppWindowFrame);
public int FindToolWindow (uint grfFTW, ref Guid rguidPersistenceSlot, out Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame ppWindowFrame);
abstract member FindToolWindow : uint32 * Guid * IVsWindowFrame -> int
Public Function FindToolWindow (grfFTW As UInteger, ByRef rguidPersistenceSlot As Guid, ByRef ppWindowFrame As IVsWindowFrame) As Integer
Parameter
- grfFTW
- UInt32
[in] Stellt die Kriterien bereit, die verwendet werden, um ein Toolfenster in der Umgebung zu suchen. Weitere Informationen finden Sie unter __VSFINDTOOLWIN.
- rguidPersistenceSlot
- Guid
[in] Eindeutiger Bezeichner für ein Toolfenster erstellt mithilfe von CreateToolWindow(UInt32, UInt32, Object, Guid, Guid, Guid, IServiceProvider, String, Int32[], IVsWindowFrame). Der Aufrufer dieser Methode kann vordefinierte Bezeichner verwenden, die Toolfenstern zugeordnet sind, wenn diese Toolfenster dem Aufrufer bekannt sind.
- ppWindowFrame
- IVsWindowFrame
[out] Zeiger auf das IVsWindowFrame-Objekt, das das Toolfenster enthält.
Gibt zurück
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Hinweise
COM-Signatur
Aus vsshell. idl:
HRESULT IVsUIShell::FindToolWindow(
[in] VSFINDTOOLWIN grfFTW,
[in] REFGUID rguidPersistenceSlot,
[out] IVsWindowFrame **ppWindowFrame
);
Diese Methode erfordert, dass ein vollständig erstelltes Tool Fenster vorhanden ist. Aufgrund der verzögerten Erstellung von Tool Fenstern kann ein gültiger Fensterrahmen vorhanden sein, das Fenster wurde jedoch möglicherweise noch nicht erstellt. Wenn der Fensterrahmen nicht mit einem Objekt gefüllt ist, schlägt die Umgebung fehl, und die übergeordnete Routine ist für das Abschließen der Fenster Erstellung verantwortlich. Wenn Sie jedoch den Wert FTW_fForceCreate für den-Parameter angeben grfFTW , versucht die Umgebung, das Tool Fenster für Sie zu erstellen. Wenn Sie den Wert angeben FTW_fFrameOnly , gibt die Umgebung einen Zeiger auf den Fensterrahmen zurück, auch wenn der Fensterrahmen nicht mit einem-Objekt gefüllt ist. Verwenden FTW_fFrameOnly Sie den Wert, um eine Eigenschaft für den Fensterrahmen für ein Tool Fenster festzulegen. in diesem Fall ist kein vollständig erstelltes Tool Fenster erforderlich.