IVsProjectSpecificEditorMap2.GetSpecificEditorProperty(String, Int32, Object) Methode

Definition

Ruft Eigenschaften ab, die mit projektspezifischen Editoren und dem Dialogfeld Öffnen mit verknüpft sind.

public:
 int GetSpecificEditorProperty(System::String ^ pszMkDocument, int propid, [Runtime::InteropServices::Out] System::Object ^ % pvar);
int GetSpecificEditorProperty(std::wstring const & pszMkDocument, int propid, [Runtime::InteropServices::Out] winrt::Windows::Foundation::IInspectable const & & pvar);
public int GetSpecificEditorProperty (string pszMkDocument, int propid, out object pvar);
abstract member GetSpecificEditorProperty : string * int * obj -> int
Public Function GetSpecificEditorProperty (pszMkDocument As String, propid As Integer, ByRef pvar As Object) As Integer

Parameter

pszMkDocument
String

[in] Zeichenfolgendarstellung des eindeutigen Monikerbezeichners des Dokuments im Projektsystem.

propid
Int32

[in] Wenn gleich VSPSEPROPID_UseGlobalEditorByDefault (false), dann hat der Benutzer die Datei unter Verwendung der projektspezifischen Editorinformationen geöffnet, der im Dialogfeld "Öffnen mit" aufgeführt werden. Wenn VSPSEPROPID_UseGlobalEditorByDefault (true), wurde der globale Editor ausgewählt. Weitere Informationen finden Sie unter __VSPSEPROPID.

pvar
Object

[out, retval] Zeiger auf eine VARIANTE, die den Eigenschaftswert enthält.

Gibt zurück

Int32

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 IVsProjectSpecificEditorMap2::GetSpecificEditorProperty(  
   [in] LPCOLESTR pszMkDocument,  
   [in] VSPSEPROPID propid,  
   [out, retval] VARIANT *pvar  
);  

Wenn Sie die VSPSEPROPID_UseGlobalEditorByDefault -Eigenschaft unterstützen und zurückgeben true , wird der globale Editor standardmäßig verwendet. Wenn false, dann wird ein projektspezifischer Editor standardmäßig verwendet. Wenn Sie diese Eigenschaft unterstützen, <project default editor> wird dem Dialogfeld Öffnen mit ein Eintrag vom Typ "" hinzugefügt. Dieser Eintrag wird immer oben im Dialogfeld Öffnen mit platziert. Um diese Zeichenfolge auf einen anderen Wert als " <project default editor> " festzulegen, wird unterstützt IVsProjectSpecificEditorMap::GetSpecificEditorProperty ( VSPSEPROPID_ProjectDefaultEditorName ). Das Festlegen dieser Eigenschaft ist optional.

Es wird erwartet, dass das Projekt dauerhaft gespeichert wird (je nach Benutzer/pro Computer/pro Dateityp in der Registrierung unter HKEY_CURRENTUSER), ob der globale Standard Editor oder der projektspezifische Editor verwendet werden soll. Das Projekt verwendet diese Informationen dann, um zu ermitteln, ob oder aufgerufen werden soll, OpenStandardEditor OpenSpecificEditor Wenn ein Projekt Element geöffnet wird.

Im folgenden finden Sie ein kompliziertes Szenario, das Sie mit diesem Ansatz erreichen können. Sie verfügen über ein Projekt System, das eine spezielle Behandlung für XML-Dateien aufweist. Das heißt, das Projekt System bietet eine besondere Bearbeitungsfunktion für XML-Dateien. Der Benutzer kann zwischen der Verwendung des speziellen (Projekt bevorzugten) Editors für XML-Dateien oder der Verwendung des Global definierten Editors wählen. Der Benutzer wählt aus, dass die XML-Datei im Text-Editor geöffnet werden soll. Zu diesem Zweck wird der Text-Editor im Dialogfeld Öffnen mit als Standard Editor festgelegt. Wenn ein Benutzer anschließend auf eine XML-Datei im Projekt doppelklickt, wird die Datei im Text-Editor geöffnet.

Später wechselt der Benutzer in ein anderes Projekt (z. b. das Projekt "sonstige Dateien"), klickt mit der rechten Maustaste auf die Datei und legt den XML-Editor als Standard Editor für XML-Dateien fest. Wenn der Benutzer dann zum ursprünglichen Projekt zurückkehrt und auf die XML-Datei doppelklickt, wird die Datei im XML-Editor anstatt im Text-Editor geöffnet. Wenn der Benutzer jedoch ursprünglich entschieden hätte, dass das Projekt System den XML-Editor standardmäßig verwenden soll, dann wird unabhängig davon, welcher Editor als globaler Editor festgelegt ist, die XML-Dateien in diesem Projekt mit dem projektspezifischen Editor geöffnet, der als Standard Editor für das Projekt festgelegt wurde. Sowohl das VB-als auch das c#-Projekt System stellen spezielle Editoren für verschiedene Dateitypen bereit.

Gilt für