DocumentPreviewSettings Class

Inheritance Hierarchy

Syntax

C#

public class DocumentPreviewSettings : IDisposable

The DocumentPreviewSettings type exposes the following members.

Properties

	Name	Description
	IsValidObject	Specifies whether the .NET object represents a valid Revit entity.
	IsViewUpdateForced	Identifies if Revit will update the preview view if necessary.
	PreviewViewId	The view id that will be used to generate the preview.

Methods

	Name	Description
	Dispose	Releases all resources used by the DocumentPreviewSettings
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object)
	ForceViewUpdate	Sets Revit to update the preview view if necessary.
	GetHashCode	Serves as the default hash function. (Inherited from Object)
	GetType	Gets the Type of the current instance. (Inherited from Object)
	IsViewIdValidForPreview	Identifies if the view id is valid as a preview view id.
	ToString	Returns a string that represents the current object. (Inherited from Object)

Example

C#

// Get the document's preview settings
DocumentPreviewSettings settings = document.GetDocumentPreviewSettings();

// Find a candidate 3D view
FilteredElementCollector collector = new FilteredElementCollector(document);
collector.OfClass(typeof(View3D));

Func<View3D, bool> isValidForPreview = v => settings.IsViewIdValidForPreview(v.Id);

View3D viewForPreview = collector.OfType<View3D>().First<View3D>(isValidForPreview);

// Set the preview settings
using (Transaction setTransaction = new Transaction(document, "Set preview view id"))
{
   setTransaction.Start();
   settings.PreviewViewId = viewForPreview.Id;
   setTransaction.Commit();
}

// Save the document
document.Save();

VB

' Get the document's preview settings
Dim settings As DocumentPreviewSettings = document.GetDocumentPreviewSettings()

' Find a candidate 3D view
Dim collector As New FilteredElementCollector(document)
collector.OfClass(GetType(View3D))

Dim isValidForPreview As Func(Of View3D, Boolean) = Function(v) settings.IsViewIdValidForPreview(v.Id)

Dim viewForPreview As View3D = collector.OfType(Of View3D)().First(isValidForPreview)

' Set the preview settings
Using setTransaction As New Transaction(document, "Set preview view id")
    setTransaction.Start()
    settings.PreviewViewId = viewForPreview.Id
    setTransaction.Commit()
End Using

' Save the document
document.Save()

See Also

Reference