WebPartZoneBase.DragHighlightColor Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the color around the border of a WebPartZoneBase zone and its drop-cue regions when a user is dragging a control.

Namespace:   System.Web.UI.WebControls.WebParts
Assembly:  System.Web (in System.Web.dll)

[TypeConverterAttribute(typeof(WebColorConverter))]
public virtual Color DragHighlightColor { get; set; }

Property Value

Type: System.Drawing.Color

A Color that contains the highlight color. The default color is Blue.

When a dragged control is held over a zone where it can be dropped, drop-cue regions appear, showing the area in which the control can be dropped, and it is for these regions, as well as the zone itself, that the DragHighlightColor property affects the border color.

The DragHighlightColor property enables you to set the color that appears to a user when they drag a control in the zone. The DragHighlightColor property takes effect only when a Web page is in a display mode that enables the layout of a zone to be changed, such as DesignDisplayMode.

The following code example demonstrates the declarative use of the DragHighlightColor property on a WebPartZone control. For the full code example, including the code-behind source file and the .aspx page that contains the zone in this code, see the WebPartZoneBase class overview.

Notice that the DragHighlightColor property value is set to a specific color. After you load the page into a browser and switch the page into design display mode, you can see the effect of the property when you select and drag the control within its zone, or drag another control into the zone.

<asp:WebPartZone 
  ID="WebPartZone2"
  Runat="server" 
  DragHighlightColor="#00ff00"
  AllowLayoutChange="true"
  EmptyZoneText="Add WebParts to this empty Zone."
  BorderWidth="2"
  BorderColor="DarkBlue"
  BorderStyle="Dashed" 
  MenuLabelText="Verbs Menu" 
  MenuPopupImageUrl="label.gif" >
  <VerbStyle Font-Italic="true" />
  <MenuLabelStyle BackColor="Lime" BorderWidth="1"  />
  <MenuLabelHoverStyle Font-Bold="true" />
  <MenuVerbHoverStyle BackColor="LightGrey" />
  <MenuVerbStyle Font-Italic="true" /> 
  <ZoneTemplate>
    <asp:Label ID="Label1" Runat="server" Title="Date" />
  </ZoneTemplate>
</asp:WebPartZone>

.NET Framework
Available since 2.0
Return to top
Show: