Die Palette wird verwendet, um Text- und Bildalternativen für Platzhalter und Produkte zu zeigen. Hier ein Screenshot:

Mit Hilfe der Buttons der ersten Spalte können Platzhalterinhalte neu gesetzt werden. Dabei werden nicht, wie sonst üblich, die Platzhalter mit einem neuen Objekt verknüpft und dann neu geladen, sondern die Inhalte werden direkt ins Dokument geschrieben. Darüber hinaus können Sie Elemente mit Drag and Drop direkt in Rahmen und Texte ziehen und ablegen. Weitere Informationen finden Sie in den Tooltips der Palette.

Werden Templates in Texte eingesetzt, werden die Rahmen zuvor gruppiert und dann als ein Inline in den Text eingefügt. Wird beim Einsetzen von Templates in Texte die Alt-Taste gehalten, werden die Rahmen als einzelne Inlines eingefügt. Dabei wird die in der Palette Template-Verhalten festgelegte Reihenfolge verwendet.

Zum Einsetzen von Bildern werden die Einstellungen der Popupmenüs Bildposition und Skalierungverfahren oben rechts in der Palette verwendet. Bei gahaltener Alt-Taste beim werden vor dem Einfügen von Bildern die allgemeinen Importoptionen von InDesign® (Ebenen, Beschneidungspfade, Farbräume, ...) erfragt.

Beachten Sie, dass die so geänderten Platzhalter im Normalfall nicht mehr synchron mit den Inhalten der Datenbasis sind und Änderungen beim Aktualisieren der Platzhalter verloren gehen werden.

Mit kann die Listendarstellung zwischen kleinen und großen Einträgen umgeschaltet werden.

Die Suchmethoden werden in der Datenbanktabelle previewstatements bzw. in der Datei previewstatements.xml definiert und erscheinen in der dort festgelegten Reihenfolge oben links im Suchpopup der Palette. Suchmethoden können nach folgenden Kriterien klassifiziert werden:

• Unabhängig (needsselection == 0)
• Platzhalterabhängig (needsselection == 1) Immer wenn die aktuelle Dokumentauswahl den Platzhalter wechselt, wird die Palette aktualisiert. Auf die Platzhalterwerte kann bei der Suche zugegriffen werden. Es wird jeweils der erste Platzhalter der aktuellen Dokumentauswahl berücksichtigt. Die Palette wird nicht aktualisiert, wenn nur der Textcursor innerhalb eines Platzhaltertextes bewegt wird.
• Produktabhängig  (needsselection == 2) Jedesmal, wenn die Auswahl in der Produktrecherche verändert wird, wird die Suche neu ausgeführt. Auf die Produktauswahl kann beim Laden zugegriffen werden. Es wird jeweils das erste ausgewählte Produkt berücksichtigt. Beim Neuverknüpfen von Platzhaltern mit Shift-Klick der Buttons können Platzhalter geändert werden. Um zu verhindern, dass dann auch die Previewpalette aktualisiert wird, können Sie in der Produktrecherche mit die Auswahl festhalten.

Die Klassifizierung der Suchmethode wird im Attribut needsselection der PreviewStatements festgelegt (siehe folgende Tabelle). Für platzhalter- und produktabhängige Suchanweisungen wird vor der Suche Hilfe des Attributs condition (siehe unten) geprüft, ob die Suche überhaupt ausgeführt werden kann. Die dazu nötigen aktuellen Platzhalter- und Produktwerte sind in entsprechenden Suchparametern definiert.

Die Tabelle/Datei previewstatements muss folgende Attribute haben:

Hier ein Bespiel für eine gültige Definition in XML. Der Eintrag fügt einen Zeilentrenner in das Suchpopup ein. Dazu wird der Name auf "-" gesetzt. Damit der Eintrag überhaupt in das Popup aufgenommen wird, muss auch die objectstatementid gesetzt werden. Da nichts geladen werden soll, hier eine -1.

<previewstatements>
    <previewstatement>
        <id>50</id>
        <name>-</name>
        <classid>6</classid>
        <needsselection>0</needsselection>
        <condition></condition>
        <statement></statement>
        <objectstatementid>-1</objectstatementid>
        <sequencenr>50</sequencenr>
        <isdefault>0</isdefault>
        <hasButtonState>0</hasButtonState>
        <hasLinkScript>0</hasLinkScript>
    </previewstatement>
