IVsExternalFilesManager2.AddDocumentEx Yöntem

  • Başvuru

Tanım

Ad Alanı:
Microsoft.VisualStudio.Shell.Interop
Bütünleştirilmiş Kod:
Microsoft.VisualStudio.Shell.Interop.dll
Bütünleştirilmiş Kod:

Bir düğüm eklemek için programlı olarak çeşitli dosyalar projesi bildirir, düğüm simgesi üzerinde denetime izin verir ve düzenleyicinin bağlamsal Hizmetleri sorgulaması için bir fırsat sağlar.

public:
 int AddDocumentEx(System::UInt32 dwCDW, System::String ^ pszMkDocument, IntPtr punkDocView, IntPtr punkDocData, Guid % rguidEditorType, System::String ^ pszPhysicalView, Guid % rguidCmdUI, System::String ^ pszOwnerCaption, System::String ^ pszEditorCaption, Microsoft::VisualStudio::OLE::Interop::IServiceProvider ^ pspContext, IntPtr hicon, [Runtime::InteropServices::Out] int % pfDefaultPosition, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsWindowFrame ^ % ppWindowFrame);
public int AddDocumentEx (uint dwCDW, string pszMkDocument, IntPtr punkDocView, IntPtr punkDocData, ref Guid rguidEditorType, string pszPhysicalView, ref Guid rguidCmdUI, string pszOwnerCaption, string pszEditorCaption, Microsoft.VisualStudio.OLE.Interop.IServiceProvider pspContext, IntPtr hicon, out int pfDefaultPosition, out Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame ppWindowFrame);
abstract member AddDocumentEx : uint32 * string * nativeint * nativeint * Guid * string * Guid * string * string * Microsoft.VisualStudio.OLE.Interop.IServiceProvider * nativeint * int * IVsWindowFrame -> int
Public Function AddDocumentEx (dwCDW As UInteger, pszMkDocument As String, punkDocView As IntPtr, punkDocData As IntPtr, ByRef rguidEditorType As Guid, pszPhysicalView As String, ByRef rguidCmdUI As Guid, pszOwnerCaption As String, pszEditorCaption As String, pspContext As IServiceProvider, hicon As IntPtr, ByRef pfDefaultPosition As Integer, ByRef ppWindowFrame As IVsWindowFrame) As Integer

Parametreler

dwCDW
UInt32

'ndaki __VSCREATEDOCWIN Belge penceresinin nasıl oluşturulduğunu belirleyen bayrakları tanımlar.

pszMkDocument
String

'ndaki Belge yolu. Bu yol, bu görünümü çalışan belge tablosuna (RDT) kaydetmek için ortam tarafından kullanılır.

punkDocView
IntPtr

nativeint

'ndaki IUnknown Bu pencere içinde görüntülenecek belge görünümü nesnesinin arabirimine yönelik işaretçi.

punkDocData
IntPtr

nativeint

'ndaki IUnknown Görünüm veya veri ayrımı olduğu durumlarda bu belgenin belge verileri nesnesini temsil eden nesnenin arabirimine yönelik işaretçi. Örneğin, çekirdek metin Düzenleyicisi bir metin görünümü nesnesine ( VsTextView nesne) ve metin arabelleği nesnesine ( VsTextBuffer nesne) sahiptir. Bu parametre olabilir null . Geçirme, null ortamın çağıranın adına varsayılan uygulamasının bir örneğini oluşturmasına neden olur punkDocData .

rguidEditorType
Guid

'ndaki Belge görünümü ve belge veri nesnelerinin bir örneğini oluşturan düzenleyici fabrikasının benzersiz tanıtıcısı. Belge bir düzenleyici fabrikası kullanılarak oluşturulmadıysa bu GUID_NULL olmalıdır (yani, belirli bir projenin özel bilgileri ile bir örnek oluşturulur).

pszPhysicalView
String

'ndaki Düzenleyicinin fiziksel görünüm türünü tanımlayacak dize.

