Group Property

C#
Visual Basic
Objective-C
Java
C++

public virtual AnnGroupObject Group {get; set;}

'Declaration
 
Public Overridable Property Group As AnnGroupObject

'Usage
 
Dim instance As AnnObject
Dim value As AnnGroupObject
 
instance.Group = value
 
value = instance.Group

public:
virtual property AnnGroupObject^ Group {
   AnnGroupObject^ get();
   void set (    AnnGroupObject^ value);
}

Property Value

The AnnGroupObject that contains this AnnObject.

An AnnObject can be part of one AnnGroupObject only at any given time.

When adding or removing objects to or from a group, you do not need to manually set this property to the container value: this operation is performed internally by the LEADTOOLS annotation toolkit. However, you can check the value of this property to determine the group (if any) to which a certain object currently belongs.

This example creates a line, adds it to a group then adds the group to a container while checking the Container and Group property of the object.

C#
Visual Basic
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.Annotations
Imports Leadtools.Codecs
Imports Leadtools.WinForms
Imports Leadtools.Drawing

Public Sub AnnObject_Group()
   ' add an object to the first container
   Dim line As AnnLineObject = New AnnLineObject()
   line.Name = "Line1"
   ShowGroupAndContainer(line)

   ' add it to a group
   Dim group As AnnGroupObject = New AnnGroupObject()
   group.Name = "Group1"
   group.Objects.Add(line)

   ShowGroupAndContainer(line)

   ' add the group to a container
   Dim container As AnnContainer = New AnnContainer()
   container.Name = "Container1"
   container.Objects.Add(group)

   ShowGroupAndContainer(line)
End Sub

Private Sub ShowGroupAndContainer(ByVal obj As AnnObject)
   Console.Write("Container: ")
   If Not obj.Container Is Nothing Then
      Console.Write(obj.Container.Name)
   Else
      Console.Write("none")
   End If

   Console.Write(", Group: ")
   If Not obj.Group Is Nothing Then
      Console.Write(obj.Group.Name)
   Else
      Console.Write("none")
   End If

   Console.WriteLine()
End Sub

using Leadtools;
using Leadtools.Annotations;
using Leadtools.Codecs;
using Leadtools.WinForms;
using Leadtools.Drawing;

public void AnnObject_Group()
{
   // add an object to the first container
   AnnLineObject line = new AnnLineObject();
   line.Name = "Line1";
   ShowGroupAndContainer(line);

   // add it to a group
   AnnGroupObject group = new AnnGroupObject();
   group.Name = "Group1";
   group.Objects.Add(line);

   ShowGroupAndContainer(line);

   // add the group to a container
   AnnContainer container = new AnnContainer();
   container.Name = "Container1";
   container.Objects.Add(group);

   ShowGroupAndContainer(line);
}

private void ShowGroupAndContainer(AnnObject obj)
{
   Console.Write("Container: ");
   if(obj.Container != null)
      Console.Write(obj.Container.Name);
   else
      Console.Write("none");

   Console.Write(", Group: ");
   if(obj.Group != null)
      Console.Write(obj.Group.Name);
   else
      Console.Write("none");

   Console.WriteLine();
}

Target Platforms

Reference

AnnObject Class
AnnObject Members