Parameterinformationens-QuickInfo

Die IntelliSense-Parameterinformationens die QuickInfo bietet Benutzern Hinweise dazu, die sie in einem Sprachkonstrukt sind.

Wie arbeiten Parameterinformationens-QuickInfo

Wenn Sie eine Anweisung im Editor eingeben, zeigt ein VSPackage ein kleines QuickInfo-Fenster angezeigt, das die Definition der Anweisung enthält, die typisiert ist. Wenn Sie beispielsweise eine Anweisung Microsoft Foundation Classes (MFC) (How pMainFrame ->UpdateWindow) eingeben und die öffnende Klammer links-Taste Listen drücken, um Parameter zu beginnen, wird ein tipp Methoden aus, in dem gezeigt wird die Definition der UpdateWindow-Methode.

Parameterinformationens die QuickInfo werden normalerweise in Verbindung mit Anweisungsvervollständigung verwendet. Sie sind besonders hilfreich für Sprachen, die Parameter oder andere formatierte Informationen nachdem der Methodenname oder - Schlüsselwort haben.

Die Parameterinformationens die QuickInfo werden vom Sprachdienst von Befehls abfangen initiiert. Um Benutzern abgefangen wird, muss das Sprachdienst Objekt die IOleCommandTarget-Schnittstelle implementieren und die Textansicht ein Zeiger auf die IOleCommandTarget Implementierung übergeben, indem es die AddCommandFilter-Methode in der IVsTextView-Schnittstelle aufruft. Der Befehl Befehle fängt Filter ab, die Sie im Codefenster eingeben. Überwachen Sie die Befehlsinformationen, um festzustellen, wann die Parameterinformationen für den Benutzer angezeigt werden. Sie können denselben Befehl für die Anweisungsvervollständigung marker Filter verwenden, Fehler usw.

Wenn Sie ein Schlüsselwort, für das der Sprachdienst Hinweise bereitstellen kann, erstellt der Sprachdienst ein IVsMethodTipWindow-Objekt und ruft die UpdateTipWindow-Methode in der IVsTextView-Schnittstelle auf, um die IDE zu benachrichtigen, um einen Hinweis angezeigt. Erstellen Sie das Objekt mithilfe IVsMethodTipWindowVSLocalCreateInstance und zum Bereitstellen der Co-Klasse CLSID_VsMethodTipWindow. VsLocalCreateInstance ist eine Funktion, die vsdoc.h in der Headerdatei definiert ist, die Registrierung für die lokale QueryService aufruft und CreateInstance für dieses Objekt für CLSID_VsMethodTipWindowaufruft.

Bereitstellen eines Methoden-Tipps

Um einen Methoden tipp bereitzustellen, rufen Sie die SetMethodData-Methode in der IVsMethodTipWindow-Schnittstelle auf, und übergeben Sie ihr die Implementierung der IVsMethodData-Schnittstelle.

Wenn die IVsMethodData-Klasse aufgerufen wird, werden die entsprechenden Methoden in der folgenden Reihenfolge aufgerufen:

• GetContextStream

  Gibt die Position und Länge der relevanten Daten im aktuellen Textpuffer zurück. Dadurch wird die IDE auf, um diese Daten verdeckt sind nicht mit dem QuickInfo-Fenster.

• GetCurMethod

  Gibt die Methoden zurück (nullbasierten Index Zahl), das Sie zuerst angezeigt werden soll. Wenn Sie beispielsweise Null zurückgeben, dann die erste überladene Methode wird zuerst dargestellt.

• GetOverloadCount

  Gibt die Anzahl der überladenen Methoden zurück, die im aktuellen Kontext angewendet werden können. Wenn Sie einen Wert zurückgeben, der größer als 1 für diese Methode handelt, die Text anzeigen und auf die Pfeile ab. Wenn Sie auf den Pfeil nach unten klicken, wird die IDE die NextMethod-Methode auf. Wenn Sie auf den Pfeil Pfeil klicken, wird die IDE die PrevMethod-Methode auf.

• GetMethodText

  Der Text der Parameterinformationens die QuickInfo wird während einiger Aufrufe an GetMethodText und GetParameterText-Methode erstellt.

• GetParameterCount

  Gibt die Anzahl der Parameter zurück, das in der Methode anzuzeigen.

• GetParameterText

  Wenn Sie eine Methoden Zahl zurückgeben, die der Überladung entspricht angezeigt soll, wird diese Methode aufgerufen, gefolgt von einem Aufruf der UpdateView-Methode.

• UpdateView

  Informiert den Sprachdienst, um den Editor zu aktualisieren, wenn ein Methoden tipp angezeigt wird. In der UpdateView-Methode rufen Sie Folgendes an:

  <pTxWin> ->UpdateTipWindow(<pTip>, UTW_CONTENTCHANGED | UTW_CONTEXTCHANGED).
  

• OnDismiss

  Sie erhalten einen Aufruf der OnDismiss-Methode, wenn Sie das Fenster schließen Methoden tipp.