Versionen im Vergleich

Alte Version 20

changes.mady.by.user Daniela Gehle

Gespeichert am

verglichen mit

Neue Version Aktuell

changes.mady.by.user Daniela Gehle

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.


Panel
borderColor#004f9e
titleColor#ffffff
borderWidth2
titleBGColor#004f9e
borderStylesolid
titleGültig ab jadice documentplatform 5.5.3.0
Dieser Artikel beschreibt, wie das Annotationsprofil zu konfigurieren ist, um Textannotationen relativ zur Seitenausrichtung zu drehen.



Panel
borderColor#db4b1b#ff8c1a
titleColor#ffffff
borderWidth2
titleBGColor#db4b1b#ff8c1a
borderStylesolid
titleGültig ab jadice web toolkit 5.8.3.0
Dieser Artikel beschreibt, wie das Annotationsprofil zu konfigurieren ist, um Textannotationen relativ zur Seitenausrichtung zu drehen.


Neue Funktionen

  • Freies Rotieren von Textannotationen
  • Textannotationen bei gedrehten Seiten in einem lesbaren Zustand anbringen
  • Editor zur Drehung von Textannotationen um 90°

Bitte beachten Sie, dass die Speicherung der Rotation nur mit Formaten, welche ein solches Attribut unterstützen, funktioniert. Dies sind:

  • jadice Annotationsformat
  • ContentManager-Annotationsformat (mit der Einschränkung, dass die Funktionalität nur zur Verfügung steht, wenn die Annotationen ausschließlich über jadice-Komponenten geschrieben und gelesen werden). Bei ContentManager-Annotationen muss wie im folgenden gezeigt beim Speichern der Annoationen noch setSaveAdditionalInfo(true) gesetzt werden.
Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleWriterSettings für Annotationen im CM-Format
DefaultWriterControls writerControls = new DefaultWriterControls();
writerControls.getSettings(CMAnnotationWriterSettings.class).setFormat(format);
writerControls.getSettings(CMAnnotationWriterSettings.class).setSaveAdditionalInfo(true);



Erklärung der Attribute

NameTypDefaultHerkunftBedeutung
rotation<integer>0TextAnnotationDie Rotation selbst wird wie beim Stempel in der Annotation selbst gespeichert. Hierbei handelt es sich um einen Wert, welcher die Rotation (0-359) in Grad darstellt. 
showRotationHandle

<true>, <false>

falseTextAnnotationWranglerDieser Wert gibt an, ob der Handle zur freien Rotation dargestellt wird. 
forceAnnotationUpRight<OFF>, <ON_CREATION>OFFTextAnnotationWranglerÜber dieses Attribut wird festgelegt, ob Textannotationen beim Aufbringen in einem lesbaren Zustand in Relation zu der Seite aufgebracht werden.


Hinweis: Sofern showRotationHandle oder forceAnnotationUpright verwendet werden, muss die Eigenschaft  rotation beim  betreffenden <annotation-type> in das Profil übernommen werden, um die gesetzte Rotation zu speichern. 



Panel
borderColor#004f9e
titleColor#ffffff
borderWidth2
titleBGColor#004f9e
borderStylesolid

Beispiele für den jadice viewer

Beispiel: Einbinden der Rotation (nur jadice Annotationsformat)

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleDefinition der Rotation und des Editors
<annotation-type name="Text" archetype="Text" extends="Rectangle" class="com.levigo.jadice.annotation.TextAnnotation">
	<unrestricted name="rotation" propertyType="java.lang.Integer">
		<default>0</default>
		<editor toolkit="swing" class="com.levigo.jadice.swing.internal.annotation.editors.RotationEditor"/>
	</unrestricted>
...


Zum Speichern der Rotation relativ zum Dokument ist bei Nutzung des jadice-Annotationsformats in allen Anwendungsfällen die Konfiguration der Property "rotation" nötig. Bei ContentManager-Annotationen entfällt diese Konfiguration.

Beispiel: Verwendung des RotationEditors

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleDefinition der Rotation und des Editors
<annotation-type name="Text" archetype="Text" extends="Rectangle" class="com.levigo.jadice.annotation.TextAnnotation">
	<unrestricted name="rotation" propertyType="java.lang.Integer">
		<default>0</default>
		<editor toolkit="swing" class="com.levigo.jadice.swing.internal.annotation.editors.RotationEditor"/>
	</unrestricted>
...


Sofern die Rotation manuell durch den Anwender verändert werden soll, kann zusätzlich der RotationEditor eingebunden werden.

Beispiel: Den Handle für freie Rotation anzeigen

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleAnzeigen des Rotation-Handles
<annotation-type name="Note" archetype="Note" extends="Text" class="com.levigo.jadice.annotation.TextAnnotation">
	<wrangler class="com.levigo.jadice.swing.internal.annotation.wranglers.TextAnnotationWrangler">
		<property name="showRotationHandle">true</property>
	</wrangler>
