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

ArchiLabs Desktop

Put AI to work inside Revit.

Give Desktop your instructions and project files to build Revit families, update model elements, and create views and schedules. Works directly in Revit and AutoCAD.

Explore Desktop →