Class
RadLayeredWindow

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

Definition

Namespace:Telerik.WinControls

Assembly:Telerik.WinControls.dll

Syntax:

cs-api-definition
public class RadLayeredWindow : Control, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable

Inheritance: objectMarshalByRefObjectComponentControlRadLayeredWindow

Implements: IBindableComponentIComponentIDisposableIDropTargetISynchronizeInvokeIWin32Window

Inherited Members Control.GetAccessibilityObjectById(int)Control.SetAutoSizeMode(AutoSizeMode)Control.GetAutoSizeMode()Control.GetPreferredSize(Size)Control.AccessibilityNotifyClients(AccessibleEvents, int)Control.AccessibilityNotifyClients(AccessibleEvents, int, int)Control.BeginInvoke(Delegate)Control.BeginInvoke(Delegate, params object[])Control.BringToFront()Control.Contains(Control)Control.CreateAccessibilityInstance()Control.CreateControlsInstance()Control.CreateGraphics()Control.CreateHandle()Control.CreateControl()Control.DefWndProc(ref Message)Control.DestroyHandle()Control.Dispose(bool)Control.DoDragDrop(object, DragDropEffects)Control.DrawToBitmap(Bitmap, Rectangle)Control.EndInvoke(IAsyncResult)Control.FindForm()Control.GetTopLevel()Control.RaiseKeyEvent(object, KeyEventArgs)Control.RaiseMouseEvent(object, MouseEventArgs)Control.Focus()Control.FromChildHandle(IntPtr)Control.FromHandle(IntPtr)Control.GetChildAtPoint(Point, GetChildAtPointSkip)Control.GetChildAtPoint(Point)Control.GetContainerControl()Control.GetScaledBounds(Rectangle, SizeF, BoundsSpecified)Control.GetNextControl(Control, bool)Control.GetStyle(ControlStyles)Control.Hide()Control.InitLayout()Control.Invalidate(Region)Control.Invalidate(Region, bool)Control.Invalidate()Control.Invalidate(bool)Control.Invalidate(Rectangle)Control.Invalidate(Rectangle, bool)Control.Invoke(Delegate)Control.Invoke(Delegate, params object[])Control.InvokePaint(Control, PaintEventArgs)Control.InvokePaintBackground(Control, PaintEventArgs)Control.IsKeyLocked(Keys)Control.IsInputChar(char)Control.IsInputKey(Keys)Control.IsMnemonic(char, string)Control.LogicalToDeviceUnits(int)Control.LogicalToDeviceUnits(Size)Control.ScaleBitmapLogicalToDevice(ref Bitmap)Control.NotifyInvalidate(Rectangle)Control.InvokeOnClick(Control, EventArgs)Control.OnAutoSizeChanged(EventArgs)Control.OnBackColorChanged(EventArgs)Control.OnBackgroundImageChanged(EventArgs)Control.OnBackgroundImageLayoutChanged(EventArgs)Control.OnBindingContextChanged(EventArgs)Control.OnCausesValidationChanged(EventArgs)Control.OnContextMenuChanged(EventArgs)Control.OnContextMenuStripChanged(EventArgs)Control.OnCursorChanged(EventArgs)Control.OnDockChanged(EventArgs)Control.OnEnabledChanged(EventArgs)Control.OnFontChanged(EventArgs)Control.OnForeColorChanged(EventArgs)Control.OnRightToLeftChanged(EventArgs)Control.OnNotifyMessage(Message)Control.OnParentBackColorChanged(EventArgs)Control.OnParentBackgroundImageChanged(EventArgs)Control.OnParentBindingContextChanged(EventArgs)Control.OnParentCursorChanged(EventArgs)Control.OnParentEnabledChanged(EventArgs)Control.OnParentFontChanged(EventArgs)Control.OnParentForeColorChanged(EventArgs)Control.OnParentRightToLeftChanged(EventArgs)Control.OnParentVisibleChanged(EventArgs)Control.OnPrint(PaintEventArgs)Control.OnTabIndexChanged(EventArgs)Control.OnTabStopChanged(EventArgs)Control.OnTextChanged(EventArgs)Control.OnVisibleChanged(EventArgs)Control.OnParentChanged(EventArgs)Control.OnClick(EventArgs)Control.OnClientSizeChanged(EventArgs)Control.OnControlAdded(ControlEventArgs)Control.OnControlRemoved(ControlEventArgs)Control.OnCreateControl()Control.OnHandleCreated(EventArgs)Control.OnLocationChanged(EventArgs)Control.OnHandleDestroyed(EventArgs)Control.OnDoubleClick(EventArgs)Control.OnDragEnter(DragEventArgs)Control.OnDragOver(DragEventArgs)Control.OnDragLeave(EventArgs)Control.OnDragDrop(DragEventArgs)Control.OnGiveFeedback(GiveFeedbackEventArgs)Control.OnEnter(EventArgs)Control.InvokeGotFocus(Control, EventArgs)Control.OnGotFocus(EventArgs)Control.OnHelpRequested(HelpEventArgs)Control.OnInvalidated(InvalidateEventArgs)Control.OnKeyDown(KeyEventArgs)Control.OnKeyPress(KeyPressEventArgs)Control.OnKeyUp(KeyEventArgs)Control.OnLayout(LayoutEventArgs)Control.OnLeave(EventArgs)Control.InvokeLostFocus(Control, EventArgs)Control.OnLostFocus(EventArgs)Control.OnMarginChanged(EventArgs)Control.OnMouseDoubleClick(MouseEventArgs)Control.OnMouseClick(MouseEventArgs)Control.OnMouseCaptureChanged(EventArgs)Control.OnMouseDown(MouseEventArgs)Control.OnMouseEnter(EventArgs)Control.OnMouseLeave(EventArgs)Control.OnDpiChangedBeforeParent(EventArgs)Control.OnDpiChangedAfterParent(EventArgs)Control.OnMouseHover(EventArgs)Control.OnMouseMove(MouseEventArgs)Control.OnMouseUp(MouseEventArgs)Control.OnMouseWheel(MouseEventArgs)Control.OnMove(EventArgs)Control.OnPaddingChanged(EventArgs)Control.OnQueryContinueDrag(QueryContinueDragEventArgs)Control.OnRegionChanged(EventArgs)Control.OnResize(EventArgs)Control.OnPreviewKeyDown(PreviewKeyDownEventArgs)Control.OnSizeChanged(EventArgs)Control.OnChangeUICues(UICuesEventArgs)Control.OnStyleChanged(EventArgs)Control.OnSystemColorsChanged(EventArgs)Control.OnValidating(CancelEventArgs)Control.OnValidated(EventArgs)Control.RescaleConstantsForDpi(int, int)Control.PerformLayout()Control.PerformLayout(Control, string)Control.PointToClient(Point)Control.PointToScreen(Point)Control.PreProcessMessage(ref Message)Control.PreProcessControlMessage(ref Message)Control.ProcessCmdKey(ref Message, Keys)Control.ProcessDialogChar(char)Control.ProcessDialogKey(Keys)Control.ProcessKeyEventArgs(ref Message)Control.ProcessKeyMessage(ref Message)Control.ProcessKeyPreview(ref Message)Control.ProcessMnemonic(char)Control.RaiseDragEvent(object, DragEventArgs)Control.RaisePaintEvent(object, PaintEventArgs)Control.RecreateHandle()Control.RectangleToClient(Rectangle)Control.RectangleToScreen(Rectangle)Control.ReflectMessage(IntPtr, ref Message)Control.Refresh()Control.ResetMouseEventArgs()Control.ResetText()Control.ResumeLayout()Control.ResumeLayout(bool)Control.Scale(SizeF)Control.ScaleControl(SizeF, BoundsSpecified)Control.Select()Control.Select(bool, bool)Control.SelectNextControl(Control, bool, bool, bool, bool)Control.SendToBack()Control.SetBounds(int, int, int, int)Control.SetBounds(int, int, int, int, BoundsSpecified)Control.SetBoundsCore(int, int, int, int, BoundsSpecified)Control.SetClientSizeCore(int, int)Control.SizeFromClientSize(Size)Control.SetStyle(ControlStyles, bool)Control.SetTopLevel(bool)Control.SetVisibleCore(bool)Control.RtlTranslateAlignment(HorizontalAlignment)Control.RtlTranslateAlignment(LeftRightAlignment)Control.RtlTranslateAlignment(ContentAlignment)Control.RtlTranslateHorizontal(HorizontalAlignment)Control.RtlTranslateLeftRight(LeftRightAlignment)Control.RtlTranslateContent(ContentAlignment)Control.Show()Control.SuspendLayout()Control.Update()Control.UpdateBounds()Control.UpdateBounds(int, int, int, int)Control.UpdateBounds(int, int, int, int, int, int)Control.UpdateZOrder()Control.UpdateStyles()Control.OnImeModeChanged(EventArgs)Control.AccessibilityObjectControl.AccessibleDefaultActionDescriptionControl.AccessibleDescriptionControl.AccessibleNameControl.AccessibleRoleControl.AllowDropControl.AnchorControl.AutoScrollOffsetControl.LayoutEngineControl.BackColorControl.BackgroundImageLayoutControl.BindingContextControl.BottomControl.BoundsControl.CanFocusControl.CanRaiseEventsControl.CanSelectControl.CaptureControl.CausesValidationControl.CheckForIllegalCrossThreadCallsControl.ClientRectangleControl.ClientSizeControl.CompanyNameControl.ContainsFocusControl.ContextMenuControl.ContextMenuStripControl.ControlsControl.CreatedControl.CursorControl.DataBindingsControl.DefaultBackColorControl.DefaultCursorControl.DefaultFontControl.DefaultForeColorControl.DefaultMarginControl.DefaultMaximumSizeControl.DefaultMinimumSizeControl.DefaultPaddingControl.DefaultSizeControl.DeviceDpiControl.DisplayRectangleControl.IsDisposedControl.DisposingControl.DockControl.DoubleBufferedControl.EnabledControl.FocusedControl.FontControl.FontHeightControl.ForeColorControl.HandleControl.HasChildrenControl.HeightControl.IsHandleCreatedControl.InvokeRequiredControl.IsAccessibleControl.IsMirroredControl.LeftControl.LocationControl.MarginControl.MaximumSizeControl.MinimumSizeControl.ModifierKeysControl.MouseButtonsControl.MousePositionControl.NameControl.ParentControl.ProductNameControl.ProductVersionControl.RecreatingHandleControl.RegionControl.RenderRightToLeftControl.ResizeRedrawControl.RightControl.RightToLeftControl.ScaleChildrenControl.SiteControl.SizeControl.TabIndexControl.TabStopControl.TagControl.TextControl.TopControl.TopLevelControlControl.ShowKeyboardCuesControl.ShowFocusCuesControl.UseWaitCursorControl.VisibleControl.WidthControl.PreferredSizeControl.PaddingControl.CanEnableImeControl.DefaultImeModeControl.ImeModeControl.ImeModeBaseControl.PropagatingImeModeControl.BackColorChangedControl.BackgroundImageChangedControl.BackgroundImageLayoutChangedControl.BindingContextChangedControl.CausesValidationChangedControl.ClientSizeChangedControl.ContextMenuChangedControl.ContextMenuStripChangedControl.CursorChangedControl.DockChangedControl.EnabledChangedControl.FontChangedControl.ForeColorChangedControl.LocationChangedControl.MarginChangedControl.RegionChangedControl.RightToLeftChangedControl.SizeChangedControl.TabIndexChangedControl.TabStopChangedControl.TextChangedControl.VisibleChangedControl.ClickControl.ControlAddedControl.ControlRemovedControl.DragDropControl.DragEnterControl.DragOverControl.DragLeaveControl.GiveFeedbackControl.HandleCreatedControl.HandleDestroyedControl.HelpRequestedControl.InvalidatedControl.PaddingChangedControl.PaintControl.QueryContinueDragControl.QueryAccessibilityHelpControl.DoubleClickControl.EnterControl.GotFocusControl.KeyDownControl.KeyPressControl.KeyUpControl.LayoutControl.LeaveControl.LostFocusControl.MouseClickControl.MouseDoubleClickControl.MouseCaptureChangedControl.MouseDownControl.MouseEnterControl.MouseLeaveControl.DpiChangedBeforeParentControl.DpiChangedAfterParentControl.MouseHoverControl.MouseMoveControl.MouseUpControl.MouseWheelControl.MoveControl.PreviewKeyDownControl.ResizeControl.ChangeUICuesControl.StyleChangedControl.SystemColorsChangedControl.ValidatingControl.ValidatedControl.ParentChangedControl.ImeModeChangedComponent.Dispose()Component.GetService(Type)Component.ToString()Component.EventsComponent.ContainerComponent.DesignModeComponent.DisposedMarshalByRefObject.MemberwiseClone(bool)MarshalByRefObject.GetLifetimeService()MarshalByRefObject.InitializeLifetimeService()MarshalByRefObject.CreateObjRef(Type)