...


Diese Konfiguration wird nur benötigt, wenn - vergleichbar den Stempelannotationen - eine freie Drehung der Textannotationen durch den Benutzer erlaubt werden soll.

Beispiel: Textannotation immer lesbar erstellen

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleAnnotation immer lesbar erstellen
<annotation-type name="Note" archetype="Note" extends="Text" class="com.levigo.jadice.annotation.TextAnnotation">
	<wrangler class="com.levigo.jadice.swing.internal.annotation.wranglers.TextAnnotationWrangler">
		<property name="forceAnnotationUpRight">ON_CREATION</property>
	</wrangler>
...


Dies ist einer der häufigsten Anwendungsfälle. Auf einer gedrehten Seite sollen Textannotationen immer "aufrecht" (also ohne Kopfverdrehen lesbar) angebracht werden. 

Beispiel: Gesamte Textannotation mit allen hier beschriebenen Eigenschaften

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleGesamte Definition
<annotation-type name="Note" archetype="Note" extends="Text" class="com.levigo.jadice.annotation.TextAnnotation">
	<renderer class="com.levigo.jadice.annotation.internal.renderer.TextAnnotationRenderer">
		<property name="lineWrap">CHARACTER_CR</property>
	</renderer>
	<wrangler class="com.levigo.jadice.swing.internal.annotation.wranglers.TextAnnotationWrangler">
		<property name="forceAnnotationUpRight">ON_CREATION</property>
		<property name="showRotationHandle">true</property>
	</wrangler>
	<unrestricted name="rotation" propertyType="java.lang.Integer">
		<default>0</default>
		<editor toolkit="swing" class="com.levigo.jadice.swing.internal.annotation.editors.RotationEditor"/>
	</unrestricted>

	<labels>
		<label locale="en">Note</label>
		<label locale="de">Textnotiz</label>
	</labels>

	<unrestricted name="text" propertyType="java.lang.String">
		<default>Note-Annotation</default>
	</unrestricted>

	<color name="fillColor" allow-transparency="false">
		<labels>
			<label locale="en">Fill color</label>
			<label locale="de">Füllfarbe</label>
		</labels>
		<editor class="com.levigo.jadice.swing.internal.annotation.editors.ColorEditor">
			<property name="iconName">fillColor</property>
		</editor>

		<default>#ffff00</default>
		<preferred>#ff0000</preferred>
	</color>

	<color name="textColor" allow-transparency="false">
		<labels>
			<label locale="en">Text color</label>
			<label locale="de">Schriftfarbe</label>
		</labels>
		<editor class="com.levigo.jadice.swing.internal.annotation.editors.ColorEditor">
			<property name="iconName">textColor</property>
		</editor>
		<default>#000000</default>
		<preferred>#000000</preferred>

	</color>
</annotation-type>




Panel
borderColor#db4b1b
titleColor#ffffff
borderWidth2
titleBGColor#db4b1b
borderStylesolid

Beispiele für das jadice web toolkit

Beispiel: Einbinden der Rotation (nur jadice Annotationsformat)

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleDefinition der Rotation
<annotation-type name="Text" archetype="Text" extends="Rectangle" class="com.levigo.jadice.annotation.TextAnnotation">
	<unrestricted name="rotation" propertyType="java.lang.Integer">
		<default>0</default>
	</unrestricted>
...


Zum Speichern der Rotation relativ zum Dokument ist bei Nutzung des jadice-Annotationsformats in allen Anwendungsfällen die Konfiguration der Property "rotation" nötig. Bei ContentManager-Annotationen entfällt diese Konfiguration.

Beispiel: Den Handle für freie Rotation anzeigen

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleAnzeigen des Rotation-Handles
<annotation-type name="Note" archetype="Note" extends="Text" class="com.levigo.jadice.annotation.TextAnnotation">
	<wrangler toolkit="gwt" class="com.levigo.jadice.web.client.internal.annotation.wrangler.TextAnnotationWrangler">
		<property name="showRotationHandle">true</property>
	</wrangler>
...


Diese Konfiguration wird nur benötigt, wenn - vergleichbar den Stempelannotationen - eine freie Drehung der Textannotationen durch den Benutzer erlaubt werden soll.

Beispiel: Textannotation immer lesbar erstellen

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleAnnotation immer lesbar erstellen
<annotation-type name="Note" archetype="Note" extends="Text" class="com.levigo.jadice.annotation.TextAnnotation">
	<wrangler toolkit="gwt" class="com.levigo.jadice.web.client.internal.annotation.wrangler.TextAnnotationWrangler">
		<property name="forceAnnotationUpright">ON_CREATION</property>
	</wrangler>
...


Dies ist einer der häufigsten Anwendungsfälle. Auf einer gedrehten Seite sollen Textannotationen immer "aufrecht" (also ohne Kopfverdrehen lesbar) angebracht werden.