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

The callout form is a ShapedForm and provides a form with integrated arrow, which points to a specific location, control or element.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class RadCalloutForm : ShapedForm, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, IContainerControl, IThemeChangeListener

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlContainerControlFormShapedFormRadCalloutForm...

Implements: IBindableComponentIComponentIContainerControlIDisposableIDropTargetISynchronizeInvokeIThemeChangeListenerIWin32Window...

Inherited Members ShapedForm.OnThemeChanged(ThemeChangedEventArgs)ShapedForm.SetBoundsCore(int, int, int, int, BoundsSpecified)ShapedForm.SetClientSizeCore(int, int)ShapedForm.OnLoad(EventArgs)ShapedForm.OnShown(EventArgs)ShapedForm.OnPaintBackground(PaintEventArgs)ShapedForm.OnSizeChanged(EventArgs)ShapedForm.WndProc(ref Message)ShapedForm.ApplicationThemeChanged(object, ThemeChangedEventArgs)ShapedForm.ScaleControl(SizeF, BoundsSpecified)ShapedForm.OnResizeBegin(EventArgs)ShapedForm.OnResizeEnd(EventArgs)ShapedForm.OnMove(EventArgs)ShapedForm.PaintFrame(Graphics)ShapedForm.PaintBorder(Graphics)ShapedForm.GetHitTest(Point)ShapedForm.LOWORD(int)ShapedForm.ShapedControlShapedForm.WindowsSettingsShapedForm.BackColorShapedForm.BorderColorShapedForm.ForeColorShapedForm.FontShapedForm.BorderAlignmentShapedForm.AllowResizeShapedForm.ShapeShapedForm.ThemeNameShapedForm.EnableCompositionOnVistaShapedForm.FormBorderStyleShapedForm.ControlThemeClassNameShapedForm.BorderPathShapedForm.OuterPathForm.SetVisibleCore(bool)Form.Activate()Form.ActivateMdiChild(Form)Form.AddOwnedForm(Form)Form.AdjustFormScrollbars(bool)Form.CreateControlsInstance()Form.CreateHandle()Form.DefWndProc(ref Message)Form.ProcessMnemonic(char)Form.CenterToParent()Form.CenterToScreen()Form.LayoutMdi(MdiLayout)Form.OnActivated(EventArgs)Form.OnBackgroundImageChanged(EventArgs)Form.OnBackgroundImageLayoutChanged(EventArgs)Form.OnClosing(CancelEventArgs)Form.OnClosed(EventArgs)Form.OnFormClosed(FormClosedEventArgs)Form.OnCreateControl()Form.OnDeactivate(EventArgs)Form.OnEnabledChanged(EventArgs)Form.OnEnter(EventArgs)Form.OnFontChanged(EventArgs)Form.OnHandleCreated(EventArgs)Form.OnHandleDestroyed(EventArgs)Form.OnHelpButtonClicked(CancelEventArgs)Form.OnLayout(LayoutEventArgs)Form.OnMaximizedBoundsChanged(EventArgs)Form.OnMaximumSizeChanged(EventArgs)Form.OnMinimumSizeChanged(EventArgs)Form.OnInputLanguageChanged(InputLanguageChangedEventArgs)Form.OnInputLanguageChanging(InputLanguageChangingEventArgs)Form.OnMdiChildActivate(EventArgs)Form.OnMenuStart(EventArgs)Form.OnMenuComplete(EventArgs)Form.OnPaint(PaintEventArgs)Form.OnResize(EventArgs)Form.OnDpiChanged(DpiChangedEventArgs)Form.OnGetDpiScaledSize(int, int, ref Size)Form.OnRightToLeftLayoutChanged(EventArgs)Form.OnTextChanged(EventArgs)Form.ProcessCmdKey(ref Message, Keys)Form.ProcessDialogKey(Keys)Form.ProcessDialogChar(char)Form.ProcessKeyPreview(ref Message)Form.ProcessTabKey(bool)Form.RemoveOwnedForm(Form)Form.Select(bool, bool)Form.GetScaledBounds(Rectangle, SizeF, BoundsSpecified)Form.SetDesktopBounds(int, int, int, int)Form.SetDesktopLocation(int, int)Form.Show(IWin32Window)Form.ShowDialog()Form.ShowDialog(IWin32Window)Form.ToString()Form.UpdateDefaultButton()Form.OnStyleChanged(EventArgs)Form.ValidateChildren()Form.ValidateChildren(ValidationConstraints)Form.AcceptButtonForm.ActiveFormForm.ActiveMdiChildForm.AllowTransparencyForm.AutoScrollForm.AutoSizeForm.AutoSizeModeForm.AutoValidateForm.CancelButtonForm.ClientSizeForm.ControlBoxForm.DefaultImeModeForm.DefaultSizeForm.DesktopBoundsForm.DesktopLocationForm.DialogResultForm.HelpButtonForm.IconForm.IsMdiChildForm.IsMdiContainerForm.IsRestrictedWindowForm.KeyPreviewForm.LocationForm.MaximizedBoundsForm.MaximumSizeForm.MainMenuStripForm.MenuForm.MinimumSizeForm.MaximizeBoxForm.MdiChildrenForm.MdiParentForm.MergedMenuForm.MinimizeBoxForm.ModalForm.OpacityForm.OwnedFormsForm.OwnerForm.RestoreBoundsForm.RightToLeftLayoutForm.ShowInTaskbarForm.ShowIconForm.ShowWithoutActivationForm.SizeForm.SizeGripStyleForm.StartPositionForm.TextForm.TopLevelForm.TopMostForm.TransparencyKeyForm.WindowStateForm.AutoSizeChangedForm.AutoValidateChangedForm.HelpButtonClickedForm.MaximizedBoundsChangedForm.MaximumSizeChangedForm.MinimumSizeChangedForm.ActivatedForm.DeactivateForm.FormClosingForm.FormClosedForm.LoadForm.MdiChildActivateForm.MenuCompleteForm.MenuStartForm.InputLanguageChangedForm.InputLanguageChangingForm.RightToLeftLayoutChangedForm.ShownForm.DpiChangedForm.ResizeBeginForm.ResizeEndContainerControl.OnAutoValidateChanged(EventArgs)ContainerControl.OnParentChanged(EventArgs)ContainerControl.PerformAutoScale()ContainerControl.Validate()ContainerControl.Validate(bool)ContainerControl.AutoScaleDimensionsContainerControl.AutoScaleFactorContainerControl.AutoScaleModeContainerControl.BindingContextContainerControl.CanEnableImeContainerControl.ActiveControlContainerControl.CurrentAutoScaleDimensionsContainerControl.ParentFormScrollableControl.ScrollStateAutoScrollingScrollableControl.ScrollStateHScrollVisibleScrollableControl.ScrollStateVScrollVisibleScrollableControl.ScrollStateUserHasScrolledScrollableControl.ScrollStateFullDragScrollableControl.GetScrollState(int)ScrollableControl.OnMouseWheel(MouseEventArgs)ScrollableControl.OnRightToLeftChanged(EventArgs)ScrollableControl.OnPaddingChanged(EventArgs)ScrollableControl.SetDisplayRectLocation(int, int)ScrollableControl.ScrollControlIntoView(Control)ScrollableControl.ScrollToControl(Control)ScrollableControl.OnScroll(ScrollEventArgs)ScrollableControl.SetAutoScrollMargin(int, int)ScrollableControl.SetScrollState(int, bool)ScrollableControl.AutoScrollMarginScrollableControl.AutoScrollPositionScrollableControl.AutoScrollMinSizeScrollableControl.DisplayRectangleScrollableControl.HScrollScrollableControl.HorizontalScrollScrollableControl.VScrollScrollableControl.VerticalScrollScrollableControl.ScrollControl.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.CreateGraphics()Control.CreateControl()Control.DestroyHandle()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.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.OnBindingContextChanged(EventArgs)Control.OnCausesValidationChanged(EventArgs)Control.OnContextMenuChanged(EventArgs)Control.OnContextMenuStripChanged(EventArgs)Control.OnCursorChanged(EventArgs)Control.OnDockChanged(EventArgs)Control.OnForeColorChanged(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.OnClick(EventArgs)Control.OnClientSizeChanged(EventArgs)Control.OnControlAdded(ControlEventArgs)Control.OnControlRemoved(ControlEventArgs)Control.OnLocationChanged(EventArgs)Control.OnDoubleClick(EventArgs)Control.OnDragEnter(DragEventArgs)Control.OnDragOver(DragEventArgs)Control.OnDragLeave(EventArgs)Control.OnDragDrop(DragEventArgs)Control.OnGiveFeedback(GiveFeedbackEventArgs)Control.InvokeGotFocus(Control, EventArgs)Control.OnGotFocus(EventArgs)Control.OnHelpRequested(HelpEventArgs)Control.OnInvalidated(InvalidateEventArgs)Control.OnKeyDown(KeyEventArgs)Control.OnKeyPress(KeyPressEventArgs)Control.OnKeyUp(KeyEventArgs)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.OnQueryContinueDrag(QueryContinueDragEventArgs)Control.OnRegionChanged(EventArgs)Control.OnPreviewKeyDown(PreviewKeyDownEventArgs)Control.OnChangeUICues(UICuesEventArgs)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.ProcessKeyEventArgs(ref Message)Control.ProcessKeyMessage(ref Message)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.Select()Control.SelectNextControl(Control, bool, bool, bool, bool)Control.SendToBack()Control.SetBounds(int, int, int, int)Control.SetBounds(int, int, int, int, BoundsSpecified)Control.SizeFromClientSize(Size)Control.SetStyle(ControlStyles, bool)Control.SetTopLevel(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.BackgroundImageControl.BackgroundImageLayoutControl.BottomControl.BoundsControl.CanFocusControl.CanRaiseEventsControl.CanSelectControl.CaptureControl.CausesValidationControl.CheckForIllegalCrossThreadCallsControl.ClientRectangleControl.CompanyNameControl.ContainsFocusControl.ContextMenuControl.ContextMenuStripControl.ControlsControl.CreatedControl.CursorControl.DataBindingsControl.DefaultBackColorControl.DefaultCursorControl.DefaultFontControl.DefaultForeColorControl.DefaultMarginControl.DefaultMaximumSizeControl.DefaultMinimumSizeControl.DefaultPaddingControl.DeviceDpiControl.IsDisposedControl.DisposingControl.DockControl.DoubleBufferedControl.EnabledControl.FocusedControl.FontHeightControl.HandleControl.HasChildrenControl.HeightControl.IsHandleCreatedControl.InvokeRequiredControl.IsAccessibleControl.IsMirroredControl.LeftControl.MarginControl.ModifierKeysControl.MouseButtonsControl.MousePositionControl.NameControl.ParentControl.ProductNameControl.ProductVersionControl.RecreatingHandleControl.RegionControl.RenderRightToLeftControl.ResizeRedrawControl.RightControl.RightToLeftControl.ScaleChildrenControl.SiteControl.TabIndexControl.TabStopControl.TagControl.TopControl.TopLevelControlControl.ShowKeyboardCuesControl.ShowFocusCuesControl.UseWaitCursorControl.VisibleControl.WidthControl.PreferredSizeControl.PaddingControl.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.EventsComponent.ContainerComponent.DesignModeComponent.DisposedMarshalByRefObject.MemberwiseClone(bool)MarshalByRefObject.GetLifetimeService()MarshalByRefObject.InitializeLifetimeService()MarshalByRefObject.CreateObjRef(Type)...

Constructors

Initializes a new instance of the RadCalloutForm.

C#
public RadCalloutForm()

Properties

Gets or sets the animation manager, which holds the animation settings and is responsible for the animation.

C#
public CalloutAnimationManager AnimationManager { get; set; }

Gets or sets the direction of the arrow of the callout.

C#
public ArrowDirection ArrowDirection { get; set; }

Gets or sets the size of the arrow of the callout.

C#
public Size ArrowSize { get; set; }

Gets or sets the type of the arrow of the callout.

C#
public CalloutArrowType ArrowType { get; set; }

Gets or sets the associated control that is displayed in the callout.

C#
public Control AssociatedControl { get; set; }

Gets or sets a value indicating whether the callout will automatically close. If true, the Mouse is captured in the callout. If false, user is responsible for closing the callout form either manually or with Close() method.

C#
public bool AutoClose { get; set; }

Gets or sets the border width of callout.

C#
[Browsable(true)]
public override int BorderWidth { get; set; }

Overrides: ShapedForm.BorderWidth

Gets or sets the CalloutShapeSettings used when creating callout shape.

C#
public CalloutShapeSettings CalloutShapeSettings { get; }

Gets or sets the type of the shape of the callout.

C#
public CalloutType CalloutType { get; set; }

Determines the executed action when the callout form is about to be closed.

C#
public CalloutCloseAction CloseAction { get; set; }

Gets or sets the size of the arrow of the callout. It is applicable when CalloutType is RoundedRectangle.

C#
public int CornerRadius { get; set; }
C#
protected override CreateParams CreateParams { get; }

Overrides: ShapedForm.CreateParams

Gets or sets the distance between the callout and the control(element) relative to which it is shown.

C#
public int Distance { get; set; }

Gets or sets a value indicating whether the callout drops a shadow. Note that the shadow effect cannot be customized.

C#
public bool DropShadow { get; set; }

Gets or sets a value indicating whether the callout will move along with the parent form of the placement target. This property has effect only when AutoClose is false.

C#
public bool MoveWithParentForm { get; set; }

Gets the class responsible for following changes of the size and location of the target control or element when the callout is shown.

C#
public CalloutTargetManager TargetManager { get; }

Methods

C#
protected override void ApplyShape()

Overrides: ShapedForm.ApplyShape()

C#
protected override void ApplyTheme(string themeName)
Parameters:themeNamestring

Overrides: ShapedForm.ApplyTheme(string)

C#
public void Close()
C#
protected virtual Point CorrectShowPoint(Point calloutLocation, Point anchorPoint, out Point offset)
Parameters:calloutLocationPointanchorPointPointoffsetPointReturns:

Point

C#
protected override GraphicsPath CreateBorderPath()
Returns:

GraphicsPath

Overrides: ShapedForm.CreateBorderPath()

Creates the callout element shape.

C#
protected virtual CalloutElementShape CreateCalloutShape()
Returns:

CalloutElementShape

The element shape.

Clean up any resources being used.

C#
protected override void Dispose(bool disposing)
Parameters:disposingbool

true if managed resources should be disposed; otherwise, false.

Overrides: ShapedForm.Dispose(bool)

Initializes all fields/properties with their default values.

C#
protected virtual void InitializeFields()
C#
protected override bool IsRectangularShape(ref int radius)
Parameters:radiusintReturns:

bool

Overrides: ShapedForm.IsRectangularShape(ref int)

Occurs when the callout form is closed. Fires the closed event.

C#
protected virtual void OnCalloutClosed(FormClosedEventArgs e)
Parameters:eFormClosedEventArgs

The event arguments.

Occurs when the callout form is about to be closed. Fires the closing event.

C#
protected virtual void OnCalloutClosing(FormClosingEventArgs e)
Parameters:eFormClosingEventArgs

The event arguments.

Occurs when the callout form is about to be closed.

C#
protected override void OnFormClosing(FormClosingEventArgs e)
Parameters:eFormClosingEventArgs

The event arguments.

Overrides: Form.OnFormClosing(FormClosingEventArgs)

Occurs when the callout form is opened. Fires the opened event.

C#
protected virtual void OnOpened(EventArgs e)
Parameters:eEventArgs

The event arguments.

Occurs when the callout form is about to be opened. Fires the opening event.

C#
protected virtual void OnOpening(CancelEventArgs e)
Parameters:eCancelEventArgs

The event arguments.

C#
protected override void OnVisibleChanged(EventArgs e)
Parameters:eEventArgs

Overrides: Form.OnVisibleChanged(EventArgs)

Sets the associated control. Adds the control to the form's Controls collection.

C#
protected virtual void SetAssociatedControl(Control control)
Parameters:controlControl

The control to associate with.

Shows a callout form pointing to a specific control.

C#
public void Show(Control control)
Parameters:controlControl

The control to point to.

Shows a callout form pointing to a specific location in screen coordinates.

C#
public void Show(Point arrowTargetPoint)
Parameters:arrowTargetPointPoint

The target location to point to.

Shows a callout form pointing to a specific element.

C#
public void Show(RadElement element)
Parameters:elementRadElement

The element to point to.

C#
protected virtual void ShowCore(Rectangle anchorRectangle)
Parameters:anchorRectangleRectangle

Updates the location of associated control.

C#
protected virtual void UpdateAssociatedControlPosition()

Events

Fires when the callout is closed.

C#
public event FormClosedEventHandler CalloutClosed

Fires when the callout is about to be closed. The closing action can be canceled by modifying the arguments of this event.

C#
public event FormClosingEventHandler CalloutClosing

Fires when the callout is opened.

C#
public event EventHandler Opened

Fires when the callout is about to be opened. The opening action can be canceled by modifying the arguments of this event.

C#
public event CancelEventHandler Opening