Versionen im Vergleich

Alte Version 18

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

und Verwendung des RotationEditors

(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. Sofern die Rotation manuell durch den Anwender verändert werden soll, kann zusätzlich der RotationEditor eingebunden werden Bei ContentManager-Annotationen entfällt diese Konfiguration.

Beispiel:

Den Handle für freie Rotation anzeigen

Verwendung des RotationEditors

Erweitern
titleCodebeispiel einblenden


Codeblock
languagexml
titleAnzeigen des Rotation-HandlesDefinition der Rotation und des Editors
<annotation-type name="NoteText" archetype="NoteText" extends="TextRectangle" class="com.levigo.jadice.annotation.TextAnnotation">
	<wrangler class="com.levigo.jadice.swing.internal.annotation.wranglers.TextAnnotationWrangler">
		<property <unrestricted name="showRotationHandlerotation">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 propertyType="java.lang.Integer">
		<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. 

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

Beispiele für das jadice web toolkit

Beispiel: Einbinden der Rotation 

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


Zum Speichern der Rotation relativ zum Dokument ist in allen Anwendungsfällen die Konfiguration der Property "rotation" nötig. 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 toolkit="gwt" class="com.levigo.jadice.webswing.client.internal.annotation.wranglerwranglers.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.clientswing.internal.annotation.wranglerwranglers.TextAnnotationWrangler">
		<property name="forceAnnotationUprightforceAnnotationUpRight">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.