IVsAsyncShellOpenDocument.OpenStandardEditorAsync Yöntem

Başvuru

Tanım

Ad Alanı:: Microsoft.VisualStudio.Shell.Interop

Bütünleştirilmiş Kod:: Microsoft.VisualStudio.Interop.dll

Paket:: Microsoft.VisualStudio.Interop v17.9.37000

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Standart düzenleyiciyi kullanarak bir dosyayı açar. Önce dosya için varsayılan bir düzenleyici fabrikasının zaten yapılandırılıp yapılandırılmadığını belirler. Varsayılan ayar henüz yapılandırılmamışsa, belgeyi destekleyen ilk fabrikayı bulmak için önceliğe göre sıralanmış düzenleyici fabrikaları listesinde döngüye geçer. Belge açılamıyorsa bir özel durum oluşturulur.

public Microsoft.VisualStudio.Shell.Interop.IVsTask OpenStandardEditorAsync (uint openStandardEditorFlags, string documentMoniker, Guid logicalView, string? ownerCaption, Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy? hierarchy, uint itemId, bool shouldGetDocDataFromRdt, object? docData, Microsoft.VisualStudio.OLE.Interop.IServiceProvider serviceProvider);

abstract member OpenStandardEditorAsync : uint32 * string * Guid * string * Microsoft.VisualStudio.Shell.Interop.IVsUIHierarchy * uint32 * bool * obj * Microsoft.VisualStudio.OLE.Interop.IServiceProvider -> Microsoft.VisualStudio.Shell.Interop.IVsTask

Public Function OpenStandardEditorAsync (openStandardEditorFlags As UInteger, documentMoniker As String, logicalView As Guid, ownerCaption As String, hierarchy As IVsUIHierarchy, itemId As UInteger, shouldGetDocDataFromRdt As Boolean, docData As Object, serviceProvider As IServiceProvider) As IVsTask

Parametreler

openStandardEditorFlags: UInt32

Değerleri veya __VSOSEFLAGS2 numaralandırmasından __VSOSEFLAGS alınan bayraklar.

documentMoniker: String

Proje sistemindeki belgenin benzersiz bilinen tanımlayıcısının dize biçimi, örneğin dosyanın tam yolu. Dosya olmayan durumlarda, bu tanımlayıcı genellikle URL biçimindedir.

logicalView: Guid

Guid Mantıksal görünümü tanımlayan. Varsayılan görünümdür VSConstants.LOGVIEWID_Primary ve her düzenleyicinin bu görünümü desteklemesi gerekir.

Düzenleyici belge görünümü nesnesine uygularsa IVsMultiViewDocumentView , düzenleyici penceresi gösterildiğinde hangi görünümün etkinleştirileceğini belirleyen öğesine geçirilen ActivateLogicalView(Guid)değerdir.

mantıksal görünümünü Guidbelirterek, görünümü isteme nedeninizle eşleşen belirli bir görünümü isteyebilirsiniz. Örneğin, hata ayıklamaya uygun görünümü almak veya VSConstants.LOGVIEWID_TextView metin düzenleyicisi için uygun görünümü almak için (yani uygulayan IVsCodeWindowbir görünüm) belirtinVSConstants.LOGVIEWID_Debugging.

ownerCaption: String

Belge penceresi için belge sahibi (proje) tarafından tanımlanan ilk başlık. Bu genellikle şu biçimdedir: "ProjectName – ItemName."

hierarchy: IVsUIHierarchy

Belgenin IVsUIHierarchy sahibi olan başvuru.

itemId: UInt32

Standart düzenleyicinin KULLANıCı arabirimi hiyerarşi öğesi tanımlayıcısı. Daha fazla bilgi için bkz. VSConstants.VSITEMID.

shouldGetDocDataFromRdt: Boolean

ise true, ortam Çalışan Belge Tablosu'ndan alınan belge veri nesnesini kullanır; aksi takdirde, hizmet belgeyi öğesine docDatageçirilen belge verilerini kullanarak açar.

docData: Object

veya nulldosyasını açmak için öğenin belge veri nesnesine başvuru. bu parametreye geçirilen bu değer ise shouldGetDocDataFromRdttrueyoksayılır.

serviceProvider: IServiceProvider

öğesine bir IServiceProviderbaşvuru.

Döndürülenler

IVsTask

Açma işleminin başlatıldığını temsil eden bir görev. Görevin sonucu, belge ortamda açıldıysa bir IVsAsyncOpenDocumentResultbaşvurusudur; aksi takdirde , null.

Açıklamalar

Bu yöntem tarafından döndürülen görev, belgenin görünümünün ve docdata'nın yüklendiğini göstermez. Diğer ayrıntılar için bkz DocumentLoadTask .

Bu yöntem, desteklenen bir düzenleyici fabrikasını bulmak için listede bir sonraki düzenleyiciye döngü yapmaya devam edip etmeyeceğini belirlemek için sonucunu CreateEditorInstance(UInt32, String, String, IVsHierarchy, UInt32, IntPtr, IntPtr, IntPtr, String, Guid, Int32) kullanır. Özellikle aşağıdakilerden birini döndürmelidir: 1. S_OK düzenleyici dosyayı destekliyorsa ve başarıyla başlatıldıysa döngünün durması gerektiğini belirtmek için 2. "VS_E_UNSUPPORTEDFORMAT" düzenleyici sağlanan belge verilerini desteklemiyorsa döngüye devam etmesi gerektiğini belirtmek için 3. Döngünün durması gerektiğini belirten diğer hata kodları.

Şunlara uygulanır