Constructors

RadLayeredWindow()

Default constructor.

Declaration

cs-api-definition
public RadLayeredWindow()

Properties

Alpha

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

Declaration

cs-api-definition
public float Alpha { get; set; }

Property Value

float

BackgroundImage

Gets or sets the Image that represents the Layered window.

Declaration

cs-api-definition
public override Image BackgroundImage { get; set; }

Property Value

Image

Overrides Control.BackgroundImage

BackgroundSvgImage

Gets or sets the RadSvgImage that represents the Layered window.

Declaration

cs-api-definition
public RadSvgImage BackgroundSvgImage { get; set; }

Property Value

RadSvgImage

Content

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

Declaration

cs-api-definition
protected Bitmap Content { get; }

Property Value

Bitmap

CreateParams

Declaration

cs-api-definition
protected override CreateParams CreateParams { get; }

Property Value

CreateParams

Overrides Control.CreateParams

DesiredSize

Gets or sets the size of the window.

Declaration

cs-api-definition
public Size DesiredSize { get; set; }

Property Value

Size

DisplaySize

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

Declaration

cs-api-definition
public virtual Size DisplaySize { get; }

Property Value

Size

HitTestable

Determines whether the Control is visible for mouse input.

Declaration

cs-api-definition
public bool HitTestable { get; set; }

