ArcGIS Engine Developer Guide

BUILDING APPLICATIONS WITH WINDOWS CONTROLS
5. Build and run the application. Right-click the PageLayoutControl’s display
area to display the popup menu, and navigate around the page layout.
Controlling label editing in the TOCControl
By default, the TOCControl allows users to automatically toggle the visibility of
layers and to change map and layer names as they appear in the table of contents.
You will add code to prevent users from editing a name and replacing it with an
empty string.
1. Add the following code to the beginning of the Form_Load event.
private void Form1_Load(object sender, System.EventArgs e)
{
// Set label editing to manual.
axTOCControl1.LabelEdit = esriTOCControlEdit.esriTOCControlManual;
}
// Add generic commands.
2. Display the form in design mode, select AxTOCControl1 from the Properties
window, and display the AxTOCControl events. Double-click
OnEndLabelEdit to add an event handler to the code window.
3. Add the following code to the axTOCControl_OnEndLabelEdit event:
private void axTOCControl1_OnEndLabelEdit(object sender,
ESRI.ArcGIS.TOCControl.ITOCControlEvents_OnEndLabelEditEvent e)
{
// If the new label is an empty string, then prevent the edit.
string newLabel = e.newLabel;
if (newLabel.Trim() == "")
{
e.canEdit = false;
}
}
Chapter 6 • Developer scenarios • 343