</previewstatements>

Suchanweisungen für XML und Datenbankverbindungen werden in zwei Schritten ausgeführt :

1. Suchen der Listen-IDs
2. über die objectstatementid wird der previewstatements-Eintrag zum Laden der Listeninhalte ermittelt und die einzelnen Listeneinträge werden geladen.

Suchanweisungen für PubServer und SOAP-Verbindungen werden in einem Schritt ausgeführt, der IDs und anzuzeigende Werte gleichzeitig abgeholt,

Mit zusätzliche Bedingungen kann die Ergebnisliste auf die Angaben der Suchfelder eingeschränkt werden.

Diese Anweisung wird nur bei XML und Datenbankverbindungen ausgeführt. Für SOAP- und PubServer Verbindungen siehe hier. Die Anweisung muss folgende Werte liefern :

Mit Alt-Click in das Suchpopup können Sie Einträge editieren.

Hier eine gültige XML-Anweisung zum Laden der IDs. Zur besseren Lesbarkeit sind die Anführungzeichen, > und < hier nicht XML-codiert. Wenn Sie den Anweisungstext direkt in eine XML-Datei einsetzen, müssen Sie direse Zeichen also noc h XML-kodieren.

"$FLOWERS"
select
    id, 0, 0, "", <!-- ID             -->
    3,            <!-- class          -->
    0, 0, 0, 0,   <!-- <key1>, ...    -->
    ""            <!-- <stringkey>    -->
node flowers.flower where id &gt; 0

Hier eine gültige SQL-Anweisung zum Laden der IDs. Alle Einträge der Tabelle comet_snippets_2 sollen in der Liste gezeigt werden.

select
    id, 0, 0, '', 3, 0, 0, 0, 0, '', 1, 1
from comet_snippets_2 where id > 0

[XML und Datenbankverbindungen] Die Listeneinträge werden mit Hilfe der Ergebnisse der ersten Suchanweisung einzeln geladen. Der Befehl muss einen ?-Wert enthalten, der durch die jeweilige id (also die erste Spalte der übergeordneten Suchanweisung) ersetzt wird. Werden weitere Werte der Listen-Ids benötigt, kann das über die üblichen Tags <ID2>, ... gemacht werden, siehe hier. Zusätzlich können die in der Listensuche definierten Werte <key1>, .., <key4> und <stringkey> abgefragt werden

[PubServer- und SOAP-Verbindungen] Die Listeneinträge werden inklusive ihrer IDs in einem Aufruf geladen. Der Aufruf enthält daher keinen '?'-Wert, mit dem die Listen-ID referenziert werden muß.

Der Wert der (gelb markierten) Ergebnisspalte Path bestimmt den Typ des Eintrages:

•     "" : Text
•     "snippet@:..." : Snippet
•     Sonst : Bild

Bitte beachten Sie, dass die Ergebnisspalten bis auf die letzten beiden Spalten vollständig sein müssen. Fehlende Einträge können mit 0 bzw. "" gefüllt werden.

Für Bilder können in der Ergebnisspalte Content Hinweise über die Positionierung, den Freistellpfad, etc. angegeben werden. Die Angaben entsprechen den Informationen, die auch in Bildplatzhaltern gegeben werden mit dem einzigen Unterschied, dass Freistellpfade immer über ihren Index und nicht über ihren Namen identifiziert werden müssen. Die Angaben müssen in folgendem Format (und ohne Kommas getrennt) gemacht werden :

Werden nur Defaultwerte verwendet, dürfen die Angaben auch fehlen. Gültige Positionierungsinfo wären also:

• "1" : Platziere das Bild oben links. Für alle anderen Einstellungen werden die Defaults verwendet.
• "5 0.0 0 4 1 0.0 0.0 10.0" Verwendet den Inset 10.0 Für alle anderen Einstellungen werden die Defaults verwendet.

Die hier beschriebenen Snippets sind unterschiedlich zu den mit Comet 4.0.5 eingeführten Comet-Snippets. Eine Beschreibung der Comet-Snippets finden Sie hier.

Hier einige Beispiele für Snippet-Defintionen:

Die beiden letzen Spalten SnippetTable und SnippetAttr der Anweisungen zum Laden der Preview-Einträge sind optional und werden nur bei Snippet-Einträgen ausgewertet. Sie enthalten in diesem Fall die Beschreibung, wo nach den Snippets gesucht werden soll. Fehlen die Angaben, werden automatisch "pageitems" und "data" verwendet.

Die Spalten geben den Unterordner im XML-Datenordner an, in dem sich die Snippets befinden. In diesem Unterordner befinden sich Snippets als Dateien unter ihrer ID. Folgende Formate werden unterstützt : INDD, INDS, IDMS.

Das Format kann im zweiten Unterordners als Zahl und durch Komma getrennt mitgegeben werden (1 INDD, 2 INDS, 3 IDMS). Fehlt die Formatangabe, werden INDDs erwartet.

"snippets", "data"  lädt für die Snippet-ID 4 die Datei:

xml-ordner/snippets/data/4.indd

Snippets im InDesign®-Snippet-Format IDMS : "snippets", "data, 3"  lädt für die Snippet-ID 4 die Datei:

xml-ordner/snippets/data/4.idms

Die Spalten geben Tabelle und Attribut (in dieser Reihenfolge) an, an der die Snippets abgelegt sind. Die Tabelle muss zudem das int-Attribut format haben. Dieses Attribut definiert das Format der Daten im BLOB (1 INDD, 2 INDS, 3 IDMS).

"snippets", "data" führt folgende Anweisung zum Laden des Snippets aus:

select data, format from snippets where id = 4;

Die ID des Snippets plus eine Dateiendung werden als SOAP-ID verwendet. Die beiden Spalten werden dieser SOAP-ID vorangestellt. Auch hier darf, wie bei XML, im zweiten Paramenter eine kommagetrennte Formatangabe gemacht werden (1 INDD, 2 INDS, 3 IDMS). Die Formatangabe wird nicht Teil der SOAP-ID.

"snippets", "data"  lädt für die Snippet-ID 4 das Objekt

snippets/data/4.indd

"snippets", "data, 3"  lädt für die Snippet-ID 4 das Objekt

snippets/data/4.idms

Hier für jeden Preview-Typ ein statement-Beispiel für XML-Offline. In allen drei Beipielen sind die Spalten ButtonState und LinkScript nicht enthalten, in der Defintion der Anweisungen in PreviewStatements müssen also die Attribute hasButtonState und hasLinkScript beide auf den Wert 0 gesetzt werden!

Zur besseren Lesbarkeit sind die Anführungzeichen hier nicht XML-codiert. Wenn Sie den Anweisungstext direkt in eine XML-Datei einsetzen, müssen Sie diese Zeichen also noch XML-konform kodieren.

"pageitems.xml"
select
    "Image Name",
    "$DESKTOP/Bilder/orange.jpg",
    "Image Format",
    400, 300, 360, 8,
    <!-- Omit ButtonState and LinkScript -->
    "",
    "",
    "",
    ""
node pageitems.pageitem where id = ?

Setzen Sie in den Spalten Format und ImageInfo1-4 leere Angaben ein, werden die entsprechenden Bildinformationen intern automatisch berechnet:

"pageitems.xml"
select
    "Image Name",
    "$DESKTOP/Bilder/orange.jpg",
    "",
    0 0 0 0,
    <!-- Omit ButtonState and LinkScript -->
    "",
    "",
    "",
    ""
node pageitems.pageitem where id = ?

"pageitems.xml"
select
    "Image Name",
    "snippet@",
    "",
    0, 0, 0, 0,
    <!-- Omit ButtonState and LinkScript -->
    "",
    "Column 1",
    "Column 2",
    "Text Content"
node pageitems.pageitem where id = ?

"pageitems.xml"
select
    "Text Name",
    "",
    "",
    0, 0, 0, 0,
    <!-- Omit ButtonState and LinkScript -->
    "",
    "Column 1",
    "",
    "%!TT&lt;cSsize:24.0&gt;Text Content"
node pageitems.pageitem where id = ?

Der Status des Laden-Buttons in den einzelnen Zeilen der Liste kann beim Laden der Listeneinträge definiert werden. Folgende Einstellungen sind möglich :