Property Value

bool

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

cs-api-definition
public bool RecreateHandleOnSizeChanged { get; set; }

Property Value

bool

TopMost

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

Declaration

cs-api-definition
public bool TopMost { get; set; }

Property Value

bool

Updated

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

Declaration

cs-api-definition
public bool Updated { get; protected set; }

Property Value

bool

Methods

BringToFront(bool)

Brings the window on top of the z-order.

Declaration

cs-api-definition
public void BringToFront(bool activate)

Parameters

activate

bool

OnPaint(PaintEventArgs)

Declaration

cs-api-definition
protected override void OnPaint(PaintEventArgs e)

Parameters

e

PaintEventArgs

Overrides Control.OnPaint(PaintEventArgs)

OnPaintBackground(PaintEventArgs)

Declaration

cs-api-definition
protected override void OnPaintBackground(PaintEventArgs pevent)

Parameters

pevent

PaintEventArgs

Overrides Control.OnPaintBackground(PaintEventArgs)

PaintWindow(Graphics, Bitmap)

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

Declaration

cs-api-definition
protected virtual void PaintWindow(Graphics g, Bitmap graphicsBitmap)

Parameters

g

Graphics

The graphics to use.

graphicsBitmap

Bitmap

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

ResumeUpdates()

Resumes previously suspended updates and forces Layered update.

Declaration

cs-api-definition
public void ResumeUpdates()

ResumeUpdates(bool)

Resumes previously suspended updates. Optionally preforms Layered update.

Declaration

cs-api-definition
public void ResumeUpdates(bool update)

Parameters

update

bool

SendToBack(bool)

Sends the window to back of the z-order.

Declaration

cs-api-definition
public void SendToBack(bool activate)

Parameters

activate

bool

ShowWindow(Point)

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

Declaration

cs-api-definition
public virtual void ShowWindow(Point screenLocation)

Parameters

screenLocation

Point

SuspendUpdates()

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

Declaration

cs-api-definition
public void SuspendUpdates()

UpdateWindow()

Updates the layered window.

Declaration

cs-api-definition
protected void UpdateWindow()

WndProc(ref Message)

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

Declaration

cs-api-definition
protected override void WndProc(ref Message m)

Parameters

m

Message

Overrides Control.WndProc(ref Message)