PDF-form creation using pdflatex, hyperref and insdljs. Dirk Krause February 7, 2008

Transcription

1 PDF-form creation using pdflatex, hyperref and insdljs Dirk Krause February 7,

2 Contents 1 Introduction Copyright Purpose of this tutorial hyperref and PDF forms 5 3 Before we start Document preamble Document class Fonts Page layout Graphics and colors hyperref-package Form element attributes The first form Goal First attempt: ex Aligning elements in a table: ex Spaces and element widths: ex Label text position: ex Colors: ex JavaScript: ex Document events: ex0008 and ex Form element events: ex Editable choice list: ex Adding help Overview PDF annotations Tooltips Another form Goal Initializing a choice list using JavaScript: ex Form number three: Interactive application Goal Processing button click events: ex Form number four: using both insdljs and inputenc 54 A History 57 2

3 B GNU Free Documentation License 58 B.1 APPLICABILITY AND DEFINITIONS B.2 VERBATIM COPYING B.3 COPYING IN QUANTITY B.4 MODIFICATIONS B.5 COMBINING DOCUMENTS B.6 COLLECTIONS OF DOCUMENTS B.7 AGGREGATION WITH INDEPENDENT WORKS B.8 TRANSLATION B.9 TERMINATION B.10 FUTURE REVISIONS OF THIS LICENSE

4 1 Introduction 1.1 Copyright Copyright (c) 2007 Dirk Krause Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover Texts, and with no Back-Cover Texts. A copy of the license is included in the appendix in a section named GNU Free Documentation License. 1.2 Purpose of this tutorial This tutorial shows how to create PDF forms using pdflatex, hyperref and insdljs. The focus is set on forms which are filled interactively on screen and printed. You need a LATEX distribution, pdflatex, hyperref and insdljs must be installed. The insdljs package is a part of the AcroTeX Education Bundle, see You should have the following additional documentation available: the hyperref manual: [RO04], guides, specifications and references for Acrobat JavaScript: [Sup03], [ADS05a] and [ADS05b] and the PDF file format reference: [ASI01]. This tutorial shows three examples, the first one is developed step-by-step. The final versions of the forms are ex0011, ex0101 and ex

5 2 hyperref and PDF forms The hyperref package provides environments and macros to create forms. The form elements must be placed in a Form environment, Form environments are limited to one Form environment per document. The following macros can be used to create form elements: \TextField[Parameter]{Text} creates a text field. \CheckBox[Parameter]{Text} creates a check box. \ChoiceMenu[Parameter]{Text}{Auswahl-Optionen} creates a choice list. \PushButton[Parameter]{Text} creates a button. \Submit[Parameter]{Text} creates a Submit-Button. Pushing the button sends form data to the URL specified as action-parameter in the Form environment. \Reset[Parameter]{Text} creates a Reset-button. The hyperref documentation [RO04] provides a more detailed description of the Form environment and the macros above. 5

6 3 Before we start 3.1 Document preamble Document class The usual document classes i. e. scrartcl or article can be used to create forms Fonts The PDF standard requires each PDF viewer to render 14 fonts even if the font is not embedded into the PDF file, especially the font families Times, Helvetica and Courier. JavaScript code can be used to change form field fonts to these fonts. We want to use JavaScript to change fonts, so we load the font setup packages using 1 \ u s e p a c k a g e { mathptmx } 2 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 3 \ u s e p a c k a g e { c o u r i e r } Additionally we use 1 \ u s e p a c k a g e [ T1 ] { f o n t e n c } to change the font encoding from OT1 (LATEX default) to T1. The default family is switched to Helvetica using 1 \ renewcommand * { \ f a m i l y d e f a u l t } { \ phv } because sans-serif fonts are better readable on screen than serifed fonts Page layout The page margins are set up by: 1 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } Page header and footer are set up by: 1 \ u s e p a c k a g e { f a n c y h d r } 2 \ l h e a d { Firma ABC} \ chead { } \ r h e a d { A b t e i l u n g XYZ} 3 \ l f o o t { } \ c f o o t { } \ r f o o t {} 4 \ p a g e s t y l e { f a n c y } Graphics and colors The packages 1 \ u s e p a c k a g e { g r a p h i c x } 2 \ u s e p a c k a g e { c o l o r } can be used to add graphics (i. e. logos) and colors. 6

7 3.1.5 hyperref-package The hyperref package is used: 1 \ u s e p a c k a g e [ 2 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 3 p d f t i t l e ={Key form }, 4 p d f s u b j e c t ={Key }, 5 p d f a u t h o r ={ F r o n t of House Manager }, 6 pdfpagemode=usenone, p d f s t a r t v i e w =FitH, p d f h i g h l i g h t ={/N} 7 ] { h y p e r r e f } 7

8 3.2 Form element attributes I recommend to set form elements colors and fonts as shown in table 1. Table 1: Form element colors and fonts Border color Fill color Font weight Screen colored colored bold Printout black white regular Screen and Printout 1 colored white regular All form elements should be marked fully colored when shown on screen so users can find all elements easily. For readability we choose a bold font to show text on a colored background. Printouts of forms are typically done on black-and-white printers. On printout we want a black border and white filling for form elements. The text is black on white now, so we do not need a bold font. JavaScript must be enabled in the PDF viewer to change colors and fonts before and after printing the document. The color for marking form elements should be the same color for all elements. We want to show black text on color-filled areas, so we should use a light color for a good contrast. 1 if JavaScript is deactivated 8