Ist nichts anderes angegeben, sind die Buttons sichtbar und aktiv. So schränken Sie die Verfügbarkeit der Buttons ein :

1. Erweitern Sie die Tabelle/Datei previewstatements um das int-Attribut hasButtonState. Unter SOAP und XML muss dabei jeder Knoten <previewstatement> das neue Attribut bekommen! Setzen Sie den Wert in allen Einträgen der Tabelle/Datei dabei auf 0.
2. Ändern Sie im gewünschten Objektstatement den Wert von hasButtonState auf 1.
3. Fügen Sie in die Spalte ButtonState Folgende Werte sind definiert :
4. • 0 : Unsichtbar
   • 1 : Inaktiv
   • 2 : Sichtbar und aktiv
5. Die Suchmethoden werden beim Verbinden mit dem Datenpool gelesen. Sie müssen sich daher jetzt einmal neu anmelden.

[Ab Version 3.1 R 1730, 5. Feb. 2010] Listeneinträge können auch mit Hilfe eines Skriptes geladen werden. In diesem Fall enthält das Attribut statement zum Laden einfach ein Skript.

Für Skripteinträge sind keine weiteren Previewstatements zum Füllen der einzelnen Listeneinträge nötig. Sie füllen die Listeneinträge direkt im Skript. Damit der Eintrag im Suchpopup erscheint, muss objectstatementid auf einen Wert ungleich 0 gesetzt werden.

Die Einträge, die in der Liste erscheinen sollen, werden in die globale Produktliste gProducts des Skriptes eingefügt. Achten Sie darauf, die einzelenen Einträge mit kGlobalStack zu erzeugen. Alle Angaben in den Einträgen werden wie bei den normalen Listen auch behandelt. Sie legen also z.B. Texteinträge dadurch an, dass Sie die Pfadangabe auf leer ("") setzen. Eine Beschreibung der definerten Werte für Previews finden Sie unter product::set.

Hier ein Beispiel:

#include "internal/types.h"
#include "internal/text.h"
#include "internal/products.h"
	
int create_preview (
		int			i1,
		int			i2,
		int			i3,
		char	*	s1,
		char	*	name,
		char	*	path,
		char	*	fmt,
		int			w, 
		int			h,
		int			res,
		int			depth,
		char	*	descr,
		char	*	info1,
		char	*	info2,
		char	*	info3,
		int			clid,
		int			del)
	{
	Product			p		= 0;
	
	p = product::alloc (kGlobalStack);
		
	product::set (p, kID, 					i1);
	product::set (p, kID2, 					i2);
	product::set (p, kID3, 					i3);
	product::set (p, kStringID, 			s1);
	product::set (p, kPreviewName, 			name);
	product::set (p, kPreviewPath, 			path);
	product::set (p, kPreviewFormat,		fmt);
	product::set (p, kPreviewWidth, 		w);
	product::set (p, kPreviewHeight, 		h);
	product::set (p, kPreviewResolution, 	res);
	product::set (p, kPreviewBitDepth,		depth);
	product::set (p, kPreviewTextName, 		descr);
	product::set (p, kPreviewInfo1, 		info1);
	product::set (p, kPreviewInfo2, 		info2);
	product::set (p, kPreviewText, 			info3);
	product::set (p, kPreviewClassID,		clid);
	product::set (p, kPreviewToDelete, 		del);
		
	productlist::append (gProducts, p);
		
	return 0;
}
	
int main ()
{
	Product		p;
		
	create_preview (
				2, 0, 0, "", 
				"Qualitätsarbeit", "$DESKTOP/12.idml", "", // Format leer!
				0, 0, 0, 0, 	
				"Bild1", "info-1", "info-2", "info-3",
				0, 0);
	
	create_preview (
				3, 0, 0, "", 
				"Tantarantana", "$DESKTOP/Bilder/tantarantana.jpg", "JPG",
				100, 200, 72, 8, 	
				"Bild1", "info-1", "info-2", "info-3",
				0, 0);
			
	create_preview (
				14, 0, 0, "", 
				"Ein Text", "", "",	// Pfad leer!
				0, 0, 0, 0, 
				"Textname", "Info1", "info2", "Und das ist der Text : <0x00FC>äöü",
				0, 0);
	
	create_preview (
				17, 0, 0, "", 
				"Kho Payam", "snippet@", "JPG",
				700, 800, 75, 64, 
				"Bild4", "info-10", "info-11", "info-12",
				0, 0);
		
	return 0;
}

