New to Telerik UI for WinFormsStart a free 30-day trial

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

Definition

Namespace:Telerik.WinControls

Assembly:Telerik.WinControls.dll

Syntax:

C#
public class RadLayeredWindow : Control, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

Inheritance: objectMarshalByRefObjectComponentControlRadLayeredWindow

Implements: IBindableComponentIComponentIDisposableIDropTargetISynchronizeInvokeIWin32Window...

Constructors

Default constructor.

C#
public RadLayeredWindow()

Properties

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

C#
public float Alpha { get; set; }

Gets or sets the Image that represents the Layered window.

C#
public override Image BackgroundImage { get; set; }

Overrides: Control.BackgroundImage

Gets or sets the RadSvgImage that represents the Layered window.

C#
public RadSvgImage BackgroundSvgImage { get; set; }

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

C#
protected Bitmap Content { get; }
C#
protected override CreateParams CreateParams { get; }

Overrides: Control.CreateParams

Gets or sets the size of the window.

C#
public Size DesiredSize { get; set; }

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

C#
public virtual Size DisplaySize { get; }

Determines whether the Control is visible for mouse input.

C#
public bool HitTestable { get; set; }

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.

C#
public bool RecreateHandleOnSizeChanged { get; set; }

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

C#
public bool TopMost { get; set; }

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

C#
public bool Updated { get; protected set; }

Methods

Brings the window on top of the z-order.

C#
public void BringToFront(bool activate)
Parameters:activatebool
C#
protected override void OnPaint(PaintEventArgs e)
Parameters:ePaintEventArgs

Overrides: Control.OnPaint(PaintEventArgs)

C#
protected override void OnPaintBackground(PaintEventArgs pevent)
Parameters:peventPaintEventArgs

Overrides: Control.OnPaintBackground(PaintEventArgs)

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

C#
protected virtual void PaintWindow(Graphics g, Bitmap graphicsBitmap)
Parameters:gGraphics

The graphics to use.

graphicsBitmapBitmap

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

Resumes previously suspended updates and forces Layered update.

C#
public void ResumeUpdates()

Resumes previously suspended updates. Optionally preforms Layered update.

C#
public void ResumeUpdates(bool update)
Parameters:updatebool

Sends the window to back of the z-order.

C#
public void SendToBack(bool activate)
Parameters:activatebool

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

C#
public virtual void ShowWindow(Point screenLocation)
Parameters:screenLocationPoint

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

C#
public void SuspendUpdates()

Updates the layered window.

C#
protected void UpdateWindow()

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

C#
protected override void WndProc(ref Message m)
Parameters:mMessage

Overrides: Control.WndProc(ref Message)