Common Custom renderers

Purpose

This sample demonstrates how to create custom Web Application Developer Framework (ADF) renderers for use with Web ADF graphics layers. A single base class provides the minimum required implementation for an ADF renderer. A set of custom renderer classes illustrate how to build on this basic implementation to support rendering features in the Map and Toc controls. Custom renderer examples include simple image markers, custom line styles and polygon fills, label points, graduated colors, and 3D display. These renderers are used on the pages included with this sample as follows:

GraduatedColorRenderer.aspx—Uses a GraduatedColorRenderer that determines each feature's color by mapping a field value to a gradient
LabelPointRenderer.aspx—Uses a LabelPointRenderer that creates labels at feature points with text specified by a field value
LineColorRenderer.aspx—Uses a LineColorRenderer that determines each feature's color and line width through feature attributes
SimplePointRenderer.aspx—Uses a SimplePointRenderer that renders points with an image specified in a feature attribute
SimpleRenderer3D.aspx—Uses a SimpleRenderer3D that extrudes lines and polygons to render them in 2 1/2D

How to use

If the sample has associated data, you will find that the sample's zip file includes a "data" folder alongside the language folders. However, you will need to update the sample to point to the location of the data once you have extracted all the files.

At design time

Verify that the Web ADF for the .NET Framework is installed and functioning properly. For information on installing and configuring the Web ADF, consult the installation guide.
In Windows Explorer, navigate to <ArcGIS install location>\DeveloperKit10.0\Samples\ServerNET. This folder contains the Common_CustomRenderers CSharp and VBNet folders.
Open the folder of the language you are going to use (that is, CSharp or VBNet) and copy the Common_CustomRenderers_<language> folder to c:\inetpub\wwwroot. The <language> variable can be CSharp or VBNet.
Open the IIS Manager from Control Panel, Administrative Tools, Internet Information Services (IIS) Manager, or Internet Information Services.
In the console tree view on the left, navigate to Local Computer, Web Sites, Default Web Site. Expand Default Web Site. Right-click the Common_CustomRenderers_<language> folder, and click Properties. The Properties dialog box appears.
Click the Directory tab, click the Create button in the Application Settings section, then click OK to close the Properties dialog box.
Start Visual Studio 2010 and open the solution Common_CustomRenderers_CSharp2008.sln located in the c:\inetpub\wwwroot\Common_CustomRenderers_CSharp folder.
In the Solution Explorer, right-click the page you want to view and select Set As Start Page.
Click the Debug drop-down menu and click Start Debugging.

At run time

Browse to the application uniform resource locator (URL), for example, http://localhost/Common_CustomRenderers_CSharp, or start the application from Visual Studio.
On the Default.aspx page, click the link to the sample page you want to view.
On the GraduatedColorRenderer.aspx and SimplePointRenderer.aspx pages, observe the graphic features drawn by the custom renderer.
Refresh the page to see a new set of features.
Expand the GraphicsDataSource node of the table of contents (TOC) and any child nodes. Swatches have been created by the custom renderer.
On the LabelPointRender.aspx, LineColorRenderer.aspx, and SimpleRenderer3D.aspx pages, observe the graphic features drawn by the custom renderer.
Refresh the page to see a new set of features.

C#VB.NET

