Udostępnij za pośrednictwem


SmartLabelStyle Klasa

Definicja

Udostępnia metody i właściwości używane do przeprowadzania inteligentnego, opartego na regułach pozycjonowania etykiet punktów danych w celu rozwiązania problemów z nakładającymi się etykietami punktów danych.

public ref class SmartLabelStyle
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))>]
type SmartLabelStyle = class
Public Class SmartLabelStyle
Dziedziczenie
SmartLabelStyle
Pochodne
Atrybuty

Przykłady

Imports System.Web.UI.DataVisualization.Charting  

Private Function SetSmartLabelsOptions()  

   ' Enabling the SmartLabels™ attribute.  
   Chart1.Series("Series1").SmartLabels.Enabled = true  

   ' Set the callout style.  
   Chart1.Series("Series1").SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined  

   ' Set the callout line color.  
   Chart1.Series("Series1").SmartLabels.CalloutLineColor = Color.Goldenrod;  

   ' Set the callout line style.  
   Chart1.Series("Series1").SmartLabels.CalloutLineStyle = ChartDashStyle.Dash  

   ' Set the callout line width.  
   Chart1.Series("Series1").SmartLabels.CalloutLineWidth = 3   

   ' Set the callout line anchor cap.  
   Chart1.Series("Series1").SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow  
End Function  
using System.Web.UI.DataVisualization.Charting  

private void SetSmartLabelsOptions()  
{  
   // Enabling the SmartLabels™ attribute.  
   Chart1.Series["Series1"].SmartLabels.Enabled = true;  

   // Set the callout style.  
   Chart1.Series["Series1"].SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined;  

   // Set the callout line color.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineColor = Color.Goldenrod;  

   // Set the callout line style.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineStyle = ChartDashStyle.Dash;  

   // Set the callout line width.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineWidth = 3;  

   // Set the callout line anchor cap.  
   Chart1.Series["Series1"].SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow;  
}  

Uwagi

Gdy etykiety inteligentne są włączone, wykres zmienia położenie nakładających się etykiet punktów danych na podstawie zestawu reguł zdefiniowanych przez użytkownika.

Zostaną narysowane linie objaśnienia, aby połączyć etykietę z punktem danych. Atrybuty wizualne linii objaśnienia mogą być kontrolowane. Te atrybuty wizualizacji obejmują kolor, styl linii i szerokość linii. Właściwości CalloutStyle i CalloutLineAnchorCapStyle kontrolują upiększenia, takie jak strzałki, wyświetlane na końcu linii objaśnienia.

Właściwość CalloutLineColor można ustawić na dowolny Color obiekt. Jeśli ustawisz kolor linii objaśnienia, również automatycznie ustawisz kolor i CalloutLineAnchorCapStyle upiększenie zdefiniowane przez CalloutStyle .

Właściwość CalloutLineWidth kontroluje szerokość pikseli linii objaśnienia. Użycie tej właściwości spowoduje również skalowanie upiększeń właściwości CalloutLineAnchorCapStyle i CalloutStyle .

Ruch etykiet inteligentnych można kontrolować za pomocą kilku właściwości związanych z ruchem. Definiują one reguły ruchu dla kierunku, odległości i tego, czy etykieta punktu danych może opuścić obszar kreślenia. Domyślne reguły ruchu zwykle rozwiążą większość problemów. Definiuje wartość określającą maksymalną odległość w pikselach od punktu danych, z jaką etykiety punktów danych mogą być przenoszone w MaxMovingDistance przypadku nakładania się. Właściwość definiuje wartość określającą minimalną odległość w pikselach od punktu danych, w przypadku których etykiety punktów danych zostaną przeniesione w MinMovingDistance przypadku nakładania się. Gdy należy zmienić położenie etykiety punktu danych, etykieta zostanie przeniesiona o co najmniej określoną liczbę pikseli.

Właściwość wskazuje, czy etykiety są ukryte, gdy nakładające się IsOverlappedHidden problemy nie mogą zostać rozwiązane. Jeśli właściwość ma wartość , a punkt danych nie może być rysowany w obszarze określonym przez właściwość i w kierunkach dozwolonych przez właściwość , etykieta punktu danych nie IsOverlappedHidden true zostanie MinMovingDistance MaxMovingDistance MovingDirection narysowana.

Właściwość definiuje kierunek, w którym można przenieść MovingDirection etykietę punktu danych. Ta właściwość akceptuje jedną LabelAlignmentStyles wartość lub bitowe lub wiele LabelAlignmentStyles wartości. Wartość domyślna to bitowa wartość OR wszystkich wartości, aby umożliwić zmiany położenia we wszystkich możliwych kierunkach z wyjątkiem środka LabelAlignmentStyles punktu danych.

Etykiety inteligentne nie są obsługiwane w przypadku następujących typów wykresów:

  • Wykresy słupkowe: słupkowe i skumulowane w 100 procentach wykresy słupkowe.

  • Wykresy kształtów: wykresy kołowe, pierścieniowe, polarne i radarowe.

  • Wykresy zakresowe: wykresy słupkowe zakresu, kolumny zakresu i zakresu.

  • Skumulowane wykresy warstwowe: skumulowany obszar i wykres warstwowy skumulowany w stu procentach.

Konstruktory

SmartLabelStyle()

Inicjuje nowe wystąpienie klasy SmartLabelStyle.

Właściwości

AllowOutsidePlotArea

Pobiera lub ustawia flagę, która określa, czy SmartLabelStyle obiekt może być rysowany poza obszarem kreślenia.

CalloutBackColor

Pobiera lub ustawia kolor tła objaśnienia etykiety.

CalloutLineAnchorCapStyle

Pobiera lub ustawia styl zakotwiczenia linii objaśnienia etykiety.

CalloutLineColor

Pobiera lub ustawia kolor linii objaśnienia etykiety.

CalloutLineDashStyle

Pobiera lub ustawia styl linii objaśnienia etykiety.

CalloutLineWidth

Pobiera lub ustawia szerokość linii objaśnienia etykiety.

CalloutStyle

Pobiera lub ustawia styl objaśnienia obiektu SmartLabelStyle pozycjonowania.

Enabled

Pobiera lub ustawia flagę, która wskazuje, czy SmartLabelStyle algorytm jest włączony.

IsMarkerOverlappingAllowed

Pobiera lub ustawia flagę, która określa, czy etykiety punktów mogą nakładać się na znacznik punktu.

IsOverlappedHidden

Pobiera lub ustawia flagę wskazującą, czy nakładające się etykiety, których nie można zmienić, będą ukryte.

MaxMovingDistance

Pobiera lub ustawia maksymalną odległość w pikselach, z jaką nakładający się obiekt może SmartLabelStyle zostać przeniesiony ze znacznika.

MinMovingDistance

Pobiera lub ustawia minimalną odległość w pikselach, na jaką nakładający się obiekt może SmartLabelStyle zostać przeniesiony ze znacznika.

MovingDirection

Pobiera lub ustawia kierunek, w którym może zostać przeniesiony nakładający się SmartLabelStyle obiekt.

Metody

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Dotyczy