EditorFactory.CreateEditorInstance, méthode
Utilisé pour créer l'éditeur du cœur de Visual Studio, un éditeur qui prend en charge la séparation de données/vue.
Espace de noms : Microsoft.VisualStudio.Package
Assemblys : Microsoft.VisualStudio.Package.LanguageService (dans Microsoft.VisualStudio.Package.LanguageService.dll)
Microsoft.VisualStudio.Package.LanguageService.9.0 (dans Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
Microsoft.VisualStudio.Package.LanguageService.11.0 (dans Microsoft.VisualStudio.Package.LanguageService.11.0.dll)
Microsoft.VisualStudio.Package.LanguageService.10.0 (dans Microsoft.VisualStudio.Package.LanguageService.10.0.dll)
Syntaxe
'Déclaration
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
)
Paramètres
- createDocFlags
Type : System.UInt32
Balises qui définissent les conditions pour créer le principal éditeur.
- moniker
Type : System.String
Formulaire de chaîne de l'identificateur de moniker du document dans le système de projet.Dans le cas des documents qui sont des fichiers, c'est toujours le chemin d'accès au fichier.Ce paramètre peut également être utilisé pour spécifier les documents qui ne sont pas des fichiers.Par exemple, dans un projet de base de données, ce paramètre peut contenir une chaîne qui fait référence à des enregistrements dans un tableau.
- physicalView
Type : System.String
Nom de la vue physique.
- pHier
Type : Microsoft.VisualStudio.Shell.Interop.IVsHierarchy
Objet IVsHierarchy.
- itemid
Type : System.UInt32
Identificateur d'élément de la principale instance de l'éditeur.
- existingDocData
Type : System.IntPtr
Doit être l'objet d'docData qui est enregistré dans le Tableau en cours d'exécution (RDT) de document.Ce paramètre est utilisé pour déterminer si une mémoire tampon de document (objet de données de document) a été déjà créée.Lorsqu'une fabrique d'éditeur est pour créer une vue secondaire, ce paramètre sera NULL non- indiquant qu'il n'y a aucune mémoire tampon de document.
- docView
Type : System.IntPtr%
Objet de vue de document.Retourne NULL si un éditeur externe existe, sinon retourne la vue du document.
- docData
Type : System.IntPtr%
Objet de données de document.Retourne la mémoire tampon pour le document.
- editorCaption
Type : System.String%
Légende initiale définie par l'éditeur de document pour la fenêtre de document.C'est en général une chaîne placée entre crochets les crochets, par exemple « [] » formulaire.Cette valeur est passée comme paramètre d'entrée à la méthode d'CreateDocumentWindow.Si le fichier est [en lecture seule] la légende sera définie pendant la charge du fichier.
- cmdUI
Type : System.Guid%
Retourne la commande interface utilisateur GUID.Ce GUID est actif lorsque cet éditeur est activé.Tout élément d'interface visible dans l'éditeur doit utiliser ce GUID.Ce GUID est utilisé dans le fichier de .ctc dans le DLL satellite où il indique les menus et barres d'outils doivent être affichées lorsque le document est actif.
- cancelled
Type : System.Int32%
Énumération de type __VSEDITORCREATEDOCWIN.Ces balises sont passées à la méthode d'CreateDocumentWindow.Cette valeur est définie à 0 dans l'implémentation d'EditorFactory.
Valeur de retour
Type : System.Int32
Si la méthode réussit, elle retourne S_OK.En cas d'échec, un code d'erreur est retourné.
Implémentations
Remarques
L'éditeur du cœur de Visual Studio est le gestionnaire de commandes primaire.
Sécurité .NET Framework
- Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.