9 4 The first form 4.1 Goal We want to design a form which can be used to request keys for new empolyees. The following data is needed: First name and name, Department, Employment time (unlimited or limited from... until... ), the doors to open. Text fields are used for first name and name. Department and employment time are choosen from a list. The doors are selected in check boxes. 4.2 First attempt: ex0001 The ex0001.tex file shows a first attempt to create the form. 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ l a t i n 1 ] { i n p u t e n c } 3 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 4 \ u s e p a c k a g e { textcomp } 5 \ u s e p a c k a g e { mathptmx } 6 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 7 \ u s e p a c k a g e { c o u r i e r } 8 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 9 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 10 \ u s e p a c k a g e { f a n c y h d r } 11 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 12 \ l f o o t { } \ c f o o t { } \ r f o o t {} 13 \ p a g e s t y l e { f a n c y } 14 \ u s e p a c k a g e { g r a p h i c x } 15 \ u s e p a c k a g e { c o l o r } 16 \ u s e p a c k a g e [ 17 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 18 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 19 p d f a u t h o r ={ i c h }, pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 20 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ b e g i n { document } 23 \ s e c t i o n *{ Request f o r a key } 24 \ b e g i n {Form} 9

10 25 \ t e x t b f { Employee } \ \ 26 F i r s t name : \ T e x t F i e l d [ name=vorname ] { } \ \ 27 Name : \ T e x t F i e l d [ name=name ] { } \ \ 28 Department : \ ChoiceMenu [ name= a b t ]{}{% 29 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 30 \ t e x t b f {Time } \ \ 31 Time : \ ChoiceMenu [ name= z e i t ]{}{% 32 l i m i t e d =b, u n l i m i t e d =u } \ \ 33 from : \ T e x t F i e l d [ name=from ] { } \ \ 34 u n t i l : \ T e x t F i e l d [ name= u n t i l ] { } \ \ 35 \ t e x t b f { Doors } \ \ 36 F r o n t door : \ CheckBox [ name= h t ] { } \ \ 37 Ground f l o o r : \ CheckBox [ name=e1 ] { } \ \ 38 F i r s t f l o o r : \ CheckBox [ name=e2 ] { } \ \ 39 \ end {Form} 40 \ end { document } After running 1 p d f l a t e x ex0001 && p d f l a t e x ex0001 we can open ex0001.pdf in the PDF viewer. The form does not look good but contains the required functionality. The source shows: A unique name (identifier) is assigned to each form element using the name parameter. The last argument of the \ChoiceMenu[]{}{} macro is a list containing the available choices. Each list entry contains the full text to show and an abbreviation, separated by =. 10

11 4.3 Aligning elements in a table: ex0002 We use a tabular environment to align the form elements in a table. 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ l a t i n 1 ] { i n p u t e n c } 3 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 4 \ u s e p a c k a g e { textcomp } 5 \ u s e p a c k a g e { mathptmx } 6 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 7 \ u s e p a c k a g e { c o u r i e r } 8 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 9 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 10 \ u s e p a c k a g e { f a n c y h d r } 11 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 12 \ l f o o t { } \ c f o o t { } \ r f o o t {} 13 \ p a g e s t y l e { f a n c y } 14 \ u s e p a c k a g e { g r a p h i c x } 15 \ u s e p a c k a g e { c o l o r } 16 \ u s e p a c k a g e [ 17 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 18 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 19 p d f a u t h o r ={ i c h }, pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 20 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ b e g i n { document } 23 \ s e c t i o n *{ Request f o r a key } 24 \ b e g i n {Form} 25 \ b e g i n { t a b u l a r } { r l } 26 \ h l i n e 27 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Employee } } \ \ 28 F i r s t name:&% 29 \ T e x t F i e l d [ name=vorname ] { } \ \ 30 Name:&% 31 \ T e x t F i e l d [ name=name ] { } \ \ 32 Department:&% 33 \ ChoiceMenu [ name= a b t ]{}{% 34 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 35 \ h l i n e 36 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {Time } } \ \ 37 Time:&% 38 \ ChoiceMenu [ name= z e i t ]{}{% 39 l i m i t e d =b, u n l i m i t e d =u } \ \ 40 from:&% 41 \ T e x t F i e l d [ name=from ] { } \ \ 11

12 42 u n t i l :&% 43 \ T e x t F i e l d [ name= u n t i l ] { } \ \ 44 \ h l i n e 45 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Doors } } \ \ 46 F r o n t door:&% 47 \ CheckBox [ name=ht, width =1.2em ] { } \ \ 48 Ground f l o o r :&% 49 \ CheckBox [ name=e1, width =1.2em ] { } \ \ 50 F i r s t f l o o r :&% 51 \ CheckBox [ name=e2, width =1.2em ] { } \ \ 52 \ h l i n e 53 \ end { t a b u l a r } 54 \ end {Form} 55 \ end { document } 12

13 4.4 Spaces and element widths: ex0003 We use 1 &&\\*[ 0.9em ] to add vertical space between the table lines. In the last table line we use 1 &&\\* In the ChoiceMenu we set the popdown=true parameter to establish popdown-behaviour. The parameter width=20em parameter sets the horizontal size. 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ l a t i n 1 ] { i n p u t e n c } 3 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 4 \ u s e p a c k a g e { textcomp } 5 \ u s e p a c k a g e { mathptmx } 6 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 7 \ u s e p a c k a g e { c o u r i e r } 8 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 9 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 10 \ u s e p a c k a g e { f a n c y h d r } 11 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 12 \ l f o o t { } \ c f o o t { } \ r f o o t {} 13 \ p a g e s t y l e { f a n c y } 14 \ u s e p a c k a g e { g r a p h i c x } 15 \ u s e p a c k a g e { c o l o r } 16 \ u s e p a c k a g e [ 17 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 18 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 19 p d f a u t h o r ={ i c h }, pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 20 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ b e g i n { document } 23 \ s e c t i o n *{ Request f o r a key } 24 \ b e g i n {Form} 25 \ b e g i n { t a b u l a r } { r l } 26 \ h l i n e 27 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Employee } } \ \ 28 &\\*[ 0.9em ] F i r s t name:&% 29 \ T e x t F i e l d [ name=vorname, width =20em ] { } \ \ 30 &\\*[ 0.9em ] Name:&% 31 \ T e x t F i e l d [ name=name, width =20em ] { } \ \ 32 &\\*[ 0.9em ] Department:&% 33 \ ChoiceMenu [ { } = { }, name= abt, width =20em, popdown= t r u e ]{}{% 34 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 13

14 35 &\\*[ 0.9em ] \ h l i n e 36 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {Time } } \ \ 37 &\\*[ 0.9em ] Time:&% 38 \ ChoiceMenu [ name= z e i t, width =20em, popdown= t r u e ]{}{% 39 l i m i t e d =b, u n l i m i t e d =u } \ \ 40 &\\*[ 0.9em ] from:&% 41 \ T e x t F i e l d [ name=from, width =10em ] { } \ \ 42 &\\*[ 0.9em ] u n t i l :&% 43 \ T e x t F i e l d [ name= u n t i l, width =10em ] { } \ \ 44 &\\*[ 0.9em ] \ h l i n e 45 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Doors } } \ \ 46 &\\*[ 0.9em ] F r o n t door:&% 47 \ CheckBox [ name=ht, width =1.2em ] { } \ \ 48 &\\*[ 0.9em ] Ground f l o o r :&% 49 \ CheckBox [ name=e1, width =1.2em ] { } \ \ 50 &\\*[ 0.9em ] F i r s t f l o o r :&% 51 \ CheckBox [ name=e2, width =1.2em ] { } \ \ 52 &\\ 53 \ h l i n e 54 \ end { t a b u l a r } 55 \ end {Form} 56 \ end { document } 14

