Eigenschaftenfenster-Felder und Schnittstellen
Das Modell, für die Auswahl, welche Informationen im Eigenschaften Fenster angezeigt wird, basiert auf das Fenster, das den Fokus in der IDE hat. Jedes Fenster und - Objekt innerhalb des ausgewählten Fensters sein können, für die Auswahl, die auf den globalen Auswahlkontext gedrückt wird. Die Umgebung aktualisiert den globalen Auswahlkontext mit Werten aus einem Fensterrahmen, wenn dieses Fenster den Fokus besitzt. Wenn der Fokus geändert wird, hat dies den Auswahlkontext.
Nachverfolgungs-Auswahl in der IDE
Der Fensterrahmen oder die Website, die von der IDE gehört, ist ein Dienst, der STrackSelectionaufgerufen wird. Die folgenden Schritte zeigen, wie eine Änderung einer Auswahl des Benutzers bewirkt, dass entweder der Fokus zu einem anderen geöffneten Fenstern ändern oder ein anderes Projektelement in Projektmappen-Explorerauswählt, implementiert wird, um den Inhalt zu ändern, der im Eigenschaften Fenster angezeigt wird.
Das Objekt, das von einem VSPackage erstellt wird, das im ausgewählten Fenster positioniert ist, ruft QueryService auf, um STrackSelection Aufruf ITrackSelectionhaben.
Der Auswahlcontainer, vorausgesetzt, durch das ausgewählte Fenster erstellt ein eigenes ISelectionContainer-Objekt. Wenn die Auswahl ändert, wird ein VSPackage OnSelectChange an alle Listener in der Umgebung, einschließlich des Eigenschaften Fenster, die Änderung zu benachrichtigen. Sie bietet auch Zugriff auf die Hierarchie und das Element, das der neuen Auswahl informationsbezogen ist.
Aufrufen von OnSelectChange und Übergeben der ausgewählten Elemente in Hierarchien VSHPROPID_BrowseObject-Parameter füllt das ISelectionContainer-Objekt auf.
Ein Objekt, das von IDispatch Interface abgeleitet wird, ist für VSHPROPID_BrowseObject für das angeforderte Element zurückgegeben, und die Umgebung bindet es an ein ISelectionContainer (siehe nachfolgenden Schritt). Wenn der Aufruf fehlschlägt, wird die Umgebung IVsHierarchy::GetPropertyeinen zweiten Aufruf und übergibt ihn der Auswahlcontainer VSHPROPID_SelContainer , den das Hierarchien oder - Elemente festlegen.
Das Projekt ein VSPackage ISelectionContainer nicht erstellt werden, da das Umgebung-angegebene VSPackages Fenster, das sie implementiert (z. B. Projektmappen-Explorer) ISelectionContainer für die Zwecke erstellt.
Die Umgebung ruft die Methoden von ISelectionContainer auf, um die Objekte auf Grundlage der IDispatch-Schnittstelle abzurufen, um das Eigenschaften Fenster auszufüllen.
Wenn ein Wert im Eigenschaften Fenster geändert wird, VSPackages-Werkzeug IVsTrackSelectionEx::OnElementValueChangeEx und IVsTrackSelectionEx::OnSelectionChangeEx , die Änderung des Elementwert. Die Umgebung wird anschließend IVsUIShell oder IConnectionPointContainer auf, um die Informationen im Fenster angezeigt Eigenschaften auszuführen, das mit den Eigenschaftswerten synchronisiert wird. Weitere Informationen finden Sie unter Gewusst wie: Update-Eigenschaftswerte im Eigenschaftenfenster.
Neben der Auswahl eines anderen Projektelements in Projektmappen-Explorer , um die Eigenschaften anzuzeigen, die für dieses Element verknüpft sind, können Sie ein anderes Objekt aus einem Formular oder einem Dokumentfenster auch mithilfe der Dropdownliste auswählen, die auf dem Eigenschaften Fenster verfügbar ist. Weitere Informationen finden Sie unter Eigenschaftenfenster-Objektliste.
Sie können ändern, wie Informationen im Raster aus alphabetischem Eigenschaften Fenster zu Kategoriem angezeigt werden, und falls verfügbar, können Sie eine Eigenschaftenseite für ein ausgewähltes Objekt auch öffnen, indem Sie auf die entsprechenden Schaltflächen im Eigenschaften Fenster klicken. Weitere Informationen finden Sie unter Eigenschaftenfenster-Schaltflächen und Eigenschaftenseiten.
Schließlich enthält den unteren Rand des Fensters Eigenschaften auch eine Beschreibung des Felds, das im Fenster Eigenschaften Raster ausgewählt ist. Weitere Informationen finden Sie unter Gewusst wie: Ruft ab Eigenschaftenfenster-Feld-Beschreibungen.