•  

SetColorFillSchemeId Method

Applies color fill scheme to this view.

Namespace: Autodesk.Revit.DB
Assembly: RevitAPI (in RevitAPI.dll) Version: 22.0.0.0 (22.1.0.0)
Since: 2022

Syntax

C# 
public void SetColorFillSchemeId(
	ElementId categoryId,
	ElementId schemeId
)
Visual Basic 
Public Sub SetColorFillSchemeId ( _
	categoryId As ElementId, _
	schemeId As ElementId _
)
Visual C++ 
public:
void SetColorFillSchemeId(
	ElementId^ categoryId, 
	ElementId^ schemeId
)

Parameters

categoryId
Type: Autodesk.Revit.DB ElementId
The id of category to apply a color fill scheme element.
schemeId
Type: Autodesk.Revit.DB ElementId
The id of the color fill scheme element.

Remarks

There could be at most three [!:Autodesk::Revit::DB::ColorFillScheme] applied in a view: one for spatial elements (rooms, zones, spaces and areas), one for pipes and one for ducts.

Notes:

  • There's at most one scheme activated for all spatial categories.
  • For area plan view, the activated spatial scheme category must be OST_Areas and has the same [!:Autodesk::Revit::DB::AreaScheme] with this view if it is not used as a template.
  • To clear one of the above three schemes, use InvalidElementId as the parameter of this function.
  • To get list of element categories supportted to be colored in this view, use SupportedColorFillCategoryIds .
  • To check whether an specified ElementId could be applied to this view, use CanApplyColorFillScheme(ElementId, ElementId) .

Exceptions

Exception Condition
Autodesk.Revit.Exceptions ArgumentException The schemeId can not be applied as the scheme id of categoryId in this view.
Autodesk.Revit.Exceptions ArgumentNullException A non-optional argument was null

See Also