java.lang.Comparable<DisplayObjectType>
DefaultDisplayObjectType
, DOTArea
, DOTAsbNode
, DOTComplex
, DOTKm
, DOTLine
, DOTNeedle
, DOTPoint
, DOTRn
, DOTStat
public interface DisplayObjectType extends java.lang.Comparable<DisplayObjectType>
Der Name eines Darstellungstypen wird bei der Definition vom Benutzer festgelegt. Er wird als eindeutiges Erkennungszeichen in den Verwaltungsdialogen verwendet, und auch bei der Anzeige in der Legende. Außerdem hat ein Darstellungstyp eine 'Info', die als Tooltipp etwa in der Legende benutzt wird.
Ein Darstellungstyp legt fest wie die DisplayObjects
eines Layers dargestellt
werden. Darstellungstypen können Grundfiguren
besitzen, müssen es aber nicht.
Beispiele für Darstellungstypen ohne Grundfiguren sind DOTArea
, DOTComplex
und
DOTLine
. Bei diesen Klassen hängen alle Eigenschaften
der Visualisierung
(z.B. die Farbe) direkt am Darstellungstypen. Anders verhält es sich bei der Klasse DOTPoint
:
dieser Darstellungstyp hat selbst keine Eigenschaften, sondern ausschließlich benutzerdefinierte
Grundfiguren (z.B. ein Rechteck festgelegter Größe) und nur an diesen hängen die Eigenschaften.
Bei der Implementation sollte der Zugriff auf Eigenschaften, die direkt am Darstellungstypen hängen,
durch null
als Wert für die Grundfigur geschehen.
Jede Grundfigur hat einen Typ, der einerseits definiernde Größen (z.B. den Radius bei dem Typ Kreis), aber auch die möglichen Visualisierungs-Eigenschaften festlegt (z.B. die Füllfarbe).
Eine Visualisierungs-Eigenschaft ist entweder statisch, d.h. unveränderbar, oder dynamisch, d.h. sie verändert sich in Abhängigkeit von Online-Daten.
Modifier and Type | Interface | Description |
---|---|---|
static interface |
DisplayObjectType.DisplayObjectTypeItem |
Ein Interface für die kleinste Einheit beim Zuordnen von Anmeldedaten (Attributgruppe, Aspekt,
Attribut) zu Eigenschaftswerten und deren Beschreibung.
|
Modifier and Type | Method | Description |
---|---|---|
void |
deletePreferences(java.util.prefs.Preferences prefs) |
Löscht den DisplayObjectType unter dem übergebenen Knoten.
|
java.util.List<java.lang.String> |
getAttributeNames(java.lang.String primitiveFormName,
Property property,
DOTSubscriptionData subscriptionData) |
Gibt die Attributnamen, für die Werte benötigt werden, zu der übergebenen Eigenschaft
und der übergebenen Anmeldung zurück.
|
DisplayObjectType |
getCopy(java.lang.String name) |
Macht eine tiefe Kopie des DisplayObjectTypes und setzt den Namen um, falls der übergebene String nicht
null ist. |
DisplayObjectType.DisplayObjectTypeItem |
getDisplayObjectTypeItemForState(java.lang.String primitiveFormName,
Property property,
DOTSubscriptionData subscriptionData,
de.bsvrz.dav.daf.main.DataState dataState) |
Ist der Rückgabewert nicht
null , so ist dieser DisplayObjectType.DisplayObjectTypeItem für die übergebenen Daten anwendbar. |
DisplayObjectTypePlugin |
getDisplayObjectTypePlugin() |
Gibt die Selebstbeschreibung des Plugins, zu dem dieser DisplayObjectType gehört, zurück.
|
DisplayObjectType.DisplayObjectTypeItem |
getDOTItemForValue(java.lang.String primitiveFormName,
Property property,
DOTSubscriptionData subscriptionData,
java.lang.String attributeName,
double value) |
Ist der Rückgabewert nicht
null , so ist dieser DisplayObjectType.DisplayObjectTypeItem für die übergebenen Daten anwendbar. |
java.util.List<Property> |
getDynamicProperties(java.lang.String primitiveFormName) |
Zugriff auf alle dynamischen Properties der Grundfigur.
|
java.lang.String |
getInfo() |
Getter für die Info.
|
LegendTreeNodes |
getLegendTreeNodes() |
Erzeugt den Teilbaum der Legende, für diesen Darstellungstyp.
|
java.lang.String |
getName() |
Getter für den Namen.
|
java.lang.String |
getPrimitiveFormInfo(java.lang.String primitiveFormName) |
Gibt die Kurzinfo zu der Grundfigur zurück.
|
java.util.Set<java.lang.String> |
getPrimitiveFormNames() |
Zugriff auf alle auftretenden Grundfigurnamen.
|
java.lang.String |
getPrimitiveFormType(java.lang.String primitiveFormName) |
Gibt den Grundfigurtyp der Grundfigur zurück.
|
java.util.Set<DOTSubscriptionData> |
getSubscriptionData() |
Gibt alle Anmeldungen, die dieser DisplayObjectTyp benötigt, zurück.
|
java.util.Set<java.lang.String> |
getUsedColors() |
Gibt die Namen aller von diesem DisplayObject verwendeten Farben zurück.
|
java.lang.Object |
getValueOfStaticProperty(java.lang.String primitiveFormName,
Property property) |
Gibt den Wert der übergebenen Property zurück, die gegebenenfalls zu der genannten Grundfigur gehört.
|
void |
initializeFromPreferences(java.util.prefs.Preferences prefs) |
Initialisiert den DisplayObjectType aus dem übergebenen Knoten.
|
boolean |
isPropertyStatic(java.lang.String primitiveFormName,
Property property) |
Ist die Property zu der als Object übergebenen Grundfigur statisch, so erhält man
true zurück; andernfalls ist die Eigenschaft dynamisch und man erhält
false . |
void |
putPreferences(java.util.prefs.Preferences prefs) |
Speichert die Informationen des DisplayObjectTypes unter dem übergebenen Knoten.
|
void |
removePrimitiveForm(java.lang.String primitiveFormName) |
Löscht die entsprechende Grundfigur.
|
void |
setInfo(java.lang.String info) |
Setter für die Info.
|
void |
setName(java.lang.String name) |
Setter für den Namen.
|
void |
setPropertyStatic(java.lang.String primitiveFormName,
Property property,
boolean b) |
Setzt die Eigenschaft statisch bzw dynamisch zu sein der übergebenen Eigenschaft, die gegebenenfalls
zu der genannten Grundfigur gehört.
|
void |
setValueOfDynamicProperty(java.lang.String primitiveFormName,
Property property,
DisplayObjectType.DisplayObjectTypeItem dItem,
java.lang.Double lowerBound,
java.lang.Double upperBound) |
Setzt den Wert der übergebenen Property, die gegebenenfalls zu der genannten Grundfigur gehört, für
das übergebene Intervall auf das übergebene DisplayObjectTypeItem.
|
void |
setValueOfStaticProperty(java.lang.String primitiveFormName,
Property property,
java.lang.Object value) |
Setzt den Wert der übergebenen Property, die gegebenenfalls zu der genannten Grundfigur gehört.
|
java.lang.String getName()
void setName(java.lang.String name)
name
- der neue Namejava.lang.String getInfo()
void setInfo(java.lang.String info)
info
- die Kurzinfojava.util.Set<java.lang.String> getPrimitiveFormNames()
java.lang.String getPrimitiveFormType(java.lang.String primitiveFormName)
primitiveFormName
- der Name einer Grundfigurjava.lang.String getPrimitiveFormInfo(java.lang.String primitiveFormName)
primitiveFormName
- der Name einer Grundfigurvoid removePrimitiveForm(java.lang.String primitiveFormName)
primitiveFormName
- der Name einer Grundfigurjava.util.List<Property> getDynamicProperties(@Nullable java.lang.String primitiveFormName)
primitiveFormName
- der Name einer Grundfigurboolean isPropertyStatic(@Nullable java.lang.String primitiveFormName, Property property)
true
zurück; andernfalls ist die Eigenschaft dynamisch und man erhält
false
.primitiveFormName
- der Name einer Grundfigur oder null
property
- eine Eigenschaftvoid setPropertyStatic(@Nullable java.lang.String primitiveFormName, Property property, boolean b)
primitiveFormName
- der Name einer Grundfigur oder null
property
- eine Eigenschaftb
- der neue Wertjava.lang.Object getValueOfStaticProperty(@Nullable java.lang.String primitiveFormName, Property property)
primitiveFormName
- der Name einer Grundfigur oder null
property
- eine Eigenschaftvoid setValueOfStaticProperty(@Nullable java.lang.String primitiveFormName, Property property, java.lang.Object value)
primitiveFormName
- der Name einer Grundfigur oder null
property
- eine Eigenschaftvalue
- der neue Wertvoid setValueOfDynamicProperty(@Nullable java.lang.String primitiveFormName, Property property, DisplayObjectType.DisplayObjectTypeItem dItem, @Nullable java.lang.Double lowerBound, @Nullable java.lang.Double upperBound)
primitiveFormName
- der Name einer Grundfigur oder null
property
- eine EigenschaftdItem
- ein ItemlowerBound
- die untere SchrankeupperBound
- die obere SchrankeDisplayObjectType getCopy(@Nullable java.lang.String name)
null
ist. Diese Methode wird beim Erstellen und Bearbeiten von Darstellungstypen verwendet:
dem Bearbeitungs-Dialog wird eine tiefe Kopie übergeben und alle Änderungen werden an diesem
Objekt durchgeführt.name
- der neue Name oder null
void putPreferences(java.util.prefs.Preferences prefs)
prefs
- der Knoten, unter dem die Speicherung durchgeführt werden sollvoid initializeFromPreferences(java.util.prefs.Preferences prefs)
prefs
- der Knoten, unter dem die Initialisierung durchgeführt werden sollvoid deletePreferences(java.util.prefs.Preferences prefs)
prefs
- der Knoten, unter dem die Löschung durchgeführt werden sollDisplayObjectTypePlugin getDisplayObjectTypePlugin()
LegendTreeNodes getLegendTreeNodes()
java.util.Set<DOTSubscriptionData> getSubscriptionData()
java.util.List<java.lang.String> getAttributeNames(@Nullable java.lang.String primitiveFormName, Property property, DOTSubscriptionData subscriptionData)
primitiveFormName
- der Name einer Grundfigur oder null
property
- eine EigenschaftsubscriptionData
- eine Anmeldungjava.util.Set<java.lang.String> getUsedColors()
DisplayObjectType.DisplayObjectTypeItem getDOTItemForValue(@Nullable java.lang.String primitiveFormName, Property property, DOTSubscriptionData subscriptionData, java.lang.String attributeName, double value)
null
, so ist dieser DisplayObjectType.DisplayObjectTypeItem
für die übergebenen Daten anwendbar.
Diese Methode wird von einem OnlineDisplayObject
aufgerufen, wenn neue Online-Daten vorliegen, die
eine Änderung der Visualisierungs-Eigenschaft zur Folge haben könnte. Der im Rückgabewert enthaltene
Wert (z.B. eine Farbe) wird dann vom Painter
zur Visualisierung verwendet.primitiveFormName
- der Name einer Grundfigur oder null
property
- die EigenschaftsubscriptionData
- Attributgruppe und AspektattributeName
- Attributvalue
- Wert des Attributsnull
DisplayObjectType.DisplayObjectTypeItem getDisplayObjectTypeItemForState(@Nullable java.lang.String primitiveFormName, Property property, DOTSubscriptionData subscriptionData, de.bsvrz.dav.daf.main.DataState dataState)
null
, so ist dieser DisplayObjectType.DisplayObjectTypeItem
für die übergebenen Daten anwendbar.
Diese Methode wird von einem DisplayObject
aufgerufen, wenn zur gegebenen Anmeldung
neue Daten geschickt wurden, die aber keine Werte für die Attribute enthalten, sondern Informationen
über den Zustand
. Der im Rückgabewert enthaltene Wert (z.B. eine Farbe) wird dann vom
Painter
zur Visualisierung verwendet.primitiveFormName
- der Name einer Grundfigur oder null
property
- die EigenschaftsubscriptionData
- Attributgruppe und AspektdataState
- Zustand des Datensatzesnull