Platzhalter- und produktabhängige Suchen fragen vor dem Auslösen der Suche, ob die Suche überhaupt ausgeführt werden soll. Dazu wird die Angabe condition geprüft. Der String muss eine gültige boolsche Bedingung enthalten. Die Bedingung wird lokal geprüft, darf also keine Datenbankanweisungen enthalten.

Hier eine gültige Bedingung. Die Bedingung testet, ob im Dokument ein Platzhalter ausgewählt ist und ob dieser Platzhalter ein Produkt ist. Näheres über die erlaubten Tags erfahren Sie hier.

    <selection.placeholder> > 0
and <selection.class> = 3

In den Anweisungen der Suchmethoden kann mit Hilfe üblichen Tags auf globale Werte der Umgebung zugegriffen werden. Beachten Sie aber, dass Sie nur auf Werte zugreifen können, die global definiert sind, also etwa der Wert von <page> undefiniert ist.

Für die platzhalterabhängige Suche (needsselection == 1) sind folgende zusätzliche Werte definiert. Die Tags enthalten jeweils die Werte des ersten gefundenen Platzhalters im Dokument. Die Tags können, soweit nicht anders angegeben, in allen Anweisungen zum Laden der Listen-IDs, Listeneinträge und Testen der Suchbedingung verwendet werden.

Für die produktabhängige Suche (needsselection == 2) sind folgende zusätzliche Werte definiert. Die Tags enthalten jeweils die Werte des ersten ausgewählten Produktes der Produktrecherche. Die Tags können, soweit nicht anders angegeben, in allen Anweisungen zum Laden der Listen-IDs, Listeneinträge und Testen der Suchbedingung verwendet werden.

[Ab v4.3 R35700] Alle für die Suchbedingungen definierten Tags können auch direkt in Skripten verwendet werden. Schreiben Sie dazu die Tags direkt und mit den spitzen Klammern in ihren Skripttext. Die Tags werden vor der Ausführung automatisch durch ihre Werte ersetzt.

Im Besipiel wird <product.id> vor der Ausführung automatisch durch die ID des ersten ausgewählten Produktes (oder 0) ersetzt.

if (<product.id> == 120)
{
	...
}

Die automatische Ersetzung der Tags geht natürlich nicht, wenn Sie den Text eines Tags, z.B. <product.id>, auch in einer anderen Bedeutung, z.B. als Textausgabe verwenden!

In Versionen vor v4.3 R35700 sind diese Tags in Skripten nicht definiert. Sie können die entsprechenden Informationen aber leicht mit Hilfe entsprechender cScript/Python-Funktionen ermitteln. Platzhalter-relevante Infos etwa erhalten Sie mit Hilfe der Funktionen textmodel::selection und placeholder::(s)get_value.

Ermittle die Produkt-ID plid des ersten ausgewählten Platzhalters im Dokument.

ItemRef		frame 	= item::alloc ();
ItemList	frames 	= itemlist::alloc ();
int			s, e;
int			plid = 0;
char		sid [5000];
		
textmodel::selection (&s, &e, frame, frames);
if (s < 0) frame	= itemlist::get (frames, frame, 0);
plid = placeholder::get_value (frame, "ID", s);
item::release (frame);
itemlist::release (frames);

Produkt-relevante Infos erhalten Sie etwa mit Hilfe der Funktionen stringlist::alloc (3, kSelected) oder productlist::get ("selected").

Ermittle die ID plid des ersten ausgewählten Eintrages der Produktrecherche.

#include "internal/panels.h"
		
StringList	sl = stringlist::alloc (kPanelProducts, kSelected);
int			plid = 0;

if (stringlist::length (sl) > 0)
{
	plid	= stringlist::getint (sl, 0, "ID");
}

[ab v3.3 R2660, 26. Sept. 2011] Die Ergebnisliste kann mit zwei Suchfeldern eingschränkt werden. Auf die Inhalte der Suchfelder kann wie folgt zugegriffen werden :

