Added a new example project: ComponentTutorialExample, which includes a PDF tutorial describing the basics of what a Component is.

examples/ComponentTutorialExample/Source/ToggleLightGridComponent.h

@@ -0,0 +1,67 @@
+/*
+  ==============================================================================
+
+    ToggleLightGridComponent.h
+    Created: 11 Feb 2015 9:57:34am
+    Author:  Felix Faire
+
+  ==============================================================================
+*/
+
+#ifndef TOGGLELIGHTGRIDCOMPONENT_H_INCLUDED
+#define TOGGLELIGHTGRIDCOMPONENT_H_INCLUDED
+
+#include "ToggleLightComponent.h"
+
+/**
+    This is the parent class that holds multiple ToggleLightComponents in a grid.
+*/
+class ToggleLightGridComponent  : public Component
+{
+public:
+    ToggleLightGridComponent (String name = "grid")
+        : Component (name)
+    {
+        // Adds the child light components and makes them visible
+        // within this component.
+        // (they currently rely on having a default constructor
+        // so they dont have to be individually initialised)
+        for (int i = 0; i < numX * numY; ++i)
+            addAndMakeVisible (toggleLights[i]);
+    }
+
+    void resized() override
+    {
+        // This creates a grid of rectangles to use as the bounds
+        // for all of our lights. The grid is defined with the
+        // width and height of this component.
+
+        int stepX = getWidth()  / numX;
+        int stepY = getHeight() / numY;
+
+        for (int x = 0; x < numX; ++x)
+        {
+            for (int y = 0; y < numY; ++y)
+            {
+                // creates the rectangle     (x,         y,         width, height)
+                Rectangle<int> elementBounds (x * stepX, y * stepY, stepX, stepY);
+
+                // set the size and position of the Toggle light to this rectangle.
+                toggleLights[x + numX * y].setBounds (elementBounds);
+            }
+        }
+    }
+
+private:
+    // member variables for the Component
+    static const int numX = 20;
+    static const int numY = 20;
+
+    ToggleLightComponent toggleLights [numX * numY];
+
+    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (ToggleLightGridComponent)
+};
+
+
+
+#endif  // TOGGLELIGHTGRIDCOMPONENT_H_INCLUDED