IVsExternalFilesManager2.AddDocument 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:

Programlı olarak çeşitli dosyalar projesine bir düğüm eklemesini söyler.

public:
 int AddDocument(System::UInt32 dwCDW, System::String ^ pszMkDocument, IntPtr punkDocView, IntPtr punkDocData, Guid % rguidEditorType, System::String ^ pszPhysicalView, Guid % rguidCmdUI, System::String ^ pszOwnerCaption, System::String ^ pszEditorCaption, [Runtime::InteropServices::Out] int % pfDefaultPosition, [Runtime::InteropServices::Out] Microsoft::VisualStudio::Shell::Interop::IVsWindowFrame ^ % ppWindowFrame);
public int AddDocument (uint dwCDW, string pszMkDocument, IntPtr punkDocView, IntPtr punkDocData, ref Guid rguidEditorType, string pszPhysicalView, ref Guid rguidCmdUI, string pszOwnerCaption, string pszEditorCaption, out int pfDefaultPosition, out Microsoft.VisualStudio.Shell.Interop.IVsWindowFrame ppWindowFrame);
abstract member AddDocument : uint32 * string * nativeint * nativeint * Guid * string * Guid * string * string * int * IVsWindowFrame -> int
Public Function AddDocument (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, 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. Ortam bu yolu, çalışan belge tablosunda (RDT) görünümü kaydetmek için kullanır.

punkDocView
IntPtr

nativeint

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

punkDocData
IntPtr

nativeint

'ndaki IUnknown Belgenin, görünüm veya veri ayrımı olduğu durumlarda eklenmekte olan belge veri nesnesini temsil eden bir nesne arayüzüne 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 adına öğesinin 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) .

pfDefaultPosition
Int32

dışı null Çağıranın pencere için varsayılan konum bilgisini istememe durumunda 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) 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.

Uygulamalar

AddDocument(UInt32, String, IntPtr, IntPtr, Guid, String, Guid, String, String, Int32, IVsWindowFrame)

Açıklamalar

COM Imzası

Vsshell. IDL dosyasından:

HRESULT IVsExternalFilesManager2::AddDocument(  
   [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,  
   [out] BOOL *pfDefaultPosition,  
   [out] IVsWindowFrame **ppWindowFrame  
);

Yönteme çok benzer CreateDocumentWindow . AddDocument , parametreleri ItemId ve pUIH (bir işaretçisi IVsHierarchy ) Içermez çünkü Miscellaneous Files projesi kendi ItemId ve pUIH çiftini atar ve AddDocument bir belge penceresi oluşturmak için parametrelerin geri kalanını kullanır.

Şunlara uygulanır