Die Suchfelder können anweisungsbezogen beschriftet werden. Dazu können Sie in den Definitionen der Previewstatements dem Namen des Eintrages die Namen der Suchfelder jeweils durch ## getrennt anfügen. Die einzelnen Namensteile werden jeweils übersetzt.

Hier eine XML-Definition eines Previewstatements mit eigenen Namen für die Suchfelder:

<id>1004</id>
    <name>Einige Templates (Script)##Namensanfang##ID kleiner</name>
    <classid>6</classid>
    <needsselection>0</needsselection>
    <condition></condition>
    <statement>...</statement>
    <sequencenr>0</sequencenr>
    <domain></domain>
    <isdefault>0</isdefault>
</previewstatement>

Die Einträge der Liste können auf Doppelklicks reagieren. Die auszuführenden Aktion wird wie folgt definiert :

1. Mit Hilfe des Panelstatements 97 wird dem Produkt eine Action-ID zugeordnet. Das Statement muss ein Integer liefern und kann bis zu vier Eingabewerte (int, int, int, varchar) haben, die durch die aktuelle Produkt-ID ersetzt werden. In der Anweisung ist zusätzlich zu den allgemein üblichen Tags wie <ID>, <ID2>, <folder> das Tag <depth> definiert, es enthält die (0-basierte) Schachtlungstiefe des Produktes.
2. Ist eine Aktionen-ID definiert (>0), wird die Aktion als Skript ausgeführt. Im Skript ist eine zusätzliche globale Variable gClicked definiert, die die 0-basierte Zeilennummer der Eintrages angibt.

Hier einige Beispiele von gültigen Panelstatements mit denen die Doppelklick-ID definiert werden kann.

select 900+<depth> from dual;

"datafiles.xml"                        -- beliebige XML-Datei
select 900+<depth>

select id%3 from ... where ID = ?       
select id%3 from ... where ID = <ID>   -- Die ?en sind optional

Und hier ein einfaches Doppelklick-Skript

int main ()
{
	showmessage ("Zeile %d, ID = %d",
			gClicked+1,
			gRecordID);
			
	return 1;
}

Nach dem Einfügen ins Dokument können die neuen Daten mit dem sog. Link-Skript nachbearbeitet werden. Sie können in diesem Skript beispielsweise die Objekt-ID des Zielplatzhalters neu setzen.

Das Link-Skript wird im Hilfetext der Einträge angegeben.

So definieren Sie ein Linkskript für einen Eintrag der Previewpalette.

1. Erweitern Sie previewstatements um das int-Feld hasLinkScript. Die Felder werden mit dem Wert 0 initialisiert.
   Bei XML-Dateien müssen Sie auf die Schreibweise achten und darauf, dass das Attribut in jedem Eitrag eingefügt wird.
   
   
2. In allen Anweisungen zum Laden der Listeneinträge, die ein Linkskript ausführen sollen, setzen Sie den Wert von hasLinkScript auf den Wert 1.
   
   
3. Das LinkSkript wird über die ID einer Aktion definiert. Diese ID wird in die Ergebnisspalte LinkScript der Anweisung eingetragen.
   
   Beachten Sie auch, wenn Sie den Ladenbutton deaktivieren oder unsichtbar machen, gibt es auch keine Situation, in der ihr Linkskript ausgeführt werden könnte.
   
   Werden die Listeneinträge mit Hilfe eines Skriptes geladen, können Sie das Linkskript mit folgender Anweisung setzen :
       product::set (your_entry, kPreviewLinkScript, your_action_id);
   
   
4. Definieren Sie Aktion, deren ID Sie im Punkt 3 übergeben haben. Mehr dazu im nächsten Absatz.

In den Linkskripten sind die folgenden globalen Variablen definiert:

Die Skripte für Text, Bild und Snippet unterscheiden sich im grundsätzlichen Aufbau ein wenig. Hier für jeden Fall ein Beispiel.

Ein Text wurde eingesetzt (nicht durch ein Snippet). Die ID des Previeweintrages soll danch als Objekt-ID verwendet werden. Zur Demonstration wird an den neuen Text noch ein weiterer Text angefügt.

