2010年8月05日_周四_DockExtender control
/***********************************************************/
//
//Directions
//createing arcGIS Server solution
//developint application
//develpoing web appliation using the web adf
// web controls
//DockExtent control
/**********************************************************/
The DockExtender control is designed to dock controls to a specific position on top of a Map control. It builds on the ExtenderControlBase class included with the ASP.NET AJAX Control Toolkit . Frequently OverviewMap, Navigation, ZoomLevel, and ScaleBar controls are placed on top of a Map to enhance the look and feel of an application. Use the DockExtender to define the position of a control relative to the Map instead of manually（手动的） positioning the control over the Map.
DockExtender 控件被设计为将控件停靠在地图控件上方某一个指定的位置。她继承于ExtenderControlBase 类以及 ASP.NET JAJAX 控件开发包。 通常是：鹰眼图，导航条，缩放控件，以及比例尺等放置在地图控件的上方，增强应用程序的美观性以及感性。 使用DockExtender 控件来定义一个控件相对地图控件的位置，而不是手动的调整地图上面控件的停放位置。
Assembly(集合): ESRI.ArcGIS.ADF.UI.WebControls.dll
Class: ESRI.ArcGIS.ADF.UI.WebControls.DockExtender
Using the DockExtender control
Add the controls to the page
The DockExtender control requires a ScriptManager in the page to function. Add a ScriptManager as the first control in the page.
DockExtender 控件需要一个ScriptManager控件在页面中来使自己运行。 见ScriptManager控件作为第一个控件添加到页面中。
Add a DockExtender, MapResourceManager, and a Map control to the page. Add a valid map resource item to the MapResourceManager and buddy it with the Map.
为页面添加一个DockExtender，一个MapResourceManager和一个Map控件。 添加一个可以获取的资源项到MapResourceManager控件里面并将它和Map控件想绑定。
Add a control to dock within the Map. In this example, and OverviewMap control will be used. Add an OverviewMap control to the page and set the Map and map resource item it will display.
添加一个控件和map控件一起停靠，在这个例子中，一个鹰眼图将会被利用。 添加一个鹰眼图控件到页面并设置她将显示的地图以及地图资源项。
Set the DockExtender control properties
设置DockExtender 控件的属性
Select the DockExtender control. In the Properties page:
Set the DockControlId property to the id of the Map control added earlier. This property defines the control in which you want to dock another control and can only be associated with a Web ADF Map control.
Set the TargetContrlId property to the control you want to dock in the Map. Use the id of the OverviewMap control added earlier.
Set the Alignment property to position the target control (OverviewMap) within the dock control (Map). Nine options are available describing the corners, sides and center of the dock control.
Optional（可以任选的）: set the OverviewMap's BorderColor property to Black and BorderStyle property to Solid. This will enable you to discern（看出、识别、认出） between the Map and docked OverviewMap control.
Runtime use
选择DockExtender控件，打开属性页面：
设置DockControlId 属性为在前面的添加的地图控件的ID，这个属性定义了你想在那个控件上面放置其他的控件并且仅仅能关联一个web ADF地图控件。
设置TargetContrlId 属性为你想要在map控件上面停靠的控件的ID。 这里设置为你在前面添加的鹰眼图控件的ID值。
设置Alignment 属性为目标控件在停靠控件上面的位置。 有9个描述停靠控件的角落、边缘以及中位置的变量可以获取。
任选项：设置鹰眼图控件的边框颜色为黑丝，边框属性为Solid。这个能够使你识别地图控件和鹰眼图控件。
At runtime, the target control (OverviewMap) is positioned and displayed on top of the Map control. Note, the position of the target control at design-time is not important since the DockExtender control determines its location at runtime. In this example, the Alignment property of the DockExtender control is set to "TopRight".
在运行状态下，目标控件（鹰眼控件）定位和显示在地图控件的上方。 注意：目标控件在设计时候的位置不是很重要，因为DockExtender控件决定着在目标控件在运行时刻的位置。 在这例子中，DockExtender控件的Alignment属性被设置为“ToRight”.
Members
Properties
The following table provides a list of properties of interest. For complete reference information, see the DockExtender control in the library reference section.
| Property Name |
Type |
Description |
| Alignment |
ContentAlignment |
The position of the docked control within the Map. |
| DockControlId |
string |
The id of a Map control in which another control will be docked. |
| TargetControlId |
string |
The id of the control to dock within a Map control. |