Metoda EditorFactory.CreateEditorInstance —
Używane do tworzenia Visual Studio podstawowy edytor, edytor, który obsługuje separacji/widok danych.
Przestrzeń nazw: Microsoft.VisualStudio.Package
Zestawy: Microsoft.VisualStudio.Package.LanguageService (w Microsoft.VisualStudio.Package.LanguageService.dll)
Microsoft.VisualStudio.Package.LanguageService.9.0 (w Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
Microsoft.VisualStudio.Package.LanguageService.11.0 (w Microsoft.VisualStudio.Package.LanguageService.11.0.dll)
Microsoft.VisualStudio.Package.LanguageService.10.0 (w Microsoft.VisualStudio.Package.LanguageService.10.0.dll)
Składnia
'Deklaracja
Public Overridable Function CreateEditorInstance ( _
createDocFlags As UInteger, _
moniker As String, _
physicalView As String, _
pHier As IVsHierarchy, _
itemid As UInteger, _
existingDocData As IntPtr, _
<OutAttribute> ByRef docView As IntPtr, _
<OutAttribute> ByRef docData As IntPtr, _
<OutAttribute> ByRef editorCaption As String, _
<OutAttribute> ByRef cmdUI As Guid, _
<OutAttribute> ByRef cancelled As Integer _
) As Integer
public virtual int CreateEditorInstance(
uint createDocFlags,
string moniker,
string physicalView,
IVsHierarchy pHier,
uint itemid,
IntPtr existingDocData,
out IntPtr docView,
out IntPtr docData,
out string editorCaption,
out Guid cmdUI,
out int cancelled
)
Parametry
- createDocFlags
Typ: System.UInt32
Flagi, które określają warunki, pod którym chcesz utworzyć podstawowy edytor.
- moniker
Typ: System.String
Ciąg formularza identyfikator moniker dokumentu w systemie projektu.W odniesieniu do dokumentów, które są plikami to jest zawsze ścieżką do pliku.Ten parametr można również określić dokumenty, które nie są plikami.Na przykład w projekcie zorientowana na bazy danych, ten parametr może zawierać ciąg, który odnosi się do rekordów w tabeli.
- physicalView
Typ: System.String
Nazwa widoku fizyczne.
- pHier
Typ: Microsoft.VisualStudio.Shell.Interop.IVsHierarchy
IVsHierarchy Obiektu.
- itemid
Typ: System.UInt32
Identyfikator elementu instancji Edytor core.
- existingDocData
Typ: System.IntPtr
Musi być docData obiekt, który jest zarejestrowany w uruchomiony dokumentu tabeli (RDT).Ten parametr jest używany do określenia, jeśli została już utworzona buforu dokumentu (dokument danych obiektu).Zapytany fabryka edytor do tworzenia wtórnych Widok ten parametr będzie non-NULL wskazująca, że jest w buforze dokumentu.
- docView
Typ: System.IntPtr%
Obiekt widoku dokumentu.Zwraca NULL , jeśli istnieje w zewnętrznym edytorze, w przeciwnym razie zwraca widoku dokumentu.
- docData
Typ: System.IntPtr%
Obiekt danych dokumentu.Zwraca buforu dla dokumentu.
- editorCaption
Typ: System.String%
Podpis początkowe określone przez Edytor dokumentu w oknie dokumentu.Zazwyczaj jest to ciąg w nawiasach kwadratowych, takie jak "[Form]".Wartość ta jest przekazywana jako parametr wejściowy, aby CreateDocumentWindow metody.Jeśli plik jest [tylko do odczytu] podpis zostanie ustawiona podczas ładowania pliku.
- cmdUI
Typ: System.Guid%
Zwraca identyfikator GUID interfejsu użytkownika polecenia.Ten identyfikator GUID jest aktywne po uaktywnieniu tego edytora.Każdy element interfejsu użytkownika, który jest widoczny w edytorze ma używać ten identyfikator GUID.Ten identyfikator GUID jest używany w pliku .ctc w satelitarnych biblioteki DLL, gdzie wskazuje które menu i paski narzędzi mają być wyświetlane, gdy dokument jest aktywny.
- cancelled
Typ: System.Int32%
Wyliczenia typu __VSEDITORCREATEDOCWIN.Flagi te są przekazywane do CreateDocumentWindow metody.Ta wartość jest ustawiona 0 w EditorFactory wdrożenia.
Wartość zwracana
Typ: System.Int32
Jeśli metoda się powiedzie, zwraca S_OK.Jeśli nie powiedzie się, zwraca kod błędu.
Implementuje
Uwagi
Visual Studio Jest Edytor core obsługi podstawowe polecenia.
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Przy użyciu bibliotek z częściowo zaufanego kodu..