Class RadLayeredWindow

Represents a Win2K+ layered window semantic, which allows for semi-transparent windows.

Inheritance
System.Object
RadLayeredWindow
Namespace: Telerik.WinControls
Assembly: Telerik.WinControls.dll

Syntax

public class RadLayeredWindow : Control

Constructors

RadLayeredWindow()

Default constructor.

Declaration
public RadLayeredWindow()

Properties

Alpha

Gets or sets the Alpha (transparency) value - [0, 1] - for the window.

Declaration
public float Alpha { get; set; }
Property Value
System.Single

BackgroundImage

Gets or sets the Image that represents the Layered window.

Declaration
public override Image BackgroundImage { get; set; }
Property Value
System.Drawing.Image

Content

Gets the final Bitmap that represents the content of the Layered Window.

Declaration
protected Bitmap Content { get; }
Property Value
System.Drawing.Bitmap

CreateParams

Declaration
protected override CreateParams CreateParams { get; }
Property Value
System.Windows.Forms.CreateParams

DesiredSize

Gets or sets the size of the window.

Declaration
public Size DesiredSize { get; set; }
Property Value
System.Drawing.Size

DisplaySize

Gets the current size used by the window to visualize itself.

Declaration
public virtual Size DisplaySize { get; }
Property Value
System.Drawing.Size

HitTestable

Determines whether the Control is visible for mouse input.

Declaration
public bool HitTestable { get; set; }
Property Value
System.Boolean

RecreateHandleOnSizeChanged

Determines whether window's handle will be re-created upon a Size change. If the window is large - e.g. 800*600 pixels, applying new size may cause flicker due to the nature of Layered Windows semantic.

Declaration
public bool RecreateHandleOnSizeChanged { get; set; }
Property Value
System.Boolean

TopMost

Determines whether the window is TopMost (above all floating windows).

Declaration
public bool TopMost { get; set; }
Property Value
System.Boolean

Updated

Determines whether the window is updated (used UpdateLayeredWindow API).

Declaration
public bool Updated { get; protected set; }
Property Value
System.Boolean

Methods

BringToFront(Boolean)

Brings the window on top of the z-order.

Declaration
public void BringToFront(bool activate)
Parameters
System.Boolean activate

OnPaint(PaintEventArgs)

Declaration
protected override void OnPaint(PaintEventArgs e)
Parameters
System.Windows.Forms.PaintEventArgs e

OnPaintBackground(PaintEventArgs)

Declaration
protected override void OnPaintBackground(PaintEventArgs pevent)
Parameters
System.Windows.Forms.PaintEventArgs pevent

PaintWindow(Graphics, Bitmap)

Performs painting of the window. Default implementation simply paints the BackgroundImage (if any).

Declaration
protected virtual void PaintWindow(Graphics g, Bitmap graphicsBitmap)
Parameters
System.Drawing.Graphics g

The graphics to use.
System.Drawing.Bitmap graphicsBitmap

The off-screen bitmap instance the graphics is created from.

ResumeUpdates()

Resumes previously suspended updates and forces Layered update.

Declaration
public void ResumeUpdates()

ResumeUpdates(Boolean)

Resumes previously suspended updates. Optionally preforms Layered update.

Declaration
public void ResumeUpdates(bool update)
Parameters
System.Boolean update

SendToBack(Boolean)

Sends the window to back of the z-order.

Declaration
public void SendToBack(bool activate)
Parameters
System.Boolean activate

ShowWindow(Point)

Displays the window to user using the specified location and current size.

Declaration
public virtual void ShowWindow(Point screenLocation)
Parameters
System.Drawing.Point screenLocation

SuspendUpdates()

Suspends any Layered-related updates for the window. Useful for multiple properties set-up without sequential update for each property change.

Declaration
public void SuspendUpdates()

UpdateWindow()

Updates the layered window.

Declaration
protected void UpdateWindow()

WndProc(ref Message)

Provides special handling for the WM_MOUSEACTIVATE, WM_PAINT and WM_NCHITTEST messages.

Declaration
protected override void WndProc(ref Message m)
Parameters
System.Windows.Forms.Message m

Extension Methods