ShapeCollection.Item Property

Gets the Shape at the specified indexed location in the collection.

Namespace:  Microsoft.VisualBasic.PowerPacks
Assembly:  Microsoft.VisualBasic.PowerPacks.Vs (in Microsoft.VisualBasic.PowerPacks.Vs.dll)

Syntax

'Declaration
Public Property Item ( _
    index As Integer _
) As Object
'Usage
Dim instance As ShapeCollection 
Dim index As Integer 
Dim value As Object 

value = instance.Item(index)

instance.Item(index) = value

public Object this[
    int index
] { get; set; }

public:
virtual property Object^ Item[int index] {
    Object^ get (int index) sealed;
    void set (int index, Object^ value) sealed;
}

JScript does not support indexed properties.

Parameters

• index
  Type: System.Int32

  The index of the shape to retrieve from the ShapeCollection.

Property Value

Type: System.Object
The Shape located at the specified index location in the ShapeCollection.

Implements

IList.Item[Int32]

Remarks

To retrieve a Shape from the ShapeCollection, reference the collection object by using a specific index value. The index value of the ShapeCollection is a zero-based index.

Examples

The following example uses the Index of a ShapeCollection to set the focus to a shape. This example requires that you have a Button, a LineShape, an OvalShape, and a RectangleShape control on a form.

Private Sub Button1_Click(ByVal sender As System.Object, _
 ByVal e As System.EventArgs) Handles Button1.Click
    ' Set the focus to the first shape (index 0).
    ShapeContainer1.Shapes.Item(0).Focus()
End Sub

private void button1_Click(System.Object sender, System.EventArgs e)
{
    // Set the focus to the first shape (index 0).
    Shape selectedShape = ((Shape) shapeContainer1.Shapes.get_Item(0));
    selectedShape.Focus();
}

.NET Framework Security

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

ShapeCollection Class

ShapeCollection Members

Microsoft.VisualBasic.PowerPacks Namespace

Other Resources

Introduction to the Line and Shape Controls (Visual Studio)

How to: Draw Lines with the LineShape Control (Visual Studio)

How to: Draw Shapes with the OvalShape and RectangleShape Controls (Visual Studio)