Common_CustomRenderers_CSharp\Default.aspx	Contains links to the other sample pages.
Common_CustomRenderers_CSharp\Default.aspx.cs (view code)	Code behind the .aspx page.
Common_CustomRenderers_CSharp\GraduatedColorRenderer.aspx	Illustrates use of the GraduatedColorRenderer.
Common_CustomRenderers_CSharp\GraduatedColorRenderer.aspx.cs (view code)	Code behind the .aspx page.
Common_CustomRenderers_CSharp\LabelPointRenderer.aspx	Illustrates use of the LabelPointRenderer.
Common_CustomRenderers_CSharp\LabelPointRenderer.aspx.cs (view code)	Code behind the .aspx page.
Common_CustomRenderers_CSharp\LineColorRenderer.aspx	Illustrates use of the LineColorRenderer.
Common_CustomRenderers_CSharp\SimplePointRenderer.aspx.cs (view code)	Code behind the .aspx page.
Common_CustomRenderers_CSharp\SimpleRenderer3D.aspx	Illustrates use of the SimpleRenderer3D.
Common_CustomRenderers_CSharp\SimpleRenderer3D.aspx.cs (view code)	Code behind the .aspx page.
Common_CustomRenderers_CSharp\App_Code\GenerateGraphicsHelper.cs (view code)	Contains utility methods for generating graphic features.
Common_CustomRenderers_CSharp\App_Code\GraduatedColorRenderer.cs (view code)	GraduatedColorRenderer implementation.
Common_CustomRenderers_CSharp\App_Code\LabelPointRenderer.cs (view code)	LabelPointRenderer implementation.
Common_CustomRenderers_CSharp\App_Code\LineColorRenderer.cs (view code)	LineColorRenderer implementation.
Common_CustomRenderers_CSharp\App_Code\RendererBase.cs (view code)	Inheritable base class to simplify implementation of IRenderer.
Common_CustomRenderers_CSharp\App_Code\SimplePointRenderer.cs (view code)	SimplePointRenderer implementation.
Common_CustomRenderers_CSharp\App_Code\SimpleRenderer3D.cs (view code)	SimpleRenderer3D implementation.
Common_CustomRenderers_CSharp\App_Code\Utility.cs (view code)	Contains utility methods for rendering features.

Download the C# files

Common_CustomRenderers_VBNet\Default.aspx	Contains links to the other sample pages.
Common_CustomRenderers_VBNet\Default.aspx.vb (view code)	Code behind the .aspx page.
Common_CustomRenderers_VBNet\GraduatedColorRenderer.aspx	Illustrates use of the GraduatedColorRenderer.
Common_CustomRenderers_VBNet\GraduatedColorRenderer.aspx.vb (view code)	Code behind the .aspx page.
Common_CustomRenderers_VBNet\LabelPointRenderer.aspx	Illustrates use of the LabelPointRenderer.
Common_CustomRenderers_VBNet\LabelPointRenderer.aspx.vb (view code)	Code behind the .aspx page.
Common_CustomRenderers_VBNet\LineColorRenderer.aspx	Illustrates use of the LineColorRenderer.
Common_CustomRenderers_VBNet\SimplePointRenderer.aspx.vb (view code)	Code behind the .aspx page.
Common_CustomRenderers_VBNet\SimpleRenderer3D.aspx	Illustrates use of the SimpleRenderer3D.
Common_CustomRenderers_VBNet\SimpleRenderer3D.aspx.vb (view code)	Code behind the .aspx page.
Common_CustomRenderers_VBNet\App_Code\GenerateGraphicsHelper.vb (view code)	Contains utility methods for generating graphic features.
Common_CustomRenderers_VBNet\App_Code\GraduatedColorRenderer.vb (view code)	GraduatedColorRenderer implementation.
Common_CustomRenderers_VBNet\App_Code\LabelPointRenderer.vb (view code)	LabelPointRenderer implementation.
Common_CustomRenderers_VBNet\App_Code\LineColorRenderer.vb (view code)	LineColorRenderer implementation.
Common_CustomRenderers_VBNet\App_Code\RendererBase.vb (view code)	Inheritable base class to simplify implementation of IRenderer.
Common_CustomRenderers_VBNet\App_Code\SimplePointRenderer.vb (view code)	SimplePointRenderer implementation.
Common_CustomRenderers_VBNet\App_Code\SimpleRenderer3D.vb (view code)	SimpleRenderer3D implementation.
Common_CustomRenderers_VBNet\App_Code\Utility.vb (view code)	Contains utility methods for rendering features.

Download the VB.NET files

Download the files for all languages