ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH WINDOWS CONTROLS
2. Create a new function called CreateOverviewSymbol. This is where you will
create the symbol used in the MapControl to represent the extent of the data
in the focus map of the PageLayoutControl. Add the following code to the
function.
private void CreateOverviewSymbol()
{
// Get the IRgbColor interface.
IRgbColor color = new RgbColor();
// Set the color properties.
color.RGB = 255;
// Get the ILine symbol interface.
ILineSymbol outline = new SimpleLineSymbol();
// Set the line symbol properties.
outline.Width = 1.5;
outline.Color = color;
// Get the IFillSymbol interface.
ISimpleFillSymbol simpleFillSymbol = new SimpleFillSymbolClass();
// Set the fill symbol properties.
simpleFillSymbol.Outline = outline;
simpleFillSymbol.Style = esriSimpleFillStyle.esriSFSHollow;
m_FillSymbol = simpleFillSymbol;
}
3. Call the CreateOverviewSymbol function from the Form_Load event before
the TOCControl label editing code.
private void Form1_Load(object sender, System.EventArgs e)
{
// Create symbol used on the MapControl.
CreateOverviewSymbol();
}
// Set label editing to manual…
4. Add the following OnVisibleBoundsUpdated function. This function will be
linked to an event raised whenever the extent of the map is changed and is
used to set the envelope to the new visible bounds of the map. By refreshing
the MapControl you force it to redraw the shape on its display.
private void OnVisibleBoundsUpdated(IDisplayTransformation sender, bool
sizeChanged)
{
// Set the extent to the new visible extent.
m_Envelope = sender.VisibleBounds;
// Refresh the MapControl's foreground phase.
axMapControl1.ActiveView.PartialRefresh(esriViewDrawPhase.
esriViewForeground, null, null);
}
5. The default event interface of the PageLayoutControl is the
IPageLayoutControlEvents. These events do not tell you when the extent of
the map within the data frame changes. To enable this functionality you will
Chapter 6 • Developer scenarios • 345