igniteui-react-charts
Version:
Ignite UI React charting components for building rich data visualizations using TypeScript APIs.
418 lines (413 loc) • 16.9 kB
TypeScript
import { IgPoint } from "igniteui-react-core";
import { IgrAxis } from "./igr-axis";
import { OverlayTextLocation } from "./OverlayTextLocation";
import { AnnotationAppearanceMode } from "./AnnotationAppearanceMode";
import { IgrOverlayTextUpdatingEventArgs } from "./igr-overlay-text-updating-event-args";
import { IgrSeries, IIgrSeriesProps } from "./igr-series";
import { ValueOverlay } from "./ValueOverlay";
/**
* Represents the class of the value overlay. The value overlay is a line or circle representing a value on an axis.
*/
export declare class IgrValueOverlay extends IgrSeries<IIgrValueOverlayProps> {
protected createImplementation(): ValueOverlay;
/**
* @hidden
*/
get i(): ValueOverlay;
constructor(props: IIgrValueOverlayProps);
/**
* Gets or sets the axis used by the value overlay.
*/
get axis(): IgrAxis;
set axis(v: IgrAxis);
private _axisName;
/**
* Gets or sets the name to use to resolve axis from markup.
*/
get axisName(): string;
set axisName(v: string);
/**
* Gets or sets the value of the overlay.
*/
get value(): number;
set value(v: number);
/**
* Gets or sets the value of the overlay as a date. If this is set to something other than the minimum date, then it will be preferred over the Value property.
*/
get dateValue(): Date;
set dateValue(v: Date);
/**
* Gets or sets whether to draw annotations over the axes where the crosshair meets with them.
*/
get isAxisAnnotationEnabled(): boolean;
set isAxisAnnotationEnabled(v: boolean);
/**
* Sets or gets a function which takes an object that produces a formatted label for the axis annotation.
*/
get axisAnnotationFormatLabel(): (item: any) => string;
set axisAnnotationFormatLabel(v: (item: any) => string);
/**
* Gets or sets the color to use for the axis annotation text. Leave unset for an automatic value.
*/
get axisAnnotationTextColor(): string;
set axisAnnotationTextColor(v: string);
/**
* Gets or sets the color to use for the axis annotation backing. Leave unset for an automatic value.
*/
get axisAnnotationBackground(): string;
set axisAnnotationBackground(v: string);
/**
* Gets or sets the corner radius to use for the axis annotation backing. Leave unset for an automatic value.
*/
get axisAnnotationBackgroundCornerRadius(): number;
set axisAnnotationBackgroundCornerRadius(v: number);
/**
* Gets or sets the precision to use displaying values for interpolated positions.
*/
get axisAnnotationInterpolatedValuePrecision(): number;
set axisAnnotationInterpolatedValuePrecision(v: number);
/**
* Gets or sets the color to use for the axis annotation outline. Leave unset for an automatic value.
*/
get axisAnnotationOutline(): string;
set axisAnnotationOutline(v: string);
/**
* Gets or sets the padding to use withing the axis annotation callout. Leaving this NaN will use an automatic value related to the axis label margins.
*/
get axisAnnotationPaddingLeft(): number;
set axisAnnotationPaddingLeft(v: number);
/**
* Gets or sets the padding to use withing the axis annotation callout. Leaving this NaN will use an automatic value related to the axis label margins.
*/
get axisAnnotationPaddingTop(): number;
set axisAnnotationPaddingTop(v: number);
/**
* Gets or sets the padding to use withing the axis annotation callout. Leaving this NaN will use an automatic value related to the axis label margins.
*/
get axisAnnotationPaddingRight(): number;
set axisAnnotationPaddingRight(v: number);
/**
* Gets or sets the padding to use withing the axis annotation callout. Leaving this NaN will use an automatic value related to the axis label margins.
*/
get axisAnnotationPaddingBottom(): number;
set axisAnnotationPaddingBottom(v: number);
/**
* Gets or sets the stroke thickness for the axis annotation backing. Leave unset for an automatic value.
*/
get axisAnnotationStrokeThickness(): number;
set axisAnnotationStrokeThickness(v: number);
/**
* Gets whether the series is a value overlay.
*/
get isValueOverlay(): boolean;
get labelResolved(): string;
/**
* Gets or sets location of the overlay text in relation to shape of data annotation.
*/
get overlayTextLocation(): OverlayTextLocation;
set overlayTextLocation(v: OverlayTextLocation);
/**
* Gets or sets the horizontal margin of the overlay text in relation to shape of data annotation.
*/
get overlayTextHorizontalMargin(): number;
set overlayTextHorizontalMargin(v: number);
/**
* Gets or sets the vertical margin of the overlay text in relation to shape of data annotation.
*/
get overlayTextVerticalMargin(): number;
set overlayTextVerticalMargin(v: number);
/**
* Gets or sets the horizontal padding of the overlay text in relation to shape of data annotation.
*/
get overlayTextHorizontalPadding(): number;
set overlayTextHorizontalPadding(v: number);
/**
* Gets or sets the vertical padding of the overlay text in relation to shape of data annotation.
*/
get overlayTextVerticalPadding(): number;
set overlayTextVerticalPadding(v: number);
/**
* Gets or sets the angle rotation (in degrees) of the overlay text in relation to shape of data annotation.
*/
get overlayTextAngle(): number;
set overlayTextAngle(v: number);
/**
* Gets or sets the color the overlay text.
*/
get overlayTextColor(): string;
set overlayTextColor(v: string);
/**
* Gets or sets the background the overlay text.
*/
get overlayTextBackground(): string;
set overlayTextBackground(v: string);
/**
* Gets or sets the border stroke of the overlay text.
*/
get overlayTextBorderColor(): string;
set overlayTextBorderColor(v: string);
/**
* Gets or sets the border corner of the overlay text.
*/
get overlayTextBorderRadius(): number;
set overlayTextBorderRadius(v: number);
/**
* Gets or sets the border thickness of the overlay text.
*/
get overlayTextBorderThickness(): number;
set overlayTextBorderThickness(v: number);
/**
* Gets or sets whether the overlay text is visible in shape of data annotation
*/
get overlayTextVisible(): boolean;
set overlayTextVisible(v: boolean);
/**
* Gets or sets the text that will be displayed as the overlay annotation.
*/
get overlayText(): string;
set overlayText(v: string);
/**
* Gets or sets the shift of the overlay text color based on OverlayTextColorMode. Value must range between -1.0 to 1.0, where 0 means no color shift.
*/
get overlayTextColorShift(): number;
set overlayTextColorShift(v: number);
/**
* Gets or sets the mode used for shifting the background of overlay text based on the target series.
*/
get overlayTextColorMode(): AnnotationAppearanceMode;
set overlayTextColorMode(v: AnnotationAppearanceMode);
/**
* Gets or sets whether the overlay text color matches brush of the layer
*/
get overlayTextColorMatchLayer(): boolean;
set overlayTextColorMatchLayer(v: boolean);
/**
* Gets or sets the shift of the overlay background based on OverlayTextBackgroundMode. Value must range between -1.0 to 1.0, where 0 means no color shift.
*/
get overlayTextBackgroundShift(): number;
set overlayTextBackgroundShift(v: number);
/**
* Gets or sets the mode used for shifting the background of overlay text based on the target series.
*/
get overlayTextBackgroundMode(): AnnotationAppearanceMode;
set overlayTextBackgroundMode(v: AnnotationAppearanceMode);
/**
* Gets or sets whether the overlay text background matches brush of the layer
*/
get overlayTextBackgroundMatchLayer(): boolean;
set overlayTextBackgroundMatchLayer(v: boolean);
/**
* Gets or sets the shift of the overlay border based on OverlayTextBorderMode. Value must range between -1.0 to 1.0, where 0 means no color shift.
*/
get overlayTextBorderShift(): number;
set overlayTextBorderShift(v: number);
/**
* Gets or sets the mode used for shifting the border of overlay text based on the target series.
*/
get overlayTextBorderMode(): AnnotationAppearanceMode;
set overlayTextBorderMode(v: AnnotationAppearanceMode);
/**
* Gets or sets whether the overlay text border matches brush of the layer
*/
get overlayTextBorderMatchLayer(): boolean;
set overlayTextBorderMatchLayer(v: boolean);
/**
* Gets or Sets the style to use for the display text.
*/
get overlayTextStyle(): string;
set overlayTextStyle(v: string);
bindAxes(axes: IgrAxis[]): void;
findByName(name: string): any;
protected _styling(container: any, component: any, parent?: any): void;
getSeriesValue(world: IgPoint, useInterpolation: boolean, skipUnknowns: boolean): number;
getSeriesValuePosition(world: IgPoint, useInterpolation: boolean, skipUnknowns: boolean): IgPoint;
/**
* Gets the item index associated with the specified world position
* @param world
*/
getItemIndex(world: IgPoint): number;
/**
* Gets the item that is the best match for the specified world coordinates.
* @param world * The world coordinates to use.
*/
getItem(world: IgPoint): any;
/**
* Requests that the provided item should be brought into view if possible.
* @param item * The item to attempt to bring into view.
*/
scrollIntoView(item: any): boolean;
/**
* Gets the label for a data item.
* @param value * The unscaled value to get a label for.
*/
getLabel(value: number): string;
private _stylingOverlayText;
private _stylingOverlayText_wrapped;
/**
* Event raised when updating style of overlay text
*/
get stylingOverlayText(): (s: IgrValueOverlay, e: IgrOverlayTextUpdatingEventArgs) => void;
set stylingOverlayText(ev: (s: IgrValueOverlay, e: IgrOverlayTextUpdatingEventArgs) => void);
}
export interface IIgrValueOverlayProps extends IIgrSeriesProps {
/**
* Gets or sets the axis used by the value overlay.
*/
axis?: IgrAxis;
/**
* Gets or sets the name to use to resolve axis from markup.
*/
axisName?: string;
/**
* Gets or sets the value of the overlay.
*/
value?: number | string;
/**
* Gets or sets the value of the overlay as a date. If this is set to something other than the minimum date, then it will be preferred over the Value property.
*/
dateValue?: Date;
/**
* Gets or sets whether to draw annotations over the axes where the crosshair meets with them.
*/
isAxisAnnotationEnabled?: boolean | string;
/**
* Sets or gets a function which takes an object that produces a formatted label for the axis annotation.
*/
axisAnnotationFormatLabel?: (item: any) => string;
/**
* Gets or sets the color to use for the axis annotation text. Leave unset for an automatic value.
*/
axisAnnotationTextColor?: string;
/**
* Gets or sets the color to use for the axis annotation backing. Leave unset for an automatic value.
*/
axisAnnotationBackground?: string;
/**
* Gets or sets the corner radius to use for the axis annotation backing. Leave unset for an automatic value.
*/
axisAnnotationBackgroundCornerRadius?: number | string;
/**
* Gets or sets the precision to use displaying values for interpolated positions.
*/
axisAnnotationInterpolatedValuePrecision?: number | string;
/**
* Gets or sets the color to use for the axis annotation outline. Leave unset for an automatic value.
*/
axisAnnotationOutline?: string;
/**
* Gets or sets the padding to use withing the axis annotation callout. Leaving this NaN will use an automatic value related to the axis label margins.
*/
axisAnnotationPaddingLeft?: number | string;
/**
* Gets or sets the padding to use withing the axis annotation callout. Leaving this NaN will use an automatic value related to the axis label margins.
*/
axisAnnotationPaddingTop?: number | string;
/**
* Gets or sets the padding to use withing the axis annotation callout. Leaving this NaN will use an automatic value related to the axis label margins.
*/
axisAnnotationPaddingRight?: number | string;
/**
* Gets or sets the padding to use withing the axis annotation callout. Leaving this NaN will use an automatic value related to the axis label margins.
*/
axisAnnotationPaddingBottom?: number | string;
/**
* Gets or sets the stroke thickness for the axis annotation backing. Leave unset for an automatic value.
*/
axisAnnotationStrokeThickness?: number | string;
/**
* Gets or sets location of the overlay text in relation to shape of data annotation.
*/
overlayTextLocation?: OverlayTextLocation | string;
/**
* Gets or sets the horizontal margin of the overlay text in relation to shape of data annotation.
*/
overlayTextHorizontalMargin?: number | string;
/**
* Gets or sets the vertical margin of the overlay text in relation to shape of data annotation.
*/
overlayTextVerticalMargin?: number | string;
/**
* Gets or sets the horizontal padding of the overlay text in relation to shape of data annotation.
*/
overlayTextHorizontalPadding?: number | string;
/**
* Gets or sets the vertical padding of the overlay text in relation to shape of data annotation.
*/
overlayTextVerticalPadding?: number | string;
/**
* Gets or sets the angle rotation (in degrees) of the overlay text in relation to shape of data annotation.
*/
overlayTextAngle?: number | string;
/**
* Gets or sets the color the overlay text.
*/
overlayTextColor?: string;
/**
* Gets or sets the background the overlay text.
*/
overlayTextBackground?: string;
/**
* Gets or sets the border stroke of the overlay text.
*/
overlayTextBorderColor?: string;
/**
* Gets or sets the border corner of the overlay text.
*/
overlayTextBorderRadius?: number | string;
/**
* Gets or sets the border thickness of the overlay text.
*/
overlayTextBorderThickness?: number | string;
/**
* Gets or sets whether the overlay text is visible in shape of data annotation
*/
overlayTextVisible?: boolean | string;
/**
* Gets or sets the text that will be displayed as the overlay annotation.
*/
overlayText?: string;
/**
* Gets or sets the shift of the overlay text color based on OverlayTextColorMode. Value must range between -1.0 to 1.0, where 0 means no color shift.
*/
overlayTextColorShift?: number | string;
/**
* Gets or sets the mode used for shifting the background of overlay text based on the target series.
*/
overlayTextColorMode?: AnnotationAppearanceMode | string;
/**
* Gets or sets whether the overlay text color matches brush of the layer
*/
overlayTextColorMatchLayer?: boolean | string;
/**
* Gets or sets the shift of the overlay background based on OverlayTextBackgroundMode. Value must range between -1.0 to 1.0, where 0 means no color shift.
*/
overlayTextBackgroundShift?: number | string;
/**
* Gets or sets the mode used for shifting the background of overlay text based on the target series.
*/
overlayTextBackgroundMode?: AnnotationAppearanceMode | string;
/**
* Gets or sets whether the overlay text background matches brush of the layer
*/
overlayTextBackgroundMatchLayer?: boolean | string;
/**
* Gets or sets the shift of the overlay border based on OverlayTextBorderMode. Value must range between -1.0 to 1.0, where 0 means no color shift.
*/
overlayTextBorderShift?: number | string;
/**
* Gets or sets the mode used for shifting the border of overlay text based on the target series.
*/
overlayTextBorderMode?: AnnotationAppearanceMode | string;
/**
* Gets or sets whether the overlay text border matches brush of the layer
*/
overlayTextBorderMatchLayer?: boolean | string;
/**
* Gets or Sets the style to use for the display text.
*/
overlayTextStyle?: string;
/**
* Event raised when updating style of overlay text
*/
stylingOverlayText?: (s: IgrValueOverlay, e: IgrOverlayTextUpdatingEventArgs) => void;
}