15 4.5 Label text position: ex0004 The y-position of form element texts and label texts differ because the form elements have an inner and outer border. We use text fields to show the labels and make the borders invisible. So label text and form element text is at the same y-position now. We create a white border for the labels 1 b o r d e r c o l o r ={1 1 1} and set text alignment to right-aligned: 1 a l i g n =2 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ l a t i n 1 ] { i n p u t e n c } 3 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 4 \ u s e p a c k a g e { textcomp } 5 \ u s e p a c k a g e { mathptmx } 6 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 7 \ u s e p a c k a g e { c o u r i e r } 8 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 9 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 10 \ u s e p a c k a g e { f a n c y h d r } 11 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 12 \ l f o o t { } \ c f o o t { } \ r f o o t {} 13 \ p a g e s t y l e { f a n c y } 14 \ u s e p a c k a g e { g r a p h i c x } 15 \ u s e p a c k a g e { c o l o r } 16 \ u s e p a c k a g e [ 17 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 18 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 19 p d f a u t h o r ={ i c h }, pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 20 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ newcommand { \ t e x t f o r l a b e l }[2]{% 23 \ T e x t F i e l d [ name ={#1}, v a l u e ={#2}, width =7em,% 24 a l i g n =2, b o r d e r c o l o r ={1 1 1}, r e a d o n l y = t r u e ]{}% 25 } 26 \ b e g i n { document } 27 \ s e c t i o n *{ Request f o r a key } 28 \ b e g i n {Form} 29 \ b e g i n { t a b u l a r } { r l } 30 \ h l i n e &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Employee } } \ \ &\\*[ 0.9em ] \ t e x t f o r l a b e l { vn }{ F i r s t name:}&% 15

16 33 \ T e x t F i e l d [ name=vorname, width =20em ] { } \ \ 34 &\\*[ 0.9em ] \ t e x t f o r l a b e l { nn }{Name:}&% 35 \ T e x t F i e l d [ name=name, width =20em ] { } \ \ 36 &\\*[ 0.9em ] \ t e x t f o r l a b e l { ab }{ Department:}&% 37 \ ChoiceMenu [ name= abt, width =20em, popdown= t r u e, v a l u e =v]{}{% 38 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 39 &\\*[ 0.9em ] \ h l i n e 40 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {Time } } \ \ 41 &\\*[ 0.9em ] \ t e x t f o r l a b e l { z }{ Time:}&% 42 \ ChoiceMenu [ name= z e i t, width =20em, popdown= t r u e, v a l u e =u]{}{% 43 u n l i m i t e d =u, l i m i t e d =b } \ \ 44 &\\*[ 0.9em ] \ t e x t f o r l a b e l {v }{ from:}&% 45 \ T e x t F i e l d [ name=from, width =10em ] { } \ \ 46 &\\*[ 0.9em ] \ t e x t f o r l a b e l {b }{ u n t i l :}&% 47 \ T e x t F i e l d [ name= u n t i l, width =10em ] { } \ \ 48 &\\*[ 0.9em ] \ h l i n e 49 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Doors } } \ \ 50 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t h }{ F r o n t door:}&% 51 \ CheckBox [ name=ht, width =1.2em ] { } \ \ 52 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 1 }{ Ground f l o o r :}&% 53 \ CheckBox [ name=e1, width =1.2em ] { } \ \ 54 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 2 }{ F i r s t f l o o r :}&% 55 \ CheckBox [ name=e2, width =1.2em ] { } \ \ 56 &\\ 57 \ h l i n e 58 \ end { t a b u l a r } 59 \ end {Form} 60 \ end { document } 16

17 4.6 Colors: ex0005 We use 1 b o r d e r c o l o r ={ } to change the border color to light blue for the form elements. 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ l a t i n 1 ] { i n p u t e n c } 3 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 4 \ u s e p a c k a g e { textcomp } 5 \ u s e p a c k a g e { mathptmx } 6 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 7 \ u s e p a c k a g e { c o u r i e r } 8 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 9 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 10 \ u s e p a c k a g e { f a n c y h d r } 11 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 12 \ l f o o t { } \ c f o o t { } \ r f o o t {} 13 \ p a g e s t y l e { f a n c y } 14 \ u s e p a c k a g e { g r a p h i c x } 15 \ u s e p a c k a g e { c o l o r } 16 \ u s e p a c k a g e [ 17 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 18 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 19 p d f a u t h o r ={ i c h }, 20 pdfpagemode=usenone, p d f s t a r t v i e w =FitH, p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ newcommand { \ t e x t f o r l a b e l }[2]{% 23 \ T e x t F i e l d [ name ={#1}, v a l u e ={#2}, width =7em, a l i g n =2,% 24 b o r d e r c o l o r ={1 1 1}, r e a d o n l y = t r u e ]{}% 25 } 26 \ b e g i n { document } 27 \ s e c t i o n *{ Request f o r a key } 28 \ b e g i n {Form} 29 \ b e g i n { t a b u l a r } { r l } 30 \ h l i n e 31 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Employee } } \ \ 32 &\\*[ 0.9em ] \ t e x t f o r l a b e l { vn }{ F i r s t name:}&% 33 \ T e x t F i e l d [ name=vorname, width =20em,% 34 b o r d e r c o l o r ={ } ] { } \ \ 35 &\\*[ 0.9em ] \ t e x t f o r l a b e l { nn }{Name:}&% 36 \ T e x t F i e l d [ name=name, width =20em,% 37 b o r d e r c o l o r ={ } ] { } \ \ 38 &\\*[ 0.9em ] \ t e x t f o r l a b e l { ab }{ Department:}&% 17

18 39 \ ChoiceMenu [ name= abt, width =20em, popdown= t r u e, v a l u e =v,% 40 b o r d e r c o l o r ={ }]{}{% 41 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 42 &\\*[ 0.9em ] \ h l i n e 43 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {Time } } \ \ 44 &\\*[ 0.9em ] \ t e x t f o r l a b e l { z }{ Time:}&% 45 \ ChoiceMenu [ name= z e i t, width =20em, popdown= t r u e, v a l u e =u,% 46 b o r d e r c o l o r ={ }]{}{% 47 u n l i m i t e d =u, l i m i t e d =b } \ \ 48 &\\*[ 0.9em ] \ t e x t f o r l a b e l {v }{ from:}&% 49 \ T e x t F i e l d [ name=from, width =10em,% 50 b o r d e r c o l o r ={ } ] { } \ \ 51 &\\*[ 0.9em ] \ t e x t f o r l a b e l {b }{ u n t i l :}&% 52 \ T e x t F i e l d [ name= u n t i l, width =10em,% 53 b o r d e r c o l o r ={ } ] { } \ \ 54 &\\*[ 0.9em ] \ h l i n e 55 &\\*[ 0.9em ] \ multicolumn { 2 } { c }{% 56 \ t e x t b f { Doors } } \ \ 57 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t h }{ F r o n t door:}&% 58 \ CheckBox [ name=ht, width =1.2em,% 59 b o r d e r c o l o r ={ } ] { } \ \ 60 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 1 }{ Ground f l o o r :}&% 61 \ CheckBox [ name=e1, width =1.2em,% 62 b o r d e r c o l o r ={ } ] { } \ \ 63 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 2 }{ F i r s t f l o o r :}&% 64 \ CheckBox [ name=e2, width =1.2em,% 65 b o r d e r c o l o r ={ } ] { } \ \ 66 &\\ 67 \ h l i n e 68 \ end { t a b u l a r } 69 \ end {Form} 70 \ end { document } 18

19 4.7 JavaScript: ex0006 The insdljs package is used to add document level JavaScript. The package requires to specify the output driver. 1 \ u s e p a c k a g e [ p d f t e x ] { i n s d l j s } The JavaScript-code to add is placed in an insdljs environment. The optional argument and the first required argument must be LATEX identifiers (use a string containing characters only, no numbers). The second required argument is a comment 1 \ b e g i n { insdljs } [ e x a a a a ] { e xaaaa }{ Document Level J a v a S c r i p t } 2 / /... P l a c e J ava s o u r c e code h e r e... 3 \ end { insdljs } The identifier is used to build a file name ( exaaaa.djs ) to temporarily store the packed Java- Script code. The OpenAction{} macro specifies a function which is executed when the document is opened. 1 \ OpenAction { / S / J a v a S c r i p t / JS ( m y F i r s t J a v a S c r i p t F u n c t i o n ( ) ; ) } The JavaScript-code is enclosed in brackets. The example code contains a function invokation. The function may be invoked multiple times (each time one navigates to page 1). We use a variable as a flag indicating whether the function is run for the first time or not. 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ l a t i n 1 ] { i n p u t e n c } 3 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 4 \ u s e p a c k a g e { textcomp } 5 \ u s e p a c k a g e { mathptmx } 6 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 7 \ u s e p a c k a g e { c o u r i e r } 8 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 9 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 10 \ u s e p a c k a g e { f a n c y h d r } 11 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 12 \ l f o o t { } \ c f o o t { } \ r f o o t {} 13 \ p a g e s t y l e { f a n c y } 14 \ u s e p a c k a g e { g r a p h i c x } 15 \ u s e p a c k a g e { c o l o r } 16 \ u s e p a c k a g e [ 17 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 18 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 19 p d f a u t h o r ={ i c h }, 20 pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 21 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 22 ] { h y p e r r e f } 19