Achtung : Im allgemeinen ist das so natürlich nicht ganz richtig. Die IDs der Previewliste sind normalerweise keine gültigen Objekt-IDs. In diesem Fall hätten Sie ja die Produktpalette verwenden können.

int main ()
{
	placeholder::link (
			gFrame,
			3,
			gRecordID, gRecordID2, gRecordID2,
			gStart, gLen,
			gRecordStringID);
	textmodel::append ("AAA");

	return 0;
}

Ein Bild wurde ersetzt. Vergrössere es rahmenfüllend und zentriere es.

int main ()
{
	frame::fit_image (gFrame, 1);
	frame::fit_image (gFrame, 5, 5);
	return 0;
}

Ein Snippet wurde eingesetzt. Wurde Text ersetzt (auch durch Inline-Rahmen), wird hinter dem neuen Text eine Markierung eingesetzt. Wurden Seitenrahmen eingesetzt, bekommen diese eine zufällige (aber jeweils gleiche) Farbe.

int main ()
{
	if (gSnippetLen >= 0)
	{
		textmodel::insert ("by action 905", gSnippetStart+gSnippetLen);
	}
	else if (gInsertedFrames)
	{
		itemlist::apply (
				frame::color_rgb,
				gInsertedFrames,
				0, random (255), random (255), random (255), -1, -1);
	}

	return 0;
}

[ab v4.0.5 R8410] Comet-Snippets sind InDesign®-kompatible Versionen aufgebauter Produkte. Sie können an beliebiger Stelle in Dokumente eingefügt werden. Comet4-Snippets können eindeutig zugeordnet werden in der Kombination der folgenden drei Angaben:

1. Dokument. Hat das Dokument eine PubServer-DocumentID, wird diese ID zur Unterscheidung der Dokumente verwendet, sonst wird der vollständige Dokumentpfad verwendet (oder, bei neuen Dokumenten, der Dokumentname).
2. Template
3. Produkt

Comet-Snippets können nicht über mehrere Seiten gehen. Beim Sichern von Snippets werden daher auch nur Produkte gesichert, die keine Fortsetzungen haben. Zum Anlegen und Löschen von Comet-Snippets verwenden Sie die Buttons +, •, x der Previews-Palette oder die Skriptbefehle productlist::create_snippets und productlist::remove_snippets.

Im Produktaufbau kann entschieden werden, ob Produkte jeweils neu aufgebaut werden sollen oder ob ein Comet4-Snippet verwendet werden soll. Beim Einfügen von Snippets werden keine Platzhalterdaten geladen und keine weitere Gestaltungsregeln ausgeführt.

Im Popupmenü der Suchmethoden befinden sich zwei Methoden zum Anzeigen der verfügbaren Comet-Snippets:

• Dokument-Snippets : Die Liste zeigt alle für das aktuelle Dokument verfügbaren Comet-Snippets. Die Snippet-Auswahl wird dabei wier folgt getroffen:
  • Hat das Dokument eine sog. PublicationPlanner-DokumentID, werden alle Snippest gezeigt, die für diese DokumentID verfügbar sind.
  • Sonst werden alle Snippets gezeigt, die den gleichen Dokumentpfad ud -name haben
• Produkt-Snippets : Die Liste zeigt alle Snippets, die die gleiche RecordId haben wie der erste ausgewählte Eintrag der Produktrecherche.

Die Menüs sind nur verfügbar, wenn die aktuelle Datenverbindung Comet-Snippets unterstützt (Mehr dazu siehe hier.)
Die Menüs werden immer ans Ende der Suchmethoden angefügt.

Mit der Checkbox an Dokumentauswahl/Produktauswahl anpassen können Sie das automatische Neuladen der Snippets unterdrücken.

Achtung: Die hier beschriebenen Snippets sind nicht identisch mit den oben beschriebenen Comet-Snippets.

Hier eine gültigeSQL-Anweisung zum Laden der Preview-IDs. Alle Einträge der Tabelle comet_snippets_2 sollen in der Liste gezeigt werden.

select
    id, 0, 0, '', 3, 0, 0, 0, 0, '', 1, 1
from comet_snippets_2 where id > 0