rguidCmdUI
Guid

'ndaki Bu belge etkin olduğunda, ana menü çubuğuna hangi menü kümesinin birleştirildiğini belirten GUID 'ı belirtir. Komutların ve araç pencerelerinin görünürlüğünü açmak için kullanılır.

pszOwnerCaption
String

'ndaki Belge sahibi tarafından tanımlanan ilk başlık (yani, proje). Bu genellikle şu biçimdedir: "ProjectName – ItemName."

pszEditorCaption
String

'ndaki Belge penceresi belge Düzenleyicisi tarafından tanımlanan ilk başlık. Bu genellikle köşeli ayraç içine alınmış bir dizedir (örneğin, [salt okuma]). Bu parametrenin başlangıçtaki değeri, yönteminde bir [out] parametresi olarak döndürülür CreateEditorInstance(UInt32, String, String, IVsHierarchy, UInt32, IntPtr, IntPtr, IntPtr, String, Guid, Int32) .

pspContext
IServiceProvider

dışı IServiceProvider Arabirim işaretçisi. Olabilir null . Bu, arayanın (çeşitli dosyalar Projesi) tarafından sunulan ek bir hizmet sağlayıcıdır. çağıranın, ekli düzenleyiciye ek bağlam (Hizmetler aracılığıyla) sağlaması mümkün hale getirir. Bu nedenle, katıştırılmış nesne bir hizmet isteği yaptığında, çerçeve bu isteği karşılamaya çalışır. Hizmet çerçeve tarafından sağlanmazsa, pSP denenir. Hizmet orada bulunamazsa, ortamın genel hizmet sağlayıcısı sorgulanır.

hicon
IntPtr

nativeint

'ndaki Bir simgenin tanıtıcısını belirtir. Çeşitli proje düğümünün simgesini belirtmenize izin verir.

pfDefaultPosition
Int32

dışı Çağıran, pencere için varsayılan konum bilgilerini karşılamıyorsa null olabilir. true ortamda bu araç penceresinin son konumu hakkında kaydedilmiş bir bilgi yoksa (Bu, guidPersistenceSlot bulunamadı), bu nedenle ekranda bir varsayılan konuma yerleştirildi. false Bu pencere, kullanıcının en son bulduğu ve boyutlandırlandığı yere yerleştirilirse.

ppWindowFrame
IVsWindowFrame

dışı Pencerenin konumunu, boyutunu, resim yazısını ve diğer özelliklerini işlemek için kullanılabilen bu düzenleyiciyi içeren çerçeveye yönelik işaretçi. IUnknownEkleme (yani,) veya ' nin arabirim işaretçisini almak için de kullanılabilir punkDocView punkDocData .

Döndürülenler

Int32

Yöntem başarılı olursa, döndürür S_OK . Başarısız olursa, bir hata kodu döndürür.

Açıklamalar

COM Imzası

Vsshell. IDL dosyasından:

HRESULT IVsExternalFilesManager2::AddDocumentEx(  
   [in] VSCREATEDOCWIN dwCDW,  
   [in] LPCOLESTR pszMkDocument,  
   [in] IUnknown *punkDocView,  
   [in] IUnknown *punkDocData,  
   [in] REFGUID rguidEditorType,  
   [in] LPCOLESTR pszPhysicalView,  
   [in] REFGUID rguidCmdUI,  
   [in] LPCOLESTR pszOwnerCaption,  
   [in] LPCOLESTR pszEditorCaption,  
   [in] IServiceProvider *pspContext,  
   [in] HICON hIcon,  
   [out] BOOL *pfDefaultPosition,  
   [out] IVsWindowFrame **ppWindowFrame  
);

Yönteme benzer AddDocument . Çeşitli projeler simgesini belirtmenin ek işlevlerini sağlar ve düzenleyicinin bağlamsal Hizmetleri sorgulaması için bir fırsat sağlar.

Şunlara uygulanır