20 23 \ u s e p a c k a g e [ p d f t e x ] { i n s d l j s } 24 \ b e g i n { insdljs } [ e x a a a a ] { e xaaaa }{ Document Level J a v a S c r i p t } / / i n d i c a t e t h a t t h e f u n c t i o n was n o t y e t run 27 v a r done = 0 ; / / f u n c t i o n t o run when opening t h e document 30 f u n c t i o n m y F i r s t J a v a S c r i p t F u n c t i o n ( ) 31 { 32 i f (! done ) { 33 done = 1 ; 34 app. a l e r t ( " The form was opened. " ) ; 35 } 36 } 37 \ end { insdljs } 38 \ OpenAction { / S / J a v a S c r i p t / JS ( m y F i r s t J a v a S c r i p t F u n c t i o n ( ) ; ) } 39 \ newcommand { \ t e x t f o r l a b e l }[2]{% 40 \ T e x t F i e l d [ name ={#1}, v a l u e ={#2}, width =7em, a l i g n =2,% 41 b o r d e r c o l o r ={1 1 1}, r e a d o n l y = t r u e ]{}% 42 } 43 \ b e g i n { document } 44 \ s e c t i o n *{ Request f o r a key } 45 \ b e g i n {Form} 46 \ b e g i n { t a b u l a r } { r l } 47 \ h l i n e 48 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Employee } } \ \ 49 &\\*[ 0.9em ] \ t e x t f o r l a b e l { vn }{ F i r s t name:}&% 50 \ T e x t F i e l d [ name=vorname, width =20em,% 51 b o r d e r c o l o r ={ } ] { } \ \ 52 &\\*[ 0.9em ] \ t e x t f o r l a b e l { nn }{Name:}&% 53 \ T e x t F i e l d [ name=name, width =20em,% 54 b o r d e r c o l o r ={ } ] { } \ \ 55 &\\*[ 0.9em ] \ t e x t f o r l a b e l { ab }{ Department:}&% 56 \ ChoiceMenu [ name= abt, width =20em, popdown= t r u e, v a l u e =v,% 57 b o r d e r c o l o r ={ }]{}{% 58 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 59 &\\*[ 0.9em ] \ h l i n e 60 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {Time } } \ \ 61 &\\*[ 0.9em ] \ t e x t f o r l a b e l { z }{ Time:}&% 62 \ ChoiceMenu [ name= z e i t, width =20em, popdown= t r u e, v a l u e =u,% 63 b o r d e r c o l o r ={ }]{}{% 64 u n l i m i t e d =u, l i m i t e d =b } \ \ 65 &\\*[ 0.9em ] \ t e x t f o r l a b e l {v }{ from:}&% 66 \ T e x t F i e l d [ name=from, width =10em,% 20

21 67 b o r d e r c o l o r ={ } ] { } \ \ 68 &\\*[ 0.9em ] \ t e x t f o r l a b e l {b }{ u n t i l :}&% 69 \ T e x t F i e l d [ name= u n t i l, width =10em,% 70 b o r d e r c o l o r ={ } ] { } \ \ 71 &\\*[ 0.9em ] \ h l i n e 72 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {% 73 Doors } } \ \ 74 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t h }{ F r o n t door:}&% 75 \ CheckBox [ name=ht, width =1.2em,% 76 b o r d e r c o l o r ={ } ] { } \ \ 77 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 1 }{ Ground f l o o r :}&% 78 \ CheckBox [ name=e1, width =1.2em,% 79 b o r d e r c o l o r ={ } ] { } \ \ 80 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 2 }{ F i r s t f l o o r :}&% 81 \ CheckBox [ name=e2, width =1.2em,% 82 b o r d e r c o l o r ={ } ] { } \ \ 83 &\\ 84 \ h l i n e 85 \ end { t a b u l a r } 86 \ end {Form} 87 \ end { document } A message box is shown when the document is opened. In the german version the character ö is malformed to o because the inputenc package replaces german umlauts (and other characters) by the corresponding LATEX code sequence. There are two ways to solve the problem: Remove the inputenc package and convert german umlauts to their LATEX code sequence manually (shown in the listing below at the end of this section) or use JavaScript-Unicode notation for umlauts in JavaScript instead of typing the umlauts directly (shown in section 7 on page 54). 1 \ u s e p a c k a g e [ l a t i n 1 ] { i n p u t e n c } from our source. 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 3 \ u s e p a c k a g e { textcomp } 4 \ u s e p a c k a g e { mathptmx } 5 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 6 \ u s e p a c k a g e { c o u r i e r } 7 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 8 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 9 \ u s e p a c k a g e { f a n c y h d r } 10 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 21