Passend zum zweiten Beispiel des Listenladens hier die Anweisung zum Laden der Snippeteinträge. Die Snippets werden nicht aus der Standardtabelle pageitems geladen, auch die IDs stammen nicht aus dieser Tabelle. Damit beim Einsetzen eines Snippets in ein Dokument die richtige Datendatei verwendet wird, müssen Tabelle (comet_snippets_2) und Attribut (data) der Datenquelle hier angegeben werden.

select
    name,
    "snippet@select preview from comet_snippets_2 where id = <ID>",
    "" ,
    CONVERT (rightPos-leftPos, UNSIGNED), CONVERT (bottomPos-topPos, UNSIGNED), 0, 0,
    2,  // hasButtonState der Listensuche auf 1 setzen!
    0,  // hasLinkState der Listensuche auf 1 setzen!
    "Info1", "Info2","info3" , "Snippetbeschr",
    "comet_snippets_2",
    "data"
from comet_snippets_2 where id = <ID>

Die Tabelle comet_snippets_2 muss mind. wie folgt definiert sein (mySQL) :

create table snippets
(
    ID         int(10),
    name       varchar (4000),     
    data       longblob,
    preview    longblob,
    format     int(10),
    leftPos    float(10,4),
    topPos     float(10,4),
    rightPos   float(10,4),
    bottomPos  float(10,4)
);

Und hier ein Beispielskript, wie die Tabelle comet_snippets_2 gefüllt werden könnte.

#include "internal/types.h"
			
int main ()
{
	Query		qu		= sql::query (sql::dbconnection ());
	long		id		= 0;
	char		path	[2000];
	ItemList	frames	= itemlist::selected ();
	Image		img		= 0;
	float		l, t, r, b;
	
	// create content
	strcpy (path, "$DESKTOP/aaa");
	itemlist::create_snippet (frames, path, 1);
	itemlist::bbox (frames, &l, &t, &r, &b);
	img = image::snapshot_frames (frames, 100);
	
	// next free comet_snippet idquery::send (qu, "select max(id) from comet_snippets_2");
	query::output (qu, kInt, &id);
	query::exec (qu);
	while (query::fetch (qu)) {}
	id = id + 1;
	
	// create the new entryquery::send (qu, "insert into comet_snippets_2 (ID, active, leftPos, topPos, rightPos, bottomPos) values (?, 3, ?, ?, ?, ?)");
	query::input (qu, kInt, id);
	query::input (qu, kFloat, l);
	query::input (qu, kFloat, t);
	query::input (qu, kFloat, r);
	query::input (qu, kFloat, b);
	query::exec (qu);
	
	// store snippet
	strcat (path, ".idms");
	query::send (qu, "update comet_snippets_2 set data = ?, preview = ?, format = 3 where ID = ?");
	query::input (qu, kBinfile, path, kCopyLocalFile, "PICT"); 
	query::input (qu, kImage, img);
	query::input (qu, kInt, id);
	query::exec (qu);
	
	// clean up
	query::close (qu);
	image::release (img);
	itemlist::release (frames);
	file::remove (path);
	
	return 0;
}

Bei der Anzeige von Bilddateien ohne Preview wird versucht, aus der angegebenen Datei ein für die Anzeigegröße passendes Preview zu erzeugen. Die Berechnung der Previews kann einige Zeit in Anspruch nehmen, deshalb werden einmal erzeugte Previews auf Ihrer Festplatte aufgehoben. Ändert sich die Originaldatei, wird das Preview automatisch neu berechnet. Die Previews werden in den Voreinstellungen des Benutzers abgelegt :

• Mac : /Users/your_name/Library/Preferences/Werk [2]
• Windows : C:\Dokumente und Einstellungen\your_name\Lokale Einstellungen\Anwendungsdaten\Werk [2]

Die Dateien und Ordner dieser Ablage dürfen gelöscht, aber nicht geändert werden. Mit Hilfe des Buttons können sie auch direkt über die Palette gelöscht werden.

Die Previewdateien enthalten, obwohl ihre Endung das vermuten lässt, keine gültigen Bilddateien des jeweiligen Bildformates und können nicht mit anderen Grafikprogrammen geöffnet werden. Das Format dieser Dateien ist wie folgt (und die eigentlichen Bilddaten des Previews beginnen erst beim letzten Eintrag der Formatbeschreibung):