IVsUIShellOpenDocument3::GetProvisionalViewingStatusForFile Method (String^, IVsHierarchy^, UInt32, Guid)
Retrieves the provisional viewing status for the highest ranked editor associated with the file.
Assembly: Microsoft.VisualStudio.Shell.Interop.11.0 (in Microsoft.VisualStudio.Shell.Interop.11.0.dll)
unsigned int GetProvisionalViewingStatusForFile( String^ filename, IVsHierarchy^ hierarchy, unsigned int itemid, [InAttribute] Guid% logicalView )
Parameters
- filename
-
Type:
System::String^
[in] The name of the file.
- hierarchy
-
Type:
Microsoft.VisualStudio.Shell.Interop::IVsHierarchy^
[in] The hierarchy of the item.
- itemid
-
Type:
System::UInt32
[in] The item identifier of the item.
- logicalView
-
Type:
System::Guid
[in] The logical view to query.
Return Value
Type: System::UInt32The provisional viewing status as a member of __VSPROVISIONALVIEWINGSTATUS. The default provisional viewing status is PVS_Disabled, but can be modified by the editor's "CommonPhysicalViewAttributes" registry value and the values under its "PhysicalViewAttributes" registry subkey.
The physical view attributes – which declare if and how the physical view supports provisional viewing (that is, previewing) – are properties of the editor. In addition to physical view attributes, editors also declare what file types they can edit (for example, *.cs, *.xml, and so on) and the relative “rank” of the editor. Multiple editors can declare that they support the same file type and the shell then chooses the one with the highest rank to open the file.