Freigeben über


IVsFindCancelDialog-Schnittstelle

Verwenden Sie die IVsFindCancelDialog-Schnittstelle zum Starten eines nicht modalen Dialogfelds im Hintergrundthread, der es Benutzern ermöglicht, eine langwierige Hintergrund der Such- und Ersetzungsvorgang oder abzubrechen.

Namespace:  Microsoft.VisualStudio.TextManager.Interop
Assembly:  Microsoft.VisualStudio.TextManager.Interop.8.0 (in Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Syntax

'Declaration
<InterfaceTypeAttribute()> _
<GuidAttribute("FE7C62A2-C121-4995-9EC1-561B80D2DA11")> _
Public Interface IVsFindCancelDialog
[InterfaceTypeAttribute()]
[GuidAttribute("FE7C62A2-C121-4995-9EC1-561B80D2DA11")]
public interface IVsFindCancelDialog
[InterfaceTypeAttribute()]
[GuidAttribute(L"FE7C62A2-C121-4995-9EC1-561B80D2DA11")]
public interface class IVsFindCancelDialog
[<InterfaceTypeAttribute()>]
[<GuidAttribute("FE7C62A2-C121-4995-9EC1-561B80D2DA11")>]
type IVsFindCancelDialog =  interface end
public interface IVsFindCancelDialog

Der IVsFindCancelDialog-Typ macht die folgenden Member verfügbar.

Methoden

  Name Beschreibung
Öffentliche Methode CloseDialog Entlässt ein nicht modales Dialogfeld Hintergrund mit LaunchDialoggeöffnet ist.
Öffentliche Methode LaunchDialog Startet ein nicht modales Dialogfeld im Hintergrundthread, mit dem der Benutzer eine langwierige Suche oder einem Ersetzungsvorgang abbrechen kann
Öffentliche Methode QueryDialog

Zum Seitenanfang

Hinweise

Verwenden Sie die IVsFindCancelDialog-Schnittstelle zum Starten eines nicht modalen Dialogfelds im Hintergrundthread, damit ein Benutzer eine langwierige Such- oder Such- und Ersetzungsvorgang abbrechen kann.

Diese Schnittstelle wird von der Visual Studio-Umgebung implementiert. So zeigen Sie können zuerst die LaunchDialog-Methode, das nicht modale Dialogfeld. Stimmen Sie das Dialogfeld ab, um zu ermitteln, ob der Benutzer den aktuellen Hintergrund suchvorgang abgebrochen hat, indem er die QueryDialog-Methode aufgerufen hat. Schließlich schließen Sie das Dialogfeld, indem Sie die CloseDialog-Methode aufrufen.

Die Implementierung der Umgebung dieser Schnittstelle ist Thread-bewusst, daher wird möglicherweise die Schnittstellenmethoden ohne Berücksichtigung an, ob der Prozess in den Vordergrund oder Hintergrundthreads ausgeführt wird.

Hinweise zur Implementierung

In der LaunchDialog-Methode Starten eines nicht modalen Dialogfelds im Hintergrundthread, wenn der Aufrufer auf dem Vordergrundthread handelt. Wenn der Aufrufer im Hintergrundthread handelt, ist es nicht erforderlich, um ein Dialogfeld zu öffnen, da der Benutzer in der Lage ist, den Suchvorgang abzubrechen, indem Sie auf die Schaltfläche Suchen Fertig stellen klickt.

Innerhalb QueryDialogwenn der Aufrufer auf dem Vordergrundthread handelt, fragen Sie threadübergreifend ab, um das Dialogfeld für Benutzereingaben abrufen muss.

Innerhalb CloseDialogwenn der Aufrufer auf dem Vordergrundthread handelt, schließen Sie das Dialogfeld, das Sie zuvor für LaunchDialoggeöffnet haben. Wenn der Aufrufer im Hintergrundthread handelt, ist es nicht erforderlich, um das Dialogfeld zu schließen, da Sie es nicht für den Aufruf von LaunchDialoggestartet haben.

Siehe auch

Referenz

Microsoft.VisualStudio.TextManager.Interop-Namespace