New to Telerik UI for WinForms? Start a free 30-day trial
Properties, Methods and Events for RadCallout
Updated over 6 months ago
Properties
| Property | Description |
|---|---|
| ErrorCaption | Static property which gets or sets the title (caption) of the error message when the callout can't be shown. |
| ErrorMessage | Static property which gets or sets the content of the error message. |
| CalloutForm | Gets the callout form (ShapedForm). |
| AssociatedControl | Gets or sets the associated control that is displayed in the callout. Note that you can associate a single control to RadCallout. If you need to add multiple controls, add them in a container (e.g. RadPanel) control and associate it with RadCallout. |
| CalloutType | Gets or sets the type of the shape of the callout. |
| ArrowType | Gets or sets the type of the arrow of the callout. By default, it is CalloutArrowType.Triangle. |
| ArrowSize | Gets or sets the size of the arrow of the callout. Its default size is (20,20). |
| ArrowDirection | Gets or sets the direction of the arrow of the callout. Its default value is ArrowDirection.Down. |
| CornerRadius | Gets or sets the size of the arrow of the callout. It is applicable when CalloutType is CalloutType.RoundedRectangle. Its default value is 5. |
| Distance | Gets or sets the distance between the callout and the control(element) relative to which it is shown. Its default value is 0. |
| DropShadow | Gets or sets a value indicating whether the callout drops a shadow. Note that the shadow effect cannot be customized. By default, it is false. |
| AutoClose | 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 RadCallout.Close() method. Its default value is true. |
| MoveWithParentForm | 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. |
| CloseAction | Determines the executed action when the callout form is about to be closed. Its default value is CalloutCloseAction.Hide. |
| AnimationManager | Gets the animation manager, which holds all the animation settings and is responsible for the callout animations. |
Methods
| Method | Description |
|---|---|
| Show(Point location) | Shows a callout form pointing to a specific location in screen coordinates. |
| Show(Control control) | Shows a callout form pointing to a specific control. |
| Show(RadElement element) | Shows a callout form pointing to a specific element. |
| Close | Closes the callout form. |
Static Methods
| Method | Description |
|---|---|
| Show(Control content, Point targetPoint, CalloutShapeSettings shapeSettings = null) | Shows a callout by given content over the provided target point. |
| Show(Control content, Control targetControl, CalloutShapeSettings shapeSettings = null) | Shows a callout by given content over the provided target control. |
| Show(Control content, RadElement targetElement, CalloutShapeSettings shapeSettings = null) | Shows a callout by given content over the provided target element. |
| Show(Point targetPoint, string content, string caption = "", string footer = "", CalloutShapeSettings shapeSettings = null) | Shows a screen tip in a callout over the provided target point. |
| Show(Control targetControl, string content, string caption = "", string footer = "", CalloutShapeSettings shapeSettings = null) | Shows a screen tip in a callout over the provided target control. |
| Show(RadElement targetElement, string content, string caption = "", string footer = "", CalloutShapeSettings shapeSettings = null) | Shows a screen tip in a callout over the provided target element. |
| Show(RadCallout callout, Point targetPoint, string content, string caption = "", string footer = "") | Shows a screen tip in a given callout over the provided target screen point. |
| Show(RadCallout callout, Control targetControl, string content, string caption = "", string footer = "" | Shows a screen tip in a given callout over the provided target control. |
| Show(RadCallout callout, RadElement targetElement, string content, string caption = "", string footer = "") | Shows a screen tip in a given callout over the provided target element. |
Events
| Event | Description |
|---|---|
| Opening | Fires when the callout about to be opened. Cancellable. |
| Opened | Fires when the callout is opened. |
| Closing | Fires when the callout about to be closed. Cancellable. |
| Closed | Fires when the callout is closed. |