22 11 \ l f o o t { } \ c f o o t { } \ r f o o t {} 12 \ p a g e s t y l e { f a n c y } 13 \ u s e p a c k a g e { g r a p h i c x } 14 \ u s e p a c k a g e { c o l o r } 15 \ u s e p a c k a g e [ 16 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 17 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 18 p d f a u t h o r ={ i c h }, 19 pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 20 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ u s e p a c k a g e [ p d f t e x ] { i n s d l j s } 23 \ b e g i n { insdljs } [ exaaab ] { exaaab }{ Document Level J a v a S c r i p t } / / i n d i c a t e t h a t t h e f u n c t i o n was n o t y e t run 26 v a r done = 0 ; / / f u n c t i o n t o run when opening t h e document 29 f u n c t i o n m y F i r s t J a v a S c r i p t F u n c t i o n ( ) 30 { 31 i f (! done ) { 32 done = 1 ; 33 app. a l e r t ( " The form was opened. " ) ; 34 } 35 } 36 \ end { insdljs } 37 \ OpenAction { / S / J a v a S c r i p t / JS ( m y F i r s t J a v a S c r i p t F u n c t i o n ( ) ; ) } 38 \ newcommand { \ t e x t f o r l a b e l }[2]{% 39 \ T e x t F i e l d [ name ={#1}, v a l u e ={#2}, width =7em, a l i g n =2,% 40 b o r d e r c o l o r ={1 1 1}, r e a d o n l y = t r u e ]{}% 41 } 42 \ b e g i n { document } 43 \ s e c t i o n *{ Request f o r a key } 44 \ b e g i n {Form} 45 \ b e g i n { t a b u l a r } { r l } 46 \ h l i n e 47 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Employee } } \ \ 48 &\\*[ 0.9em ] \ t e x t f o r l a b e l { vn }{ F i r s t name:}&% 49 \ T e x t F i e l d [ name=vorname, width =20em,% 50 b o r d e r c o l o r ={ } ] { } \ \ 51 &\\*[ 0.9em ] \ t e x t f o r l a b e l { nn }{Name:}&% 52 \ T e x t F i e l d [ name=name, width =20em,% 53 b o r d e r c o l o r ={ } ] { } \ \ 54 &\\*[ 0.9em ] \ t e x t f o r l a b e l { ab }{ Department:}&% 22

23 55 \ ChoiceMenu [ name= abt, width =20em, popdown= t r u e, v a l u e =v,% 56 b o r d e r c o l o r ={ }]{}{% 57 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 58 &\\*[ 0.9em ] \ h l i n e 59 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {Time } } \ \ 60 &\\*[ 0.9em ] \ t e x t f o r l a b e l { z }{ Time:}&% 61 \ ChoiceMenu [ name= z e i t, width =20em, popdown= t r u e, v a l u e =u,% 62 b o r d e r c o l o r ={ }]{}{% 63 u n l i m i t e d =u, l i m i t e d =b } \ \ 64 &\\*[ 0.9em ] \ t e x t f o r l a b e l {v }{ from:}&% 65 \ T e x t F i e l d [ name=from, width =10em,% 66 b o r d e r c o l o r ={ } ] { } \ \ 67 &\\*[ 0.9em ] \ t e x t f o r l a b e l {b }{ u n t i l :}&% 68 \ T e x t F i e l d [ name= u n t i l, width =10em,% 69 b o r d e r c o l o r ={ } ] { } \ \ 70 &\\*[ 0.9em ] \ h l i n e 71 &\\*[ 0.9em ] \ multicolumn { 2 } { c }{% 72 \ t e x t b f { Doors } } \ \ 73 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t h }{ F r o n t door:}&% 74 \ CheckBox [ name=ht, width =1.2em,% 75 b o r d e r c o l o r ={ } ] { } \ \ 76 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 1 }{ Ground f l o o r :}&% 77 \ CheckBox [ name=e1, width =1.2em,% 78 b o r d e r c o l o r ={ } ] { } \ \ 79 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 2 }{ F i r s t f l o o r :}&% 80 \ CheckBox [ name=e2, width =1.2em,% 81 b o r d e r c o l o r ={ } ] { } \ \ 82 &\\ 83 \ h l i n e 84 \ end { t a b u l a r } 85 \ end {Form} 86 \ end { document } 23

24 4.8 Document events: ex0008 and ex0009 To process document events we have to add an /AA entry to the PDF catalogue. The entry value must be a dictionary defining event handlers. Entries in this dictionary are key/value pairs, the value is again a dictionary specifying the action to take. The following keys can occur: Key /WP /DP /WS /DS /DC Event The document will be printed. The document was printed. The document will be saved. The document was saved. The document will be closed. In the example we run willprint(); for the WillPrint event and didprint(); for the DidPrint event. 1 \ immediate \ p d f o b j { 2 << 3 /WP << / S / J a v a S c r i p t / JS ( w i l l P r i n t ( ) ; ) >> 4 / DP << / S / J a v a S c r i p t / JS ( d i d P r i n t ( ) ; ) >> 5 >> 6 } 7 \ p d f c a t a l o g { /AA \ t h e \ p d f l a s t o b j \ s p a c e 0 R} Before and after printing ex0008.pdf a message box is shown. 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 3 \ u s e p a c k a g e { textcomp } 4 \ u s e p a c k a g e { mathptmx } 5 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 6 \ u s e p a c k a g e { c o u r i e r } 7 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 8 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 9 \ u s e p a c k a g e { f a n c y h d r } 10 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 11 \ l f o o t { } \ c f o o t { } \ r f o o t {} 12 \ p a g e s t y l e { f a n c y } 13 \ u s e p a c k a g e { g r a p h i c x } 14 \ u s e p a c k a g e { c o l o r } 15 \ u s e p a c k a g e [ 16 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 17 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 18 p d f a u t h o r ={ i c h }, 19 pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 24

25 20 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ u s e p a c k a g e [ p d f t e x ] { i n s d l j s } 23 \ immediate \ p d f o b j { 24 << 25 /WP << / S / J a v a S c r i p t / JS ( w i l l P r i n t ( ) ; ) >> 26 / DP << / S / J a v a S c r i p t / JS ( d i d P r i n t ( ) ; ) >> 27 >> 28 } 29 \ p d f c a t a l o g { /AA \ t h e \ p d f l a s t o b j \ s p a c e 0 R} 30 \ b e g i n { insdljs } [ e x a a a c ] { e xaaac }{ Document Level J a v a S c r i p t } / / i n d i c a t e t h a t t h e f u n c t i o n was n o t y e t run 33 v a r done = 0 ; f u n c t i o n w i l l P r i n t ( ) 36 { 37 app. a l e r t ( " The document w i l l be p r i n t e d. " ) ; 38 } f u n c t i o n d i d P r i n t ( ) 41 { 42 app. a l e r t ( " The document was p r i n t e d. " ) ; 43 } / / f u n c t i o n t o run when opening t h e document 46 f u n c t i o n m y F i r s t J a v a S c r i p t F u n c t i o n ( ) 47 { 48 i f (! done ) { 49 done = 1 ; 50 app. a l e r t ( " The form was opened. " ) ; 51 } 52 } 53 \ end { insdljs } 54 \ OpenAction { / S / J a v a S c r i p t / JS ( m y F i r s t J a v a S c r i p t F u n c t i o n ( ) ; ) } 55 \ newcommand { \ t e x t f o r l a b e l }[2]{% 56 \ T e x t F i e l d [ name ={#1}, v a l u e ={#2}, width =7em, a l i g n =2,% 57 b o r d e r c o l o r ={1 1 1}, r e a d o n l y = t r u e ]{}% 58 } 59 \ b e g i n { document } 60 \ s e c t i o n *{ Request f o r a key } 61 \ b e g i n {Form} 62 \ b e g i n { t a b u l a r } { r l } 63 \ h l i n e 25

26 64 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Employee } } \ \ 65 &\\*[ 0.9em ] \ t e x t f o r l a b e l { vn }{ F i r s t name:}&% 66 \ T e x t F i e l d [ name=vorname, width =20em,% 67 b o r d e r c o l o r ={ } ] { } \ \ 68 &\\*[ 0.9em ] \ t e x t f o r l a b e l { nn }{Name:}&% 69 \ T e x t F i e l d [ name=name, width =20em,% 70 b o r d e r c o l o r ={ } ] { } \ \ 71 &\\*[ 0.9em ] \ t e x t f o r l a b e l { ab }{ Department:}&% 72 \ ChoiceMenu [ name= abt, width =20em, popdown= t r u e, v a l u e =v,% 73 b o r d e r c o l o r ={ }]{}{% 74 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 75 &\\*[ 0.9em ] \ h l i n e 76 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {Time } } \ \ 77 &\\*[ 0.9em ] \ t e x t f o r l a b e l { z }{ Time:}&% 78 \ ChoiceMenu [ name= z e i t, width =20em, popdown= t r u e, v a l u e =u,% 79 b o r d e r c o l o r ={ }]{}{% 80 u n l i m i t e d =u, l i m i t e d =b } \ \ 81 &\\*[ 0.9em ] \ t e x t f o r l a b e l {v }{ from:}&% 82 \ T e x t F i e l d [ name=from, width =10em,% 83 b o r d e r c o l o r ={ } ] { } \ \ 84 &\\*[ 0.9em ] \ t e x t f o r l a b e l {b }{ u n t i l :}&% 85 \ T e x t F i e l d [ name= u n t i l, width =10em,% 86 b o r d e r c o l o r ={ } ] { } \ \ 87 &\\*[ 0.9em ] \ h l i n e 88 &\\*[ 0.9em ] \ multicolumn { 2 } { c }{% 89 \ t e x t b f { Doors } } \ \ 90 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t h }{ F r o n t door:}&% 91 \ CheckBox [ name=ht, width =1.2em,% 92 b o r d e r c o l o r ={ } ] { } \ \ 93 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 1 }{ Ground f l o o r :}&% 94 \ CheckBox [ name=e1, width =1.2em,% 95 b o r d e r c o l o r ={ } ] { } \ \ 96 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 2 }{ F i r s t f l o o r :}&% 97 \ CheckBox [ name=e2, width =1.2em,% 98 b o r d e r c o l o r ={ } ] { } \ \ 99 &\\ 100 \ h l i n e 101 \ end { t a b u l a r } 102 \ end {Form} 103 \ end { document } In ex0009.pdf we change stroke and fill colors and text fonts before and after printing. We have to change the fillcolor, strokecolor and textfont attributes. The changes are enclosed in 26

