IVsProjectSpecificEditorMap2.GetSpecificEditorProperty(String, Int32, Object) 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.
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
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.