_VSRDTFLAGS4 Enumeration

  • Article

Specifies options for a document in the running document table (RDT).

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop.12.0 (in Microsoft.VisualStudio.Shell.Interop.12.0.dll)

Syntax

'Declaration
<FlagsAttribute> _
Public Enumeration _VSRDTFLAGS4

[FlagsAttribute]
public enum _VSRDTFLAGS4

[FlagsAttribute]
public enum class _VSRDTFLAGS4

[<FlagsAttribute>]
type _VSRDTFLAGS4

public enum _VSRDTFLAGS4

Members

Member name Description
RDT_PendingHierarchyInitialization The document's hierarchy hasn't yet been initialized; it will be initialized on demand.

Several things can cause the hierarchy to be initialized, including but not limited to:

  1. Calling GetDocumentInfo requesting the hierarchy or item id.

  2. Requesting various properties from the document's window frame, including:

    1. VSFPROPID_Hierarchy

    2. VSFPROPID_ItemID

  3. The owning project is loaded.

Documents that have RDT_PendingInitialization also have this flag if the document's project has not yet been loaded when the document is created. When the document's project is eventually loaded, RDT_PendingHierarchyInitialization will be cleared and OnAfterAttributeChanged(Ex) will be raised with RDTA_HierarchyInitialized. RDTA_HierarchyInitialized may be followed very closely by RDTA_DocumentInitialized, but that isn't guaranteed.

This flag is set by the system. It cannot be specified by the caller when registering the document.
RDT_PendingInitialization The document hasn't yet been initialized; it will be initialized on demand.

Several things can cause the document to be initialized, including but not limited to:

  1. Calling IVsRunningDocumentTable.GetDocumentInfo requesting the docdata.

  2. Requesting various properties from the document's window frame, including:

    1. VSFPROPID_DocView

    2. VSFPROPID_ViewHelper

    3. VSFPROPID_DocData

    4. VSFPROPID_AltDocData

    5. VSFPROPID_RDTDocData

Documents that are auto-opened when reloading a solution are created with this flag. If the auto-opened document's project has not yet been loaded, it will also have the RDT_PendingHierarchyInitialization flag. When the document is fully initialized, RDT_PendingInitialization will be cleared and OnAfterAttributeChanged(Ex) will be raised with RDTA_DocumentInitialized.

This flag is set by the system. It cannot be specified by the caller when registering the document.

See Also

Reference

Microsoft.VisualStudio.Shell.Interop Namespace