27 1 t h i s. d e l a y = t r u e 2 / /... 3 t h i s. d e l a y = f a l s e to avoid multiple screen refreshes after each change. In myfirstjavascriptfunction() we set defaults for the choice lists abt and zeit using: 1 t h i s. g e t F i e l d ( " a b t " ). c u r r e n t V a l u e I n d i c e s = 0 ; 2 t h i s. g e t F i e l d ( " z e i t " ). c u r r e n t V a l u e I n d i c e s = 0 ; We set the focus to the vorname field by: 1 t h i s. g e t F i e l d ( " vorname " ). s e t F o c u s ( ) ; 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 3 \ u s e p a c k a g e { textcomp } 4 \ u s e p a c k a g e { mathptmx } 5 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 6 \ u s e p a c k a g e { c o u r i e r } 7 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 8 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 9 \ u s e p a c k a g e { f a n c y h d r } 10 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 11 \ l f o o t { } \ c f o o t { } \ r f o o t {} 12 \ p a g e s t y l e { f a n c y } 13 \ u s e p a c k a g e { g r a p h i c x } 14 \ u s e p a c k a g e { c o l o r } 15 \ u s e p a c k a g e [ 16 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 17 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 18 p d f a u t h o r ={ i c h }, 19 pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 20 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ u s e p a c k a g e [ p d f t e x ] { i n s d l j s } 23 \ immediate \ p d f o b j { 24 << 25 /WP << / S / J a v a S c r i p t / JS ( w i l l P r i n t ( ) ; ) >> 26 / DP << / S / J a v a S c r i p t / JS ( d i d P r i n t ( ) ; ) >> 27 >> 28 } 29 \ p d f c a t a l o g { /AA \ t h e \ p d f l a s t o b j \ s p a c e 0 R} 30 \ b e g i n { insdljs } [ exaaad ] { exaaad }{ Document Level J a v a S c r i p t } / / i n d i c a t e t h a t t h e f u n c t i o n was n o t y e t run 27

28 33 v a r done = 0 ; f u n c t i o n c o l o r s P r i n t i n g ( ) 36 { 37 t h i s. g e t F i e l d ( " vorname " ). f i l l C o l o r = c o l o r. w h i t e ; 38 t h i s. g e t F i e l d ( " name " ). f i l l C o l o r = c o l o r. w h i t e ; 39 t h i s. g e t F i e l d ( " a b t " ). f i l l C o l o r = c o l o r. w h i t e ; 40 t h i s. g e t F i e l d ( " z e i t " ). f i l l C o l o r = c o l o r. w h i t e ; 41 t h i s. g e t F i e l d ( " from " ). f i l l C o l o r = c o l o r. w h i t e ; 42 t h i s. g e t F i e l d ( " u n t i l " ). f i l l C o l o r = c o l o r. w h i t e ; 43 t h i s. g e t F i e l d ( " h t " ). f i l l C o l o r = c o l o r. w h i t e ; 44 t h i s. g e t F i e l d ( " e1 " ). f i l l C o l o r = c o l o r. w h i t e ; 45 t h i s. g e t F i e l d ( " e2 " ). f i l l C o l o r = c o l o r. w h i t e ; t h i s. g e t F i e l d ( " vorname " ). s t r o k e C o l o r = c o l o r. b l a c k ; 48 t h i s. g e t F i e l d ( " name " ). s t r o k e C o l o r = c o l o r. b l a c k ; 49 t h i s. g e t F i e l d ( " a b t " ). s t r o k e C o l o r = c o l o r. b l a c k ; 50 t h i s. g e t F i e l d ( " z e i t " ). s t r o k e C o l o r = c o l o r. b l a c k ; 51 t h i s. g e t F i e l d ( " from " ). s t r o k e C o l o r = c o l o r. b l a c k ; 52 t h i s. g e t F i e l d ( " u n t i l " ). s t r o k e C o l o r = c o l o r. b l a c k ; 53 t h i s. g e t F i e l d ( " h t " ). s t r o k e C o l o r = c o l o r. b l a c k ; 54 t h i s. g e t F i e l d ( " e1 " ). s t r o k e C o l o r = c o l o r. b l a c k ; 55 t h i s. g e t F i e l d ( " e2 " ). s t r o k e C o l o r = c o l o r. b l a c k ; t h i s. g e t F i e l d ( " vorname " ). t e x t F o n t = f o n t. Helv ; 58 t h i s. g e t F i e l d ( " name " ). t e x t F o n t = f o n t. Helv ; 59 t h i s. g e t F i e l d ( " a b t " ). t e x t F o n t = f o n t. Helv ; 60 t h i s. g e t F i e l d ( " z e i t " ). t e x t F o n t = f o n t. Helv ; 61 t h i s. g e t F i e l d ( " from " ). t e x t F o n t = f o n t. Helv ; 62 t h i s. g e t F i e l d ( " u n t i l " ). t e x t F o n t = f o n t. Helv ; 63 } f u n c t i o n c o l o r s S c r e e n ( ) 66 { v a r newcolor = [ "RGB", , , ] ; 69 t h i s. g e t F i e l d ( " vorname " ). f i l l C o l o r = newcolor ; 70 t h i s. g e t F i e l d ( " name " ). f i l l C o l o r = newcolor ; 71 t h i s. g e t F i e l d ( " a b t " ). f i l l C o l o r = newcolor ; 72 t h i s. g e t F i e l d ( " z e i t " ). f i l l C o l o r = newcolor ; 73 t h i s. g e t F i e l d ( " from " ). f i l l C o l o r = newcolor ; 74 t h i s. g e t F i e l d ( " u n t i l " ). f i l l C o l o r = newcolor ; 75 t h i s. g e t F i e l d ( " h t " ). f i l l C o l o r = newcolor ; 76 t h i s. g e t F i e l d ( " e1 " ). f i l l C o l o r = newcolor ; 28

29 77 t h i s. g e t F i e l d ( " e2 " ). f i l l C o l o r = newcolor ; t h i s. g e t F i e l d ( " vorname " ). s t r o k e C o l o r = newcolor ; 80 t h i s. g e t F i e l d ( " name " ). s t r o k e C o l o r = newcolor ; 81 t h i s. g e t F i e l d ( " a b t " ). s t r o k e C o l o r = newcolor ; 82 t h i s. g e t F i e l d ( " z e i t " ). s t r o k e C o l o r = newcolor ; 83 t h i s. g e t F i e l d ( " from " ). s t r o k e C o l o r = newcolor ; 84 t h i s. g e t F i e l d ( " u n t i l " ). s t r o k e C o l o r = newcolor ; 85 t h i s. g e t F i e l d ( " h t " ). s t r o k e C o l o r = newcolor ; 86 t h i s. g e t F i e l d ( " e1 " ). s t r o k e C o l o r = newcolor ; 87 t h i s. g e t F i e l d ( " e2 " ). s t r o k e C o l o r = newcolor ; t h i s. g e t F i e l d ( " vorname " ). t e x t F o n t = f o n t. HelvB ; 90 t h i s. g e t F i e l d ( " name " ). t e x t F o n t = f o n t. HelvB ; 91 t h i s. g e t F i e l d ( " a b t " ). t e x t F o n t = f o n t. HelvB ; 92 t h i s. g e t F i e l d ( " z e i t " ). t e x t F o n t = f o n t. HelvB ; 93 t h i s. g e t F i e l d ( " from " ). t e x t F o n t = f o n t. HelvB ; 94 t h i s. g e t F i e l d ( " u n t i l " ). t e x t F o n t = f o n t. HelvB ; 95 } f u n c t i o n w i l l P r i n t ( ) 98 { 99 t h i s. d e l a y = t r u e ; 100 c o l o r s P r i n t i n g ( ) ; 101 t h i s. d e l a y = f a l s e ; 102 } f u n c t i o n d i d P r i n t ( ) 105 { 106 t h i s. d e l a y = t r u e ; 107 c o l o r s S c r e e n ( ) ; 108 t h i s. d e l a y = f a l s e ; 109 } / / f u n c t i o n t o run when opening t h e document 112 f u n c t i o n m y F i r s t J a v a S c r i p t F u n c t i o n ( ) 113 { 114 i f (! done ) { 115 done = 1 ; 116 t h i s. d e l a y = t r u e ; 117 c o l o r s S c r e e n ( ) ; 118 t h i s. g e t F i e l d ( " a b t " ). c u r r e n t V a l u e I n d i c e s = 0 ; 119 t h i s. g e t F i e l d ( " z e i t " ). c u r r e n t V a l u e I n d i c e s = 0 ; 120 t h i s. g e t F i e l d ( " vorname " ). s e t F o c u s ( ) ; 29

30 121 t h i s. d e l a y = f a l s e ; 122 } 123 } 124 \ end { insdljs } 125 \ OpenAction { / S / J a v a S c r i p t / JS ( m y F i r s t J a v a S c r i p t F u n c t i o n ( ) ; ) } 126 \ newcommand { \ t e x t f o r l a b e l }[2]{% 127 \ T e x t F i e l d [ name ={#1}, v a l u e ={#2}, width =7em, a l i g n =2,% 128 b o r d e r c o l o r ={1 1 1}, r e a d o n l y = t r u e ]{}% 129 } 130 \ b e g i n { document } 131 \ s e c t i o n *{ Request f o r a key } 132 \ b e g i n {Form} 133 \ b e g i n { t a b u l a r } { r l } 134 \ h l i n e 135 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f { Employee } } \ \ 136 &\\*[ 0.9em ] \ t e x t f o r l a b e l { vn }{ F i r s t name:}&% 137 \ T e x t F i e l d [ name=vorname, width =20em,% 138 b o r d e r c o l o r ={ } ] { } \ \ 139 &\\*[ 0.9em ] \ t e x t f o r l a b e l { nn }{Name:}&% 140 \ T e x t F i e l d [ name=name, width =20em,% 141 b o r d e r c o l o r ={ } ] { } \ \ 142 &\\*[ 0.9em ] \ t e x t f o r l a b e l { ab }{ Department:}&% 143 \ ChoiceMenu [ name= abt, width =20em, popdown= t r u e, v a l u e =v,% 144 b o r d e r c o l o r ={ }]{}{% 145 S a l e s =v, P r o d u c t i o n =f, S e r v i c e =s } \ \ 146 &\\*[ 0.9em ] \ h l i n e 147 &\\*[ 0.9em ] \ multicolumn { 2 } { c } { \ t e x t b f {Time } } \ \ 148 &\\*[ 0.9em ] \ t e x t f o r l a b e l { z }{ Time:}&% 149 \ ChoiceMenu [ name= z e i t, width =20em, popdown= t r u e, v a l u e =u,% 150 b o r d e r c o l o r ={ }]{}{% 151 u n l i m i t e d =u, l i m i t e d =b } \ \ 152 &\\*[ 0.9em ] \ t e x t f o r l a b e l {v }{ from:}&% 153 \ T e x t F i e l d [ name=from, width =10em,% 154 b o r d e r c o l o r ={ } ] { } \ \ 155 &\\*[ 0.9em ] \ t e x t f o r l a b e l {b }{ u n t i l :}&% 156 \ T e x t F i e l d [ name= u n t i l, width =10em,% 157 b o r d e r c o l o r ={ } ] { } \ \ 158 &\\*[ 0.9em ] \ h l i n e 159 &\\*[ 0.9em ] \ multicolumn { 2 } { c }{% 160 \ t e x t b f { Doors } } \ \ 161 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t h }{ F r o n t door:}&% 162 \ CheckBox [ name=ht, width =1.2em,% 163 b o r d e r c o l o r ={ } ] { } \ \ 164 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 1 }{ Ground f l o o r :}&% 30

31 165 \ CheckBox [ name=e1, width =1.2em,% 166 b o r d e r c o l o r ={ } ] { } \ \ 167 &\\*[ 0.9em ] \ t e x t f o r l a b e l { t 2 }{ F i r s t f l o o r :}&% 168 \ CheckBox [ name=e2, width =1.2em,% 169 b o r d e r c o l o r ={ } ] { } \ \ 170 &\\ 171 \ h l i n e 172 \ end { t a b u l a r } 173 \ end {Form} 174 \ end { document } 31

32 4.9 Form element events: ex0010 Events can be triggered by form elements, in the example we assign the function validate- Time() as an event handler for the Validate event of the zeit choice list. 1 v a l i d a t e ={ v a l i d a t e T i m e ( ) ; } If the user leaves the choice field the function is invoked and turns the from and until text fields visible 1 t h i s. g e t F i e l d ( " von " ). d i s p l a y = d i s p l a y. v i s i b l e ; 2 t h i s. g e t F i e l d ( " b i s " ). d i s p l a y = d i s p l a y. v i s i b l e ; or invisible. 1 t h i s. g e t F i e l d ( " von " ). d i s p l a y = d i s p l a y. hidden ; 2 t h i s. g e t F i e l d ( " b i s " ). d i s p l a y = d i s p l a y. hidden ; 1 \ d o c u m e n t c l a s s [ ngerman, a 4 p a p e r ] { s c r a r t c l } 2 \ u s e p a c k a g e [ T1 ] { f o n t e n c } 3 \ u s e p a c k a g e { textcomp } 4 \ u s e p a c k a g e { mathptmx } 5 \ u s e p a c k a g e [ s c a l e d =. 9 2 ] { h e l v e t } 6 \ u s e p a c k a g e { c o u r i e r } 7 \ renewcommand * { \ f a m i l y d e f a u l t }{ phv } 8 \ u s e p a c k a g e [ l e f t =25mm, t o p =25mm, bottom =10mm, r i g h t =10mm] { geometry } 9 \ u s e p a c k a g e { f a n c y h d r } 10 \ l h e a d {ABC, I n c. } \ chead { } \ r h e a d {XYZ Dept. } 11 \ l f o o t { } \ c f o o t { } \ r f o o t {} 12 \ p a g e s t y l e { f a n c y } 13 \ u s e p a c k a g e { g r a p h i c x } 14 \ u s e p a c k a g e { c o l o r } 15 \ u s e p a c k a g e [ 16 p d f t e x, a 4 p a p e r = t r u e, c o l o r l i n k s = t r u e, 17 p d f t i t l e ={Key form }, p d f s u b j e c t ={Key }, 18 p d f a u t h o r ={ i c h }, 19 pdfpagemode=usenone, p d f s t a r t v i e w =FitH, 20 p a g e b a c k r e f, p d f h i g h l i g h t ={/N} 21 ] { h y p e r r e f } 22 \ u s e p a c k a g e [ p d f t e x ] { i n s d l j s } 23 \ immediate \ p d f o b j { 24 << 25 /WP << / S / J a v a S c r i p t / JS ( w i l l P r i n t ( ) ; ) >> 26 / DP << / S / J a v a S c r i p t / JS ( d i d P r i n t ( ) ; ) >> 27 >> 28 } 29 \ p d f c a t a l o g { /AA \ t h e \ p d f l a s t o b j \ s p a c e 0 R} 32