This documentation is archived and is not being maintained.


Controls how a new document window is created.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in

public enum __VSCREATEDOCWIN
public enum __VSCREATEDOCWIN
public enum __VSCREATEDOCWIN

 Member nameDescription
CDW_fAltDocDataUsed for editing sub-pieces of a larger document in individual document windows.  
CDW_fCreateNewWindowAllows an additional window to be created for Window.NewWindow support. 
CDW_fDockableObsolete. Do not use.  
CDW_RDTFLAGS_MASKMask for running document table flags.  

When you open a document in an editor, an entry for the document data (DocData) is made in the running document table (RDT). However, you can have one physical document with multiple sub-parts that need to be edited in separate windows, like the resource editor. In this case, more than one entry would be placed in the RDT for the same DocData, which would return an error. To avoid this, specify a value of CDW_fAltDocData to make one document entry in the RDT for the entire file, but open individual document windows for each of the subparts. For this to work, the main document always has to be open. For an example of specifying alternate document data, see the Solution Extender Sample sample.

You can combine the __VSCREATEDOCWIN flags with the RDT_DOCMASK flags in the _VSRDTFLAGS enumeration when creating a document window.

COM Signature

From vsshell.idl: