Share

LightGroup Class

This class represents a set of lights grouped together for easier management of various lighting scenarios

Inheritance Hierarchy

System.Object
  Autodesk.Revit.DB.Lighting.LightGroup


Namespace: Autodesk.Revit.DB.Lighting
Assembly: RevitAPI (in RevitAPI.dll) Version: 26.1.0.0 (26.1.0.34)

Syntax

C#

public class LightGroup : IDisposable

The LightGroup type exposes the following members.

Properties

 NameDescription
Public propertyId The ElementId of the LightGroup
Public propertyIsValidObject Specifies whether the .NET object represents a valid Revit entity.
Public propertyName The name of the LightGroup

Methods

 NameDescription
Public methodAddLight Add a new light instance to the group
Public methodDisposeReleases all resources used by the LightGroup
Public methodEqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
Public methodGetHashCodeServes as the default hash function.
(Inherited from Object)
Public methodGetLights Get the set of contained light instances The set of light instances
Public methodGetTypeGets the Type of the current instance.
(Inherited from Object)
Public methodRemoveLight Remove the given light instance from the set of light instances in this group
Public methodToStringReturns a string that represents the current object.
(Inherited from Object)

Example

C#

public void AddRemoveLightInGroup(LightGroup groupOne, LightGroup groupTwo, FamilyInstance lightOne, FamilyInstance lightTwo)
{
    // Add two lights into groupOne.
    groupOne.AddLight(lightOne.Id);
    groupOne.AddLight(lightTwo.Id);

    // Move a light from groupOne to groupTwo
    groupTwo.AddLight(lightOne.Id);

    // Retrieve the added lights in the group
    ICollection<ElementId> existingLightIds = groupOne.GetLights();

    // remove the light
    groupOne.RemoveLight(lightTwo.Id);
}

VB

Public Sub AddRemoveLightInGroup(groupOne As LightGroup, groupTwo As LightGroup, lightOne As FamilyInstance, lightTwo As FamilyInstance)
   ' Add two lights into groupOne.
   groupOne.AddLight(lightOne.Id)
   groupOne.AddLight(lightTwo.Id)

   ' Move a light from groupOne to groupTwo
   groupTwo.AddLight(lightOne.Id)

   ' Retrieve the added lights in the group
   Dim existingLightIds As ICollection(Of ElementId) = groupOne.GetLights()

   ' remove the light
   groupOne.RemoveLight(lightTwo.Id)
End Sub

See Also

Reference

Was this information helpful?