GraphPage::Layers

Layers

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 Header to Include
8 See Also
9 Reference

Description

A Collection of all GraphLayers in a GraphPage.

Get a GraphLayer object by index.

Get a GraphLayer object by name.

Syntax

Collection<GraphLayer> Layers

GraphLayer Layers(int iIndex = -1)

GraphLayer Layers(LPCSTR lpcszName)

Parameters

index: [input]The index (0 offset) of the requested Layer. If iIndex < 0 then the active Layer is returned.

lpcszName: [input]The name of the requested layer

Return

Returns a valid GraphLayer object on successful exit and an invalid GraphLayer object on failure.

Examples

EX1

int GraphPage_Layers_ex1()
{
    GraphPage gp;
    gp.Create("origin");
    if( gp.IsValid() )
    {
        gp.AddLayer("Test");
        gp.AddLayer("Test");
        int iLayers = 0;
        foreach(GraphLayer gl in gp.Layers)
            iLayers++;
        printf("%s has %d layer(s)\n", gp.GetName(), iLayers);
    }
    return 0;
}

EX2

// Get a GraphLayer object by index
// For this example to run, a graph window must exist in the project.
int GraphPage_Layers_ex2()
{
        GraphPage gp = Project.GraphPages(0);
        if( gp.IsValid() )
        {
                GraphLayer gl = gp.Layers(0); // Get active layer
                if( gl.IsValid() )
                        printf("GraphLayer %s is active\n", gl.GetName());
        }
        return 0;
}

EX3

// Get a GraphLayer object by name
int GraphPage_Layers_ex3(string strLayerName = "Test")
{
        GraphPage gp;
        gp.Create("origin");
        if( gp.IsValid() )
        {
                gp.AddLayer("Test");
                gp.AddLayer("Test");
                GraphLayer gl = gp.Layers(strLayerName);
                if( gl.IsValid() )
                        printf("The layer %s exists.\n", strLayerName);
                else
                        printf("The layer %s does not exist.\n", strLayerName);
        }
        return 0;
}