lib/examples/PDF-form.lyx

   1 #LyX 2.1 created this file. For more info see http://www.lyx.org/
   2 \lyxformat 474
   3 \begin_document
   4 \begin_header
   5 \textclass scrartcl
   6 \begin_preamble
   7 % to be able to use custom colors
   8 \usepackage[svgnames,rgb]{xcolor}
   9
  10 % ------------------------------------
  11 % used to check for needed LaTeX packages
  12 \usepackage{ifthen}
  13
  14 % check for package insdljs
  15 % used for JavScript code
  16 \newboolean{insdljs}
  17 \IfFileExists{insdljs.sty}
  18  {\usepackage[pdftex]{insdljs}
  19   \setboolean{insdljs}{true}}
  20  {\setboolean{insdljs}{false}}
  21
  22 \pdfcatalog{/AA \the\pdflastobj\space 0 R}
  23
  24 \ifinsdljs % only execute if package insdljs is installed
  25
  26  \begin{insDLJS}[exaaae]{exaaae}{JavaScript}
  27
  28   function validateTime(){
  29    this.delay = true;
  30    if((event.value == "u") || (event.value == "unlimited")) {
  31     this.getField("from").display = display.hidden;
  32     this.getField("to").display = display.hidden;
  33    } else {
  34     this.getField("from").display = display.visible;
  35     this.getField("to").display = display.visible;
  36     this.getField("from").setFocus();
  37    }
  38    this.delay = false;
  39   }
  40
  41  function checkNumber() {
  42   event.rc = true;
  43   if (!Number(event.value))
  44   {
  45    app.alert("Value must be a number!");
  46    event.value = "";
  47   }  else {
  48    event.target.textColor = color.green;
  49  }
  50
  51 }
  52
  53  \end{insDLJS}
  54
  55 \fi % end \ifinsdljs
  56
  57 % if pdflatex is used
  58 \usepackage{ifpdf}
  59 \ifpdf
  60
  61 % set fonts for nicer pdf view
  62 \IfFileExists{lmodern.sty}
  63  {\usepackage{lmodern}}{}
  64
  65 \fi % end if pdflatex is used
  66 \end_preamble
  67 \options BCOR8mm,pagesize
  68 \use_default_options false
  69 \begin_modules
  70 pdfform
  71 \end_modules
  72 \maintain_unincluded_children false
  73 \language english
  74 \language_package default
  75 \inputencoding auto
  76 \fontencoding global
  77 \font_roman default
  78 \font_sans default
  79 \font_typewriter default
  80 \font_math auto
  81 \font_default_family default
  82 \use_non_tex_fonts false
  83 \font_sc false
  84 \font_osf false
  85 \font_sf_scale 100
  86 \font_tt_scale 100
  87 \graphics default
  88 \default_output_format default
  89 \output_sync 0
  90 \bibtex_command bibtex
  91 \index_command default
  92 \paperfontsize 12
  93 \spacing single
  94 \use_hyperref true
  95 \pdf_title "Description of the module pdfcomment"
  96 \pdf_author "Uwe Stöhr"
  97 \pdf_subject "PDF form"
  98 \pdf_keywords "LyX, PDF forms, hyperref"
  99 \pdf_bookmarks true
 100 \pdf_bookmarksnumbered true
 101 \pdf_bookmarksopen true
 102 \pdf_bookmarksopenlevel 2
 103 \pdf_breaklinks false
 104 \pdf_pdfborder false
 105 \pdf_colorlinks false
 106 \pdf_backref false
 107 \pdf_pdfusetitle false
 108 \pdf_quoted_options "linkcolor=black, citecolor=black, urlcolor=blue, filecolor=blue, pdfpagelayout=OneColumn, pdfnewwindow=true, pdfstartview=XYZ, plainpages=false, urlbordercolor={1 0 0}"
 109 \papersize a4paper
 110 \use_geometry false
 111 \use_package amsmath 1
 112 \use_package amssymb 1
 113 \use_package cancel 0
 114 \use_package esint 1
 115 \use_package mathdots 1
 116 \use_package mathtools 1
 117 \use_package mhchem 1
 118 \use_package stackrel 0
 119 \use_package stmaryrd 0
 120 \use_package undertilde 0
 121 \cite_engine basic
 122 \cite_engine_type default
 123 \biblio_style plain
 124 \use_bibtopic false
 125 \use_indices false
 126 \paperorientation portrait
 127 \suppress_date true
 128 \justification true
 129 \use_refstyle 0
 130 \notefontcolor #0000ff
 131 \index Index
 132 \shortcut idx
 133 \color #008000
 134 \end_index
 135 \secnumdepth 3
 136 \tocdepth 2
 137 \paragraph_separation skip
 138 \defskip medskip
 139 \quotes_language english
 140 \papercolumns 1
 141 \papersides 1
 142 \paperpagestyle default
 143 \tracking_changes false
 144 \output_changes false
 145 \html_math_output 0
 146 \html_css_as_file 0
 147 \html_be_strict false
 148 \end_header
 149
 150 \begin_body
 151
 152 \begin_layout Begin PDF Form
 153 \begin_inset Argument 1
 154 status open
 155
 156 \begin_layout Plain Layout
 157 action=mailto:forms@lyx.test?subject=The submitted PDF form, method=post
 158 \end_layout
 159
 160 \end_inset
 161
 162
 163 \end_layout
 164
 165 \begin_layout Title
 166 Description of the module PDF Form
 167 \end_layout
 168
 169 \begin_layout Author
 170 Uwe Stöhr
 171 \end_layout
 172
 173 \begin_layout Standard
 174 \begin_inset Note Note
 175 status open
 176
 177 \begin_layout Plain Layout
 178 To export all parts of this document to PDF the LaTeX-package
 179 \series bold
 180 insdljs
 181 \series default
 182  must be installed.
 183  If it is not installed you can export the document anyway but the example
 184  in the section about dynamic form fields won't appear in the output.
 185 \end_layout
 186
 187 \end_inset
 188
 189
 190 \end_layout
 191
 192 \begin_layout Standard
 193 By loading the module PDF
 194 \begin_inset space ~
 195 \end_inset
 196
 197 Form the whole document or a part of it can be made a PDF form.
 198  You can add all possible form elements like text fields buttons etc.
 199  This document describes how this is done.
 200 \end_layout
 201
 202 \begin_layout Section
 203 Preparation
 204 \begin_inset CommandInset label
 205 LatexCommand label
 206 name "sec:Preparation"
 207
 208 \end_inset
 209
 210
 211 \end_layout
 212
 213 \begin_layout Standard
 214 At first load the module PDF
 215 \begin_inset space ~
 216 \end_inset
 217
 218 Form in the document settings of your file.
 219  To make the whole document a form, insert the environment
 220 \family sans
 221  Begin
 222 \begin_inset space ~
 223 \end_inset
 224
 225 PDF
 226 \begin_inset space ~
 227 \end_inset
 228
 229 Form
 230 \family default
 231  from LyX's dropdown menu at the beginning of the document.
 232  If only a part of the document should be a form, add
 233 \family sans
 234 Begin
 235 \begin_inset space ~
 236 \end_inset
 237
 238 PDF
 239 \begin_inset space ~
 240 \end_inset
 241
 242 Form
 243 \family default
 244  at the position where the form should start.
 245 \end_layout
 246
 247 \begin_layout Standard
 248 \begin_inset Note Greyedout
 249 status open
 250
 251 \begin_layout Plain Layout
 252
 253 \series bold
 254 Note:
 255 \series default
 256  It is only possible to have one form in a PDF file!
 257 \end_layout
 258
 259 \end_inset
 260
 261
 262 \end_layout
 263
 264 \begin_layout Standard
 265 If the form data should be submitted to a server or the like, then you must
 266  specify the URL as parameter of the
 267 \family sans
 268 Begin
 269 \begin_inset space ~
 270 \end_inset
 271
 272 PDF
 273 \begin_inset space ~
 274 \end_inset
 275
 276 Form
 277 \family default
 278  environment.
 279  This is done by using the menu
 280 \family sans
 281 Insert\SpecialChar \menuseparator
 282 PDF
 283 \begin_inset space ~
 284 \end_inset
 285
 286 form
 287 \begin_inset space ~
 288 \end_inset
 289
 290 parameters
 291 \family default
 292 .
 293  For example in this document the following was inserted to the parameter
 294  inset:
 295 \end_layout
 296
 297 \begin_layout Standard
 298
 299 \series bold
 300 action=mailto:forms@lyx.test?subject=The submitted PDF form,
 301 \begin_inset Newline newline
 302 \end_inset
 303
 304 method=post
 305 \end_layout
 306
 307 \begin_layout Standard
 308 This sends the form data as email to
 309 \emph on
 310 forms@lyx.test
 311 \emph default
 312  when the user presses the submit button.
 313  The email subject will be
 314 \begin_inset Quotes eld
 315 \end_inset
 316
 317 The submitted PDF form
 318 \begin_inset Quotes erd
 319 \end_inset
 320
 321  and the HTML method is
 322 \series bold
 323 post
 324 \series default
 325 .
 326  (The other possible method would be
 327 \series bold
 328 get
 329 \series default
 330 .) For more about submitting see sec.
 331 \begin_inset space \thinspace{}
 332 \end_inset
 333
 334
 335 \begin_inset CommandInset ref
 336 LatexCommand ref
 337 reference "sub:Submit-button"
 338
 339 \end_inset
 340
 341 .
 342 \end_layout
 343
 344 \begin_layout Standard
 345 \begin_inset Newpage newpage
 346 \end_inset
 347
 348
 349 \end_layout
 350
 351 \begin_layout Section
 352 Form fields
 353 \end_layout
 354
 355 \begin_layout Standard
 356 There are 6
 357 \begin_inset space ~
 358 \end_inset
 359
 360 possible types of fields in a PDF form:
 361 \end_layout
 362
 363 \begin_layout Subsection
 364 Text field
 365 \end_layout
 366
 367 \begin_layout Standard
 368 A text field is added by inserting the custom inset
 369 \family sans
 370 TextField
 371 \family default
 372  using the menu
 373 \family sans
 374 Insert\SpecialChar \menuseparator
 375 Custom
 376 \begin_inset space ~
 377 \end_inset
 378
 379 Insets
 380 \family default
 381 .
 382  Write inside the inset the label for the text field that will be printed
 383  in the PDF output before the field.
 384  Here is an example:
 385 \begin_inset Newline newline
 386 \end_inset
 387
 388
 389 \begin_inset Flex TextField
 390 status open
 391
 392 \begin_layout Plain Layout
 393 \begin_inset Argument 1
 394 status open
 395
 396 \begin_layout Plain Layout
 397 name=customer
 398 \end_layout
 399
 400 \end_inset
 401
 402 Enter your name here:
 403 \end_layout
 404
 405 \end_inset
 406
 407
 408 \end_layout
 409
 410 \begin_layout Standard
 411 You must also specify a field name for text fields: Set the cursor into
 412  its
 413 \family sans
 414 Params
 415 \family default
 416  inset.
 417  There insert for example the parameter
 418 \series bold
 419 name=customer
 420 \series default
 421  (where
 422 \series bold
 423 customer
 424 \series default
 425  is the field name).
 426 \end_layout
 427
 428 \begin_layout Standard
 429 \begin_inset Note Greyedout
 430 status open
 431
 432 \begin_layout Plain Layout
 433
 434 \series bold
 435 Note:
 436 \series default
 437  All braces, brackets, backslashes and quote characters in form parameters
 438  must be inserted as TeX code!
 439 \end_layout
 440
 441 \end_inset
 442
 443
 444 \end_layout
 445
 446 \begin_layout Standard
 447 Using the same name for several text fields results in an automatic duplication
 448  of the inserted text.
 449  This is for example useful if the user should input a date that should
 450  appear at different places in the form.
 451 \begin_inset Newline newline
 452 \end_inset
 453
 454 Here are 2
 455 \begin_inset space ~
 456 \end_inset
 457
 458 fields as example: Fill one and see that the other one will also be filled
 459  automatically:
 460 \begin_inset Newline newline
 461 \end_inset
 462
 463
 464 \begin_inset Flex TextField
 465 status open
 466
 467 \begin_layout Plain Layout
 468 \begin_inset Argument 1
 469 status open
 470
 471 \begin_layout Plain Layout
 472 name=identic
 473 \end_layout
 474
 475 \end_inset
 476
 477
 478 \end_layout
 479
 480 \end_inset
 481
 482
 483 \begin_inset Newline newline
 484 \end_inset
 485
 486
 487 \begin_inset Flex TextField
 488 status open
 489
 490 \begin_layout Plain Layout
 491 \begin_inset Argument 1
 492 status open
 493
 494 \begin_layout Plain Layout
 495 name=identic
 496 \end_layout
 497
 498 \end_inset
 499
 500
 501 \end_layout
 502
 503 \end_inset
 504
 505
 506 \end_layout
 507
 508 \begin_layout Standard
 509 All form fields can be customized by adding parameters.
 510 \end_layout
 511
 512 \begin_layout Standard
 513 Here is a customized multiline text field with a width of 60
 514 \begin_inset space \thinspace{}
 515 \end_inset
 516
 517 % of the text width, 3
 518 \begin_inset space \thinspace{}
 519 \end_inset
 520
 521 cm height and a proposed content:
 522 \begin_inset VSpace defskip
 523 \end_inset
 524
 525
 526 \begin_inset Newline newline
 527 \end_inset
 528
 529
 530 \begin_inset Flex TextField
 531 status open
 532
 533 \begin_layout Plain Layout
 534 \begin_inset Argument 1
 535 status open
 536
 537 \begin_layout Plain Layout
 538 name=customer2, multiline, width=0.6
 539 \begin_inset ERT
 540 status collapsed
 541
 542 \begin_layout Plain Layout
 543
 544
 545 \backslash
 546 textwidth
 547 \end_layout
 548
 549 \end_inset
 550
 551 , height=3cm, value=
 552 \begin_inset ERT
 553 status collapsed
 554
 555 \begin_layout Plain Layout
 556
 557 {
 558 \end_layout
 559
 560 \end_inset
 561
 562 Testman
 563 \begin_inset ERT
 564 status collapsed
 565
 566 \begin_layout Plain Layout
 567
 568 }
 569 \end_layout
 570
 571 \end_inset
 572
 573
 574 \end_layout
 575
 576 \end_inset
 577
 578 Enter your name here:
 579 \end_layout
 580
 581 \end_inset
 582
 583
 584 \end_layout
 585
 586 \begin_layout Standard
 587 \begin_inset Note Greyedout
 588 status open
 589
 590 \begin_layout Plain Layout
 591
 592 \series bold
 593 Note:
 594 \series default
 595  It is highly recommended to use a uniform layout of all fields in your
 596  form.
 597  See sec.
 598 \begin_inset space \thinspace{}
 599 \end_inset
 600
 601
 602 \begin_inset CommandInset ref
 603 LatexCommand ref
 604 reference "sec:Form-field-customization"
 605
 606 \end_inset
 607
 608  for how this is done.
 609 \end_layout
 610
 611 \end_inset
 612
 613
 614 \end_layout
 615
 616 \begin_layout Subsection
 617 Check box
 618 \end_layout
 619
 620 \begin_layout Standard
 621 A check box is added by inserting the custom inset
 622 \family sans
 623 CheckBox
 624 \family default
 625 .
 626  Write inside the inset the label for the box.
 627  Here is an example:
 628 \begin_inset Newline newline
 629 \end_inset
 630
 631
 632 \begin_inset Flex CheckBox
 633 status open
 634
 635 \begin_layout Plain Layout
 636 \begin_inset Argument 1
 637 status open
 638
 639 \begin_layout Plain Layout
 640 name=age
 641 \end_layout
 642
 643 \end_inset
 644
 645 Are you older than 18 years?
 646 \end_layout
 647
 648 \end_inset
 649
 650
 651 \end_layout
 652
 653 \begin_layout Standard
 654 You must also specify a field name for check boxes: Insert for example the
 655  parameter
 656 \series bold
 657 name=age
 658 \series default
 659  (where
 660 \series bold
 661 age
 662 \series default
 663  is the field name) into the
 664 \family sans
 665 Params
 666 \family default
 667  inset.
 668 \end_layout
 669
 670 \begin_layout Subsection
 671 Choice menu
 672 \end_layout
 673
 674 \begin_layout Standard
 675 A choice menu is added by inserting the custom inset
 676 \family sans
 677 ChoiceMenu
 678 \family default
 679 .
 680  A label for the inset is added by using the menu
 681 \family sans
 682 Insert\SpecialChar \menuseparator
 683 Label
 684 \family default
 685 .
 686  Insert the label text into this inset.
 687 \begin_inset Newline newline
 688 \end_inset
 689
 690 The different choices are inserted to the inset as comma-separated list.
 691  There are 3
 692 \begin_inset space ~
 693 \end_inset
 694
 695 choice menu types:
 696 \end_layout
 697
 698 \begin_layout Description
 699 Radio Only one choice can be selected
 700 \end_layout
 701
 702 \begin_layout Description
 703 Combo The choices are listed in a combo box (dropdown list) but the user
 704  is allowed to choose something that is not in the predefined list.
 705 \end_layout
 706
 707 \begin_layout Description
 708 Popdown All choices are listed below each other.
 709  It the filed is not high enough a scroll bar is automatically added to
 710  the field.
 711 \end_layout
 712
 713 \begin_layout Standard
 714 To determine the choice menu type, add the parameter
 715 \series bold
 716 radio
 717 \series default
 718 ,
 719 \series bold
 720 combo
 721 \series default
 722  or
 723 \series bold
 724 popdown
 725 \series default
 726 .
 727 \end_layout
 728
 729 \begin_layout Standard
 730 Here is an example for the radio type:
 731 \begin_inset VSpace defskip
 732 \end_inset
 733
 734
 735 \begin_inset Newline newline
 736 \end_inset
 737
 738
 739 \begin_inset Flex ChoiceMenu
 740 status open
 741
 742 \begin_layout Plain Layout
 743 \begin_inset Argument 1
 744 status open
 745
 746 \begin_layout Plain Layout
 747 radio, name=radio
 748 \end_layout
 749
 750 \end_inset
 751
 752 male=m, female=f
 753 \begin_inset Argument 2
 754 status open
 755
 756 \begin_layout Plain Layout
 757 Sex:
 758 \end_layout
 759
 760 \end_inset
 761
 762
 763 \end_layout
 764
 765 \end_inset
 766
 767
 768 \end_layout
 769
 770 \begin_layout Standard
 771 Here is an example for the combo type:
 772 \begin_inset VSpace defskip
 773 \end_inset
 774
 775
 776 \begin_inset Newline newline
 777 \end_inset
 778
 779
 780 \begin_inset Flex ChoiceMenu
 781 status open
 782
 783 \begin_layout Plain Layout
 784 \begin_inset Argument 1
 785 status open
 786
 787 \begin_layout Plain Layout
 788 combo, name=combo
 789 \end_layout
 790
 791 \end_inset
 792
 793 Albania=Al, Armenia=Ar, Azerbaidschan=Az
 794 \begin_inset Argument 2
 795 status open
 796
 797 \begin_layout Plain Layout
 798 Country:
 799 \end_layout
 800
 801 \end_inset
 802
 803
 804 \end_layout
 805
 806 \end_inset
 807
 808
 809 \end_layout
 810
 811 \begin_layout Standard
 812 Here is an example for the popdown type:
 813 \begin_inset VSpace defskip
 814 \end_inset
 815
 816
 817 \begin_inset Newline newline
 818 \end_inset
 819
 820
 821 \begin_inset Flex ChoiceMenu
 822 status open
 823
 824 \begin_layout Plain Layout
 825 \begin_inset Argument 1
 826 status open
 827
 828 \begin_layout Plain Layout
 829 popdown, name=country
 830 \end_layout
 831
 832 \end_inset
 833
 834 Albania=Al, Armenia=Ar, Azerbaidschan=Az
 835 \begin_inset Argument 2
 836 status open
 837
 838 \begin_layout Plain Layout
 839 Country:
 840 \end_layout
 841
 842 \end_inset
 843
 844
 845 \end_layout
 846
 847 \end_inset
 848
 849
 850 \end_layout
 851
 852 \begin_layout Standard
 853 You must also specify a field name for choice menus: Insert for example
 854  the parameter
 855 \series bold
 856 name=country
 857 \series default
 858  (where
 859 \series bold
 860 country
 861 \series default
 862  is the field name) into the
 863 \family sans
 864 Params
 865 \family default
 866  inset.
 867 \end_layout
 868
 869 \begin_layout Standard
 870 It is recommended to add a short name for every choice to be able to access
 871  them and to know which one was chosen by the user.
 872  This is done by adding
 873 \series bold
 874 =name
 875 \series default
 876  behind each choice (where
 877 \series bold
 878 name
 879 \series default
 880  is the choice name).
 881  For example the radio type example contains this choice list:
 882 \series bold
 883  male=m, female=f
 884 \series default
 885 .
 886  If the user chose
 887 \begin_inset Quotes eld
 888 \end_inset
 889
 890 male
 891 \begin_inset Quotes erd
 892 \end_inset
 893
 894  you know that he chose the choice
 895 \begin_inset Quotes eld
 896 \end_inset
 897
 898 m
 899 \begin_inset Quotes erd
 900 \end_inset
 901
 902 .
 903  By specifying names you can also preset/propose e.g.
 904 \begin_inset space \space{}
 905 \end_inset
 906
 907 the choice
 908 \begin_inset Quotes eld
 909 \end_inset
 910
 911 male
 912 \begin_inset Quotes erd
 913 \end_inset
 914
 915  by adding the parameter
 916 \series bold
 917 default=m
 918 \series default
 919 .
 920  Here is an example:
 921 \end_layout
 922
 923 \begin_layout Standard
 924 \begin_inset Flex ChoiceMenu
 925 status open
 926
 927 \begin_layout Plain Layout
 928 \begin_inset Argument 1
 929 status open
 930
 931 \begin_layout Plain Layout
 932 radio, name=sex, default=m
 933 \end_layout
 934
 935 \end_inset
 936
 937 male=m, female=f
 938 \begin_inset Argument 2
 939 status open
 940
 941 \begin_layout Plain Layout
 942 Sex:
 943 \end_layout
 944
 945 \end_inset
 946
 947
 948 \end_layout
 949
 950 \end_inset
 951
 952
 953 \end_layout
 954
 955 \begin_layout Standard
 956 \begin_inset Note Greyedout
 957 status open
 958
 959 \begin_layout Plain Layout
 960
 961 \series bold
 962 Note:
 963 \series default
 964  Due to a bug in the LaTeX package
 965 \series bold
 966 hyperref
 967 \series default
 968  it is currently only possible the set the first choice as default.
 969 \end_layout
 970
 971 \end_inset
 972
 973
 974 \end_layout
 975
 976 \begin_layout Standard
 977 \begin_inset Newpage newpage
 978 \end_inset
 979
 980
 981 \end_layout
 982
 983 \begin_layout Subsection
 984 Push button
 985 \end_layout
 986
 987 \begin_layout Standard
 988 A push button is added by inserting the custom inset
 989 \family sans
 990 PushButton
 991 \family default
 992 .
 993  Write inside the inset the label for the button.
 994  Here is an example:
 995 \end_layout
 996
 997 \begin_layout Standard
 998 \begin_inset Flex PushButton
 999 status open
1000
1001 \begin_layout Plain Layout
1002 \begin_inset Argument 1
1003 status open
1004
1005 \begin_layout Plain Layout
1006
1007 \end_layout
1008
1009 \end_inset
1010
1011 Don't click on this button or your fridge will be destroyed!!!
1012 \end_layout
1013
1014 \end_inset
1015
1016
1017 \end_layout
1018
1019 \begin_layout Standard
1020 The action that is triggered by pressing the button is specified by JavaScript
1021  code.
1022  To specify it, add the parameter
1023 \series bold
1024 onclick={}
1025 \series default
1026  and insert the JavaScript code between the braces.
1027 \end_layout
1028
1029 \begin_layout Standard
1030 \begin_inset Flex PushButton
1031 status open
1032
1033 \begin_layout Plain Layout
1034 \begin_inset Argument 1
1035 status open
1036
1037 \begin_layout Plain Layout
1038 onclick=
1039 \begin_inset ERT
1040 status collapsed
1041
1042 \begin_layout Plain Layout
1043
1044 {
1045 \end_layout
1046
1047 \end_inset
1048
1049 app.alert(
1050 \begin_inset ERT
1051 status collapsed
1052
1053 \begin_layout Plain Layout
1054
1055 "
1056 \end_layout
1057
1058 \end_inset
1059
1060 What the hell? Now you destroyed your fridge.
1061  Congratulations.
1062 \begin_inset ERT
1063 status collapsed
1064
1065 \begin_layout Plain Layout
1066
1067 "
1068 \end_layout
1069
1070 \end_inset
1071
1072 )
1073 \begin_inset ERT
1074 status collapsed
1075
1076 \begin_layout Plain Layout
1077
1078 }
1079 \end_layout
1080
1081 \end_inset
1082
1083
1084 \end_layout
1085
1086 \end_inset
1087
1088 Don't click on this button or your fridge will be destroyed!!!
1089 \end_layout
1090
1091 \end_inset
1092
1093
1094 \end_layout
1095
1096 \begin_layout Standard
1097 For info about JavaScript, see its documentation,
1098 \begin_inset CommandInset citation
1099 LatexCommand cite
1100 key "JavaScript"
1101
1102 \end_inset
1103
1104 .
1105 \end_layout
1106
1107 \begin_layout Standard
1108 A common usage for pus buttons is to open a weblink.
1109  Such a button is created by inserting a hyperlink into the button inset.
1110  Here is an example:
1111 \end_layout
1112
1113 \begin_layout Standard
1114 \begin_inset Flex PushButton
1115 status open
1116
1117 \begin_layout Plain Layout
1118 \begin_inset Argument 1
1119 status open
1120
1121 \begin_layout Plain Layout
1122
1123 \end_layout
1124
1125 \end_inset
1126
1127
1128 \begin_inset CommandInset href
1129 LatexCommand href
1130 name "Information how to fill out this form"
1131 target "http://wiki.lyx.org"
1132
1133 \end_inset
1134
1135
1136 \end_layout
1137
1138 \end_inset
1139
1140
1141 \end_layout
1142
1143 \begin_layout Standard
1144 To get rid of the frame for weblinks add this to the additional options
1145  in the document settings under
1146 \family sans
1147 PDF
1148 \begin_inset space ~
1149 \end_inset
1150
1151 properties
1152 \family default
1153 :
1154 \end_layout
1155
1156 \begin_layout Standard
1157
1158 \series bold
1159 urlbordercolor={1 0 0}
1160 \end_layout
1161
1162 \begin_layout Standard
1163 if your push button border color is red (the default), otherwise use the
1164  same color definition as for your push button border color.
1165 \end_layout
1166
1167 \begin_layout Subsection
1168 Submit button
1169 \begin_inset CommandInset label
1170 LatexCommand label
1171 name "sub:Submit-button"
1172
1173 \end_inset
1174
1175
1176 \end_layout
1177
1178 \begin_layout Standard
1179 A submit button is used to submit the form data to a server.
1180  It is added by inserting the custom inset
1181 \family sans
1182 SubmitButton
1183 \family default
1184 .
1185  Write inside the inset the label for the button.
1186  Here is an example:
1187 \end_layout
1188
1189 \begin_layout Standard
1190 \begin_inset Flex SubmitButton
1191 status open
1192
1193 \begin_layout Plain Layout
1194 \begin_inset Argument 1
1195 status open
1196
1197 \begin_layout Plain Layout
1198 name=submit1
1199 \end_layout
1200
1201 \end_inset
1202
1203 Send your data via email
1204 \end_layout
1205
1206 \end_inset
1207
1208
1209 \end_layout
1210
1211 \begin_layout Standard
1212 The submit button creates a forms data format (FDF) file (file extension
1213  *.fdf) which is then submitted.
1214  The FDF file contains only the form data.
1215  They can only be applied to a PDF form if all fields in the form have a
1216  name.
1217 \end_layout
1218
1219 \begin_layout Standard
1220 \begin_inset Note Greyedout
1221 status open
1222
1223 \begin_layout Plain Layout
1224
1225 \series bold
1226 Note:
1227 \series default
1228  You can only use a submit button if you specified the submit method and
1229  target in the PDF form environment options! See sec.
1230 \begin_inset space \thinspace{}
1231 \end_inset
1232
1233
1234 \begin_inset CommandInset ref
1235 LatexCommand ref
1236 reference "sec:Preparation"
1237
1238 \end_inset
1239
1240  for the description.
1241  If there are no specifications you will get LaTeX errors!
1242 \end_layout
1243
1244 \end_inset
1245
1246
1247 \end_layout
1248
1249 \begin_layout Standard
1250 \begin_inset Note Greyedout
1251 status open
1252
1253 \begin_layout Plain Layout
1254
1255 \series bold
1256 Note:
1257 \series default
1258  If you have more than one submit button in your document you must specify
1259  a name for each of them to avoid LaTeX errors! For example add
1260 \series bold
1261 name=submit1
1262 \series default
1263  (where
1264 \series bold
1265 submit1
1266 \series default
1267  is the button name).
1268 \end_layout
1269
1270 \end_inset
1271
1272
1273 \end_layout
1274
1275 \begin_layout Subsection
1276 Reset button
1277 \end_layout
1278
1279 \begin_layout Standard
1280 A reset button is used to reset all form fields to the initial state.
1281  It is added by inserting the custom inset
1282 \family sans
1283 ResetButton
1284 \family default
1285 .
1286  Write inside the inset the label for the button.
1287  Here is an example:
1288 \end_layout
1289
1290 \begin_layout Standard
1291 \begin_inset Flex ResetButton
1292 status open
1293
1294 \begin_layout Plain Layout
1295 \begin_inset Argument 1
1296 status open
1297
1298 \begin_layout Plain Layout
1299 name=reset1
1300 \end_layout
1301
1302 \end_inset
1303
1304 Reset the form
1305 \end_layout
1306
1307 \end_inset
1308
1309
1310 \end_layout
1311
1312 \begin_layout Standard
1313 \begin_inset Note Greyedout
1314 status open
1315
1316 \begin_layout Plain Layout
1317
1318 \series bold
1319 Note:
1320 \series default
1321  If you have more than one reset button in your document you must specify
1322  a name for each of them to avoid LaTeX errors! For example add
1323 \series bold
1324 name=reset1
1325 \series default
1326  (where
1327 \series bold
1328 reset1
1329 \series default
1330  is the button name).
1331 \end_layout
1332
1333 \end_inset
1334
1335
1336 \end_layout
1337
1338 \begin_layout Section
1339 Form field customization
1340 \begin_inset CommandInset label
1341 LatexCommand label
1342 name "sec:Form-field-customization"
1343
1344 \end_inset
1345
1346
1347 \end_layout
1348
1349 \begin_layout Standard
1350 Since all form elements should look uniform, one can determine their layout
1351  using the following styles:
1352 \end_layout
1353
1354 \begin_layout Description
1355 Text
1356 \begin_inset space ~
1357 \end_inset
1358
1359 Field
1360 \begin_inset space ~
1361 \end_inset
1362
1363 Style
1364 \end_layout
1365
1366 \begin_layout Description
1367 Check
1368 \begin_inset space ~
1369 \end_inset
1370
1371 Box
1372 \begin_inset space ~
1373 \end_inset
1374
1375 Style
1376 \end_layout
1377
1378 \begin_layout Description
1379 List
1380 \begin_inset space ~
1381 \end_inset
1382
1383 Box
1384 \begin_inset space ~
1385 \end_inset
1386
1387 Style affects all choice menu types
1388 \end_layout
1389
1390 \begin_layout Description
1391 Combo
1392 \begin_inset space ~
1393 \end_inset
1394
1395 Box
1396 \begin_inset space ~
1397 \end_inset
1398
1399 Style affects only the combo box style
1400 \end_layout
1401
1402 \begin_layout Description
1403 Popdown
1404 \begin_inset space ~
1405 \end_inset
1406
1407 Box
1408 \begin_inset space ~
1409 \end_inset
1410
1411 Style affects only the popdown box style
1412 \end_layout
1413
1414 \begin_layout Description
1415 Radio
1416 \begin_inset space ~
1417 \end_inset
1418
1419 Box
1420 \begin_inset space ~
1421 \end_inset
1422
1423 Style affects only the radio box style
1424 \end_layout
1425
1426 \begin_layout Description
1427 Push
1428 \begin_inset space ~
1429 \end_inset
1430
1431 Button
1432 \begin_inset space ~
1433 \end_inset
1434
1435 Style
1436 \end_layout
1437
1438 \begin_layout Description
1439 Submit
1440 \begin_inset space ~
1441 \end_inset
1442
1443 Button
1444 \begin_inset space ~
1445 \end_inset
1446
1447 Style
1448 \end_layout
1449
1450 \begin_layout Description
1451 Reset
1452 \begin_inset space ~
1453 \end_inset
1454
1455 Button
1456 \begin_inset space ~
1457 \end_inset
1458
1459 Style
1460 \end_layout
1461
1462 \begin_layout Text Field Style
1463
1464 \end_layout
1465
1466 \begin_layout Standard
1467 The content of the styles is a comma-separated list of parameters.
1468  The possible parameters are listed in sec.
1469 \begin_inset space \thinspace{}
1470 \end_inset
1471
1472 6.2
1473 \begin_inset Quotes eld
1474 \end_inset
1475
1476 Forms optional parameters
1477 \begin_inset Quotes erd
1478 \end_inset
1479
1480  of the documentation of the LaTeX package
1481 \series bold
1482 hyperref
1483 \series default
1484 ,
1485 \begin_inset CommandInset citation
1486 LatexCommand cite
1487 key "hyperref"
1488
1489 \end_inset
1490
1491 .
1492  It is important that the parameter print is always part of the definition,
1493  otherwise the fields won't appear in the PDF output.
1494  The defined style is applied to all fields following the definition.
1495 \end_layout
1496
1497 \begin_layout Subsubsection*
1498 Here are some examples:
1499 \end_layout
1500
1501 \begin_layout Text Field Style
1502 print, bordercolor=red, borderstyle=U, backgroundcolor=lightgray, color=lime,
1503  maxlen=10, align=2, charsize=16pt
1504 \end_layout
1505
1506 \begin_layout Check Box Style
1507 print, borderstyle=S, checkboxsymbol=
1508 \backslash
1509 ding{55}
1510 \end_layout
1511
1512 \begin_layout Combo Box Style
1513 print, bordercolor={0.33 0.66 0.33}, borderstyle=D
1514 \end_layout
1515
1516 \begin_layout Popdown Box Style
1517 print, menulength=2
1518 \end_layout
1519
1520 \begin_layout Radio Box Style
1521 print, borderstyle=I, radiosymbol=6
1522 \end_layout
1523
1524 \begin_layout Push Button Style
1525 print, borderstyle=B, bordercolor=lime
1526 \end_layout
1527
1528 \begin_layout Submit Button Style
1529 print, borderwidth=0, bordercolor=white
1530 \end_layout
1531
1532 \begin_layout Reset Button Style
1533 print, bordercolor=lime
1534 \end_layout
1535
1536 \begin_layout Itemize
1537 Text field with gray background, lime text color, a red border only below
1538  the field, right alignment, 16
1539 \begin_inset space \thinspace{}
1540 \end_inset
1541
1542 pt font size and a limitation for maximal 10
1543 \begin_inset space ~
1544 \end_inset
1545
1546 characters to insert:
1547 \begin_inset VSpace defskip
1548 \end_inset
1549
1550
1551 \begin_inset Newline newline
1552 \end_inset
1553
1554
1555 \begin_inset Flex TextField
1556 status open
1557
1558 \begin_layout Plain Layout
1559 \begin_inset Argument 1
1560 status open
1561
1562 \begin_layout Plain Layout
1563
1564 \end_layout
1565
1566 \end_inset
1567
1568 Enter your name here:
1569 \end_layout
1570
1571 \end_inset
1572
1573
1574 \end_layout
1575
1576 \begin_layout Standard
1577 The
1578 \series bold
1579 borderstyle
1580 \series default
1581  can be
1582 \series bold
1583 U
1584 \series default
1585  (underlined),
1586 \series bold
1587 S
1588 \series default
1589  (solid),
1590 \series bold
1591 D
1592 \series default
1593  (dashed),
1594 \series bold
1595 B
1596 \series default
1597  (bevel), or
1598 \series bold
1599 I
1600 \series default
1601  (inverted bevel).
1602 \end_layout
1603
1604 \begin_layout Standard
1605 \begin_inset Note Greyedout
1606 status open
1607
1608 \begin_layout Plain Layout
1609
1610 \series bold
1611 Note
1612 \series default
1613  that the
1614 \series bold
1615 value
1616 \series default
1617  has only an effect for text fields if a
1618 \series bold
1619 name
1620 \series default
1621  was specified.
1622 \end_layout
1623
1624 \end_inset
1625
1626
1627 \end_layout
1628
1629 \begin_layout Itemize
1630 Check box with normal border and symbol
1631 \backslash
1632 ding{55}:
1633 \begin_inset VSpace defskip
1634 \end_inset
1635
1636
1637 \begin_inset Newline newline
1638 \end_inset
1639
1640
1641 \begin_inset Flex CheckBox
1642 status open
1643
1644 \begin_layout Plain Layout
1645 \begin_inset Argument 1
1646 status open
1647
1648 \begin_layout Plain Layout
1649
1650 \end_layout
1651
1652 \end_inset
1653
1654 Are you older than 18 years?
1655 \end_layout
1656
1657 \end_inset
1658
1659
1660 \end_layout
1661
1662 \begin_layout Standard
1663 The symbol is either specified as number or with the command
1664 \begin_inset Newline newline
1665 \end_inset
1666
1667
1668 \series bold
1669
1670 \backslash
1671 ding{number}
1672 \series default
1673
1674 \begin_inset Newline newline
1675 \end_inset
1676
1677 where
1678 \series bold
1679 number
1680 \series default
1681  is one of the possible numbers listed in Table
1682 \begin_inset space ~
1683 \end_inset
1684
1685 2 of
1686 \begin_inset CommandInset citation
1687 LatexCommand cite
1688 key "pifont"
1689
1690 \end_inset
1691
1692 .
1693 \end_layout
1694
1695 \begin_layout Itemize
1696 Combo box with dashed, colored border:
1697 \begin_inset VSpace defskip
1698 \end_inset
1699
1700
1701 \begin_inset Newline newline
1702 \end_inset
1703
1704
1705 \begin_inset Flex ChoiceMenu
1706 status open
1707
1708 \begin_layout Plain Layout
1709 \begin_inset Argument 1
1710 status open
1711
1712 \begin_layout Plain Layout
1713 combo, name=combo2, default=Az
1714 \end_layout
1715
1716 \end_inset
1717
1718 Albania=Al, Armenia=Ar, Azerbaidschan=Az
1719 \begin_inset Argument 2
1720 status open
1721
1722 \begin_layout Plain Layout
1723 Country:
1724 \end_layout
1725
1726 \end_inset
1727
1728
1729 \end_layout
1730
1731 \end_inset
1732
1733
1734 \end_layout
1735
1736 \begin_layout Itemize
1737 Popdown box where only 2
1738 \begin_inset space ~
1739 \end_inset
1740
1741 entries are shown and where the last entry is preselected:
1742 \begin_inset VSpace defskip
1743 \end_inset
1744
1745
1746 \begin_inset Newline newline
1747 \end_inset
1748
1749
1750 \begin_inset Flex ChoiceMenu
1751 status open
1752
1753 \begin_layout Plain Layout
1754 \begin_inset Argument 1
1755 status open
1756
1757 \begin_layout Plain Layout
1758 popdown, name=country2, value=Az
1759 \end_layout
1760
1761 \end_inset
1762
1763 Albania=Al, Armenia=Ar, Azerbaidschan=Az
1764 \begin_inset Argument 2
1765 status open
1766
1767 \begin_layout Plain Layout
1768 Country:
1769 \end_layout
1770
1771 \end_inset
1772
1773
1774 \end_layout
1775
1776 \end_inset
1777
1778
1779 \end_layout
1780
1781 \begin_layout Standard
1782 \begin_inset VSpace defskip
1783 \end_inset
1784
1785
1786 \begin_inset Note Greyedout
1787 status open
1788
1789 \begin_layout Plain Layout
1790
1791 \series bold
1792 Note
1793 \series default
1794  that the
1795 \series bold
1796 borderstyle B
1797 \series default
1798  and
1799 \series bold
1800 I
1801 \series default
1802  and also
1803 \series bold
1804 color
1805 \series default
1806  has no effect for popdown boxes.
1807 \end_layout
1808
1809 \end_inset
1810
1811
1812 \end_layout
1813
1814 \begin_layout Itemize
1815 Radio box with inverted bevel border and symbol number
1816 \begin_inset space ~
1817 \end_inset
1818
1819 6 as checkmark:
1820 \begin_inset VSpace defskip
1821 \end_inset
1822
1823
1824 \begin_inset Newline newline
1825 \end_inset
1826
1827
1828 \begin_inset Flex ChoiceMenu
1829 status open
1830
1831 \begin_layout Plain Layout
1832 \begin_inset Argument 1
1833 status open
1834
1835 \begin_layout Plain Layout
1836 radio, name=radio2
1837 \end_layout
1838
1839 \end_inset
1840
1841 male=m, female=f
1842 \begin_inset Argument 2
1843 status open
1844
1845 \begin_layout Plain Layout
1846 Sex:
1847 \end_layout
1848
1849 \end_inset
1850
1851
1852 \end_layout
1853
1854 \end_inset
1855
1856
1857 \end_layout
1858
1859 \begin_layout Itemize
1860 Push button with a bevel border and colored text:
1861 \begin_inset VSpace defskip
1862 \end_inset
1863
1864
1865 \begin_inset Newline newline
1866 \end_inset
1867
1868
1869 \begin_inset Flex PushButton
1870 status open
1871
1872 \begin_layout Plain Layout
1873 \begin_inset Argument 1
1874 status open
1875
1876 \begin_layout Plain Layout
1877 onclick=
1878 \begin_inset ERT
1879 status collapsed
1880
1881 \begin_layout Plain Layout
1882
1883 {
1884 \end_layout
1885
1886 \end_inset
1887
1888 app.alert(
1889 \begin_inset ERT
1890 status collapsed
1891
1892 \begin_layout Plain Layout
1893
1894 "
1895 \end_layout
1896
1897 \end_inset
1898
1899 Why do you click this?
1900 \begin_inset ERT
1901 status collapsed
1902
1903 \begin_layout Plain Layout
1904
1905 "
1906 \end_layout
1907
1908 \end_inset
1909
1910 )
1911 \begin_inset ERT
1912 status collapsed
1913
1914 \begin_layout Plain Layout
1915
1916 }
1917 \end_layout
1918
1919 \end_inset
1920
1921
1922 \end_layout
1923
1924 \end_inset
1925
1926
1927 \begin_inset ERT
1928 status collapsed
1929
1930 \begin_layout Plain Layout
1931
1932
1933 \backslash
1934 colorbox{lime}{
1935 \end_layout
1936
1937 \end_inset
1938
1939
1940 \color red
1941 Don't click on this button!!!
1942 \color inherit
1943
1944 \begin_inset ERT
1945 status collapsed
1946
1947 \begin_layout Plain Layout
1948
1949 }
1950 \end_layout
1951
1952 \end_inset
1953
1954
1955 \end_layout
1956
1957 \end_inset
1958
1959
1960 \end_layout
1961
1962 \begin_layout Standard
1963 \begin_inset VSpace defskip
1964 \end_inset
1965
1966
1967 \begin_inset Note Greyedout
1968 status open
1969
1970 \begin_layout Plain Layout
1971
1972 \series bold
1973 Note
1974 \series default
1975  that the
1976 \series bold
1977 backgroundcolor
1978 \series default
1979  and
1980 \series bold
1981  color
1982 \series default
1983  has no effect for push, submit and reset buttons.
1984 \end_layout
1985
1986 \end_inset
1987
1988
1989 \end_layout
1990
1991 \begin_layout Standard
1992 As workaround use the command
1993 \series bold
1994
1995 \backslash
1996 colorbox
1997 \series default
1998  as described in sec.
1999 \begin_inset space \thinspace{}
2000 \end_inset
2001
2002  5.7
2003 \begin_inset Quotes eld
2004 \end_inset
2005
2006 Colored Boxes
2007 \begin_inset Quotes erd
2008 \end_inset
2009
2010  in LyX's
2011 \emph on
2012 EmbeddedObjects
2013 \emph default
2014  manual.
2015 \begin_inset Newline newline
2016 \end_inset
2017
2018 In the button above this code was used:
2019 \begin_inset Newline newline
2020 \end_inset
2021
2022
2023 \family sans
2024
2025 \backslash
2026 colorbox{lime}{Don't click on this button!!!}
2027 \family default
2028
2029 \begin_inset Newline newline
2030 \end_inset
2031
2032 and the button text was colored.
2033 \end_layout
2034
2035 \begin_layout Standard
2036 \begin_inset Note Greyedout
2037 status open
2038
2039 \begin_layout Plain Layout
2040
2041 \series bold
2042 Note
2043 \series default
2044  that the
2045 \series bold
2046 height
2047 \series default
2048 and
2049 \series bold
2050 width
2051 \series default
2052  has no effect for push, submit and reset buttons.
2053 \end_layout
2054
2055 \end_inset
2056
2057
2058 \end_layout
2059
2060 \begin_layout Standard
2061 As workaround use the box method described in sec.
2062 \begin_inset space \thinspace{}
2063 \end_inset
2064
2065
2066 \begin_inset CommandInset ref
2067 LatexCommand ref
2068 reference "sub:Action-button-customization"
2069
2070 \end_inset
2071
2072
2073 \end_layout
2074
2075 \begin_layout Itemize
2076 Submit button without border, with cyan background color and increased height:
2077 \begin_inset VSpace defskip
2078 \end_inset
2079
2080
2081 \begin_inset Newline newline
2082 \end_inset
2083
2084
2085 \begin_inset Flex SubmitButton
2086 status open
2087
2088 \begin_layout Plain Layout
2089 \begin_inset Argument 1
2090 status open
2091
2092 \begin_layout Plain Layout
2093 name=submit2
2094 \end_layout
2095
2096 \end_inset
2097
2098
2099 \begin_inset ERT
2100 status collapsed
2101
2102 \begin_layout Plain Layout
2103
2104
2105 \backslash
2106 colorbox{cyan}{
2107 \end_layout
2108
2109 \end_inset
2110
2111
2112 \begin_inset Box Frameless
2113 position "c"
2114 hor_pos "c"
2115 has_inner_box 1
2116 inner_pos "c"
2117 use_parbox 1
2118 use_makebox 0
2119 width "5cm"
2120 special "none"
2121 height "4in"
2122 height_special "totalheight"
2123 status open
2124
2125 \begin_layout Plain Layout
2126 \begin_inset ERT
2127 status collapsed
2128
2129 \begin_layout Plain Layout
2130
2131
2132 \backslash
2133 centering
2134 \end_layout
2135
2136 \end_inset
2137
2138  Send your data via mail
2139 \end_layout
2140
2141 \end_inset
2142
2143
2144 \begin_inset ERT
2145 status collapsed
2146
2147 \begin_layout Plain Layout
2148
2149 }
2150 \end_layout
2151
2152 \end_inset
2153
2154
2155 \end_layout
2156
2157 \end_inset
2158
2159
2160 \begin_inset VSpace bigskip
2161 \end_inset
2162
2163
2164 \end_layout
2165
2166 \begin_layout Itemize
2167 Reset button with a width of 7
2168 \begin_inset space \thinspace{}
2169 \end_inset
2170
2171 cm:
2172 \begin_inset VSpace defskip
2173 \end_inset
2174
2175
2176 \begin_inset Newline newline
2177 \end_inset
2178
2179
2180 \begin_inset Flex ResetButton
2181 status open
2182
2183 \begin_layout Plain Layout
2184 \begin_inset Argument 1
2185 status open
2186
2187 \begin_layout Plain Layout
2188 name=reset2
2189 \end_layout
2190
2191 \end_inset
2192
2193
2194 \begin_inset Box Frameless
2195 position "t"
2196 hor_pos "c"
2197 has_inner_box 1
2198 inner_pos "t"
2199 use_parbox 0
2200 use_makebox 1
2201 width "7cm"
2202 special "none"
2203 height "1in"
2204 height_special "totalheight"
2205 status open
2206
2207 \begin_layout Plain Layout
2208 \begin_inset ERT
2209 status collapsed
2210
2211 \begin_layout Plain Layout
2212
2213
2214 \backslash
2215 centering
2216 \end_layout
2217
2218 \end_inset
2219
2220  Reset the form
2221 \end_layout
2222
2223 \end_inset
2224
2225
2226 \end_layout
2227
2228 \end_inset
2229
2230
2231 \end_layout
2232
2233 \begin_layout Section
2234 PDF viewer action buttons
2235 \end_layout
2236
2237 \begin_layout Standard
2238 One often needs basic actions to be done by the PDF viewer program.
2239  For example to print the form.
2240  Such PDF program-specific actions can be triggered by adding inserting
2241  the custom inset
2242 \family sans
2243 PDFAction
2244 \family default
2245 .
2246  The PDF viewer programs
2247 \emph on
2248 Acrobat
2249 \emph default
2250  and
2251 \emph on
2252 Adobe Reader
2253 \emph default
2254  can handle all possible actions while other PDF viewers might only support
2255  some of them.
2256  However, all PDF viewer programs support the basic things like printing,
2257  save
2258 \begin_inset space ~
2259 \end_inset
2260
2261 as, view in fullscreen etc..
2262 \end_layout
2263
2264 \begin_layout Standard
2265 To specify the action insert its name to the
2266 \family sans
2267 Action
2268 \family default
2269  inset.
2270  A list with possible actions can be found in sec.
2271 \begin_inset space \thinspace{}
2272 \end_inset
2273
2274 5
2275 \begin_inset Quotes eld
2276 \end_inset
2277
2278 Acrobat-specific behavior
2279 \begin_inset Quotes erd
2280 \end_inset
2281
2282  of the documentation of the LaTeX package
2283 \series bold
2284 hyperref
2285 \series default
2286 ,
2287 \begin_inset CommandInset citation
2288 LatexCommand cite
2289 key "hyperref"
2290
2291 \end_inset
2292
2293 .
2294 \end_layout
2295
2296 \begin_layout Standard
2297 Here are some examples:
2298 \end_layout
2299
2300 \begin_layout Description
2301 Printing:
2302 \begin_inset Flex PDFAction
2303 status open
2304
2305 \begin_layout Plain Layout
2306 \begin_inset Argument 1
2307 status open
2308
2309 \begin_layout Plain Layout
2310 Print
2311 \end_layout
2312
2313 \end_inset
2314
2315 Print the document
2316 \end_layout
2317
2318 \end_inset
2319
2320
2321 \end_layout
2322
2323 \begin_layout Description
2324 Save
2325 \begin_inset space ~
2326 \end_inset
2327
2328 as:
2329 \begin_inset Flex PDFAction
2330 status open
2331
2332 \begin_layout Plain Layout
2333 \begin_inset Argument 1
2334 status open
2335
2336 \begin_layout Plain Layout
2337 SaveAs
2338 \end_layout
2339
2340 \end_inset
2341
2342 Save document as
2343 \end_layout
2344
2345 \end_inset
2346
2347
2348 \end_layout
2349
2350 \begin_layout Description
2351 View
2352 \begin_inset space ~
2353 \end_inset
2354
2355 in
2356 \begin_inset space ~
2357 \end_inset
2358
2359 fullscreen:
2360 \begin_inset Flex PDFAction
2361 status open
2362
2363 \begin_layout Plain Layout
2364 \begin_inset Argument 1
2365 status open
2366
2367 \begin_layout Plain Layout
2368 FullScreen
2369 \end_layout
2370
2371 \end_inset
2372
2373 View the form in fullscreen
2374 \end_layout
2375
2376 \end_inset
2377
2378
2379 \end_layout
2380
2381 \begin_layout Subsection
2382 Action button customization
2383 \begin_inset CommandInset label
2384 LatexCommand label
2385 name "sub:Action-button-customization"
2386
2387 \end_inset
2388
2389
2390 \end_layout
2391
2392 \begin_layout Standard
2393 Customizing the action buttons requires the usage of boxes because things
2394  like the width, height and border separation cannot be specified as button
2395  parameters.
2396 \end_layout
2397
2398 \begin_layout Standard
2399 The easiest way to customize the buttons is to fill it with a custom box.
2400  For example the button should be 4
2401 \begin_inset space \thinspace{}
2402 \end_inset
2403
2404 cm wide and have the height of 2 lines.
2405  Then create this parbox:
2406 \end_layout
2407
2408 \begin_layout Standard
2409 \begin_inset Box Frameless
2410 position "c"
2411 hor_pos "c"
2412 has_inner_box 1
2413 inner_pos "c"
2414 use_parbox 1
2415 use_makebox 0
2416 width "4cm"
2417 special "none"
2418 height "2in"
2419 height_special "totalheight"
2420 status open
2421
2422 \begin_layout Plain Layout
2423 \noindent
2424 Save form as
2425 \end_layout
2426
2427 \end_inset
2428
2429
2430 \end_layout
2431
2432 \begin_layout Standard
2433 inside a
2434 \family sans
2435 PDFAction
2436 \family default
2437  inset.
2438  To center the text in the button add
2439 \series bold
2440
2441 \backslash
2442 centering
2443 \series default
2444  as TeX code right before the button text.
2445  This is the result:
2446 \end_layout
2447
2448 \begin_layout Standard
2449 \begin_inset Flex PDFAction
2450 status open
2451
2452 \begin_layout Plain Layout
2453 \begin_inset Argument 1
2454 status open
2455
2456 \begin_layout Plain Layout
2457 SaveAs
2458 \end_layout
2459
2460 \end_inset
2461
2462
2463 \begin_inset Box Frameless
2464 position "c"
2465 hor_pos "c"
2466 has_inner_box 1
2467 inner_pos "c"
2468 use_parbox 1
2469 use_makebox 0
2470 width "4cm"
2471 special "none"
2472 height "2in"
2473 height_special "totalheight"
2474 status open
2475
2476 \begin_layout Plain Layout
2477 \begin_inset ERT
2478 status collapsed
2479
2480 \begin_layout Plain Layout
2481
2482
2483 \backslash
2484 centering
2485 \end_layout
2486
2487 \end_inset
2488
2489  Save form as
2490 \end_layout
2491
2492 \end_inset
2493
2494
2495 \end_layout
2496
2497 \end_inset
2498
2499
2500 \end_layout
2501
2502 \begin_layout Standard
2503 To customize the border color, add the command
2504 \series bold
2505 menubordercolor={r g b}
2506 \series default
2507  to the additional options in the document settings under
2508 \family sans
2509 PDF
2510 \begin_inset space ~
2511 \end_inset
2512
2513 properties
2514 \family default
2515  and replace
2516 \series bold
2517 r
2518 \series default
2519 ,
2520 \series bold
2521 g
2522 \series default
2523  and
2524 \series bold
2525 b
2526 \series default
2527  with a number between 0 and 1 for the colors red, green and blue.
2528  If you want to change the border color only for certain buttons, use the
2529  layout
2530 \family sans
2531 PDF
2532 \begin_inset space ~
2533 \end_inset
2534
2535 link
2536 \begin_inset space ~
2537 \end_inset
2538
2539 setup
2540 \family default
2541  before the button and insert there the command
2542 \series bold
2543 menubordercolor
2544 \series default
2545 .
2546  The default value of
2547 \series bold
2548 menubordercolor
2549 \series default
2550  is
2551 \series bold
2552 {1 0 0}
2553 \series default
2554 .
2555 \end_layout
2556
2557 \begin_layout PDF Link Setup
2558 menubordercolor={0.1 0.9 0.5}
2559 \end_layout
2560
2561 \begin_layout Standard
2562 An example with
2563 \series bold
2564 menubordercolor={0.1 0.9 0.5}
2565 \series default
2566 :
2567 \begin_inset Newline newline
2568 \end_inset
2569
2570
2571 \begin_inset Flex PDFAction
2572 status open
2573
2574 \begin_layout Plain Layout
2575 \begin_inset Argument 1
2576 status open
2577
2578 \begin_layout Plain Layout
2579 SaveAs
2580 \end_layout
2581
2582 \end_inset
2583
2584
2585 \begin_inset Box Frameless
2586 position "c"
2587 hor_pos "c"
2588 has_inner_box 1
2589 inner_pos "c"
2590 use_parbox 1
2591 use_makebox 0
2592 width "4cm"
2593 special "none"
2594 height "2in"
2595 height_special "totalheight"
2596 status open
2597
2598 \begin_layout Plain Layout
2599 \noindent
2600 \begin_inset ERT
2601 status collapsed
2602
2603 \begin_layout Plain Layout
2604
2605
2606 \backslash
2607 centering
2608 \end_layout
2609
2610 \end_inset
2611
2612  Save form as
2613 \end_layout
2614
2615 \end_inset
2616
2617
2618 \end_layout
2619
2620 \end_inset
2621
2622
2623 \end_layout
2624
2625 \begin_layout Standard
2626 To change the border width use the command
2627 \series bold
2628 pdfborder={0 0 w}
2629 \series default
2630  where
2631 \series bold
2632 w
2633 \series default
2634  is the width in pixels.
2635  The default value of
2636 \series bold
2637 pdfborder
2638 \series default
2639  is
2640 \series bold
2641 {0 0 1}
2642 \series default
2643 .
2644 \end_layout
2645
2646 \begin_layout Standard
2647 \begin_inset Note Greyedout
2648 status open
2649
2650 \begin_layout Plain Layout
2651
2652 \series bold
2653 Note:
2654 \series default
2655
2656 \series bold
2657 pdfborder
2658 \series default
2659  affects all link types, not only the menu links.
2660 \end_layout
2661
2662 \end_inset
2663
2664
2665 \end_layout
2666
2667 \begin_layout PDF Link Setup
2668 pdfborder={0 0 4}, menubordercolor={1 1 0}
2669 \end_layout
2670
2671 \begin_layout Standard
2672 An example with a 4
2673 \begin_inset space ~
2674 \end_inset
2675
2676 pixel thick yellow border:
2677 \begin_inset Newline newline
2678 \end_inset
2679
2680
2681 \begin_inset Flex PDFAction
2682 status open
2683
2684 \begin_layout Plain Layout
2685 \begin_inset Argument 1
2686 status open
2687
2688 \begin_layout Plain Layout
2689 SaveAs
2690 \end_layout
2691
2692 \end_inset
2693
2694
2695 \begin_inset Box Frameless
2696 position "c"
2697 hor_pos "c"
2698 has_inner_box 1
2699 inner_pos "c"
2700 use_parbox 1
2701 use_makebox 0
2702 width "4cm"
2703 special "none"
2704 height "2in"
2705 height_special "totalheight"
2706 status open
2707
2708 \begin_layout Plain Layout
2709 \noindent
2710 \begin_inset ERT
2711 status collapsed
2712
2713 \begin_layout Plain Layout
2714
2715
2716 \backslash
2717 centering
2718 \end_layout
2719
2720 \end_inset
2721
2722  Save form as
2723 \end_layout
2724
2725 \end_inset
2726
2727
2728 \end_layout
2729
2730 \end_inset
2731
2732
2733 \end_layout
2734
2735 \begin_layout Standard
2736 To change the background color insert the command
2737 \series bold
2738
2739 \backslash
2740 colorbox{color}{
2741 \series default
2742  at the beginning of the button inset and a
2743 \series bold
2744 }
2745 \series default
2746  at the end.
2747
2748 \series bold
2749 color
2750 \series default
2751  is hereby the name of the color as described in sec.
2752 \begin_inset space \thinspace{}
2753 \end_inset
2754
2755 5.7
2756 \begin_inset Quotes eld
2757 \end_inset
2758
2759 Colored Boxes
2760 \begin_inset Quotes erd
2761 \end_inset
2762
2763  of LyX's
2764 \emph on
2765 EmbeddedObjects
2766 \emph default
2767  manual.
2768 \end_layout
2769
2770 \begin_layout PDF Link Setup
2771 pdfborder={0 0 0}
2772 \end_layout
2773
2774 \begin_layout Standard
2775 An example without a border and with lime background color:
2776 \begin_inset Newline newline
2777 \end_inset
2778
2779
2780 \begin_inset Flex PDFAction
2781 status open
2782
2783 \begin_layout Plain Layout
2784 \begin_inset Argument 1
2785 status open
2786
2787 \begin_layout Plain Layout
2788 SaveAs
2789 \end_layout
2790
2791 \end_inset
2792
2793
2794 \begin_inset ERT
2795 status collapsed
2796
2797 \begin_layout Plain Layout
2798
2799
2800 \backslash
2801 colorbox{lime}{
2802 \end_layout
2803
2804 \end_inset
2805
2806
2807 \begin_inset Box Frameless
2808 position "c"
2809 hor_pos "c"
2810 has_inner_box 1
2811 inner_pos "c"
2812 use_parbox 1
2813 use_makebox 0
2814 width "4cm"
2815 special "none"
2816 height "2in"
2817 height_special "totalheight"
2818 status open
2819
2820 \begin_layout Plain Layout
2821 \noindent
2822 \begin_inset ERT
2823 status collapsed
2824
2825 \begin_layout Plain Layout
2826
2827
2828 \backslash
2829 centering
2830 \end_layout
2831
2832 \end_inset
2833
2834  Save form as
2835 \end_layout
2836
2837 \end_inset
2838
2839
2840 \begin_inset ERT
2841 status collapsed
2842
2843 \begin_layout Plain Layout
2844
2845 }
2846 \end_layout
2847
2848 \end_inset
2849
2850
2851 \end_layout
2852
2853 \end_inset
2854
2855
2856 \end_layout
2857
2858 \begin_layout PDF Link Setup
2859 pdfborder={0 0 1}, menubordercolor={1 0 0}
2860 \end_layout
2861
2862 \begin_layout Section
2863 Dynamic form fields
2864 \end_layout
2865
2866 \begin_layout Standard
2867 It is also possible to have dynamic form fields.
2868  This means that depending on the actions of the user fields can (dis)appear
2869  or change their appearance.
2870  To use this feature, add these lines to your document preamble:
2871 \end_layout
2872
2873 \begin_layout Standard
2874
2875 \series bold
2876
2877 \backslash
2878 usepackage[pdftex]{insdljs}
2879 \begin_inset Newline newline
2880 \end_inset
2881
2882
2883 \backslash
2884 pdfcatalog{/AA
2885 \backslash
2886 the
2887 \backslash
2888 pdflastobj
2889 \backslash
2890 space 0 R}
2891 \end_layout
2892
2893 \begin_layout Standard
2894 Then add the necessary JavaScript code to your document LaTeX preamble or
2895  as TeX code to your document.
2896  For info about JavaScript, see its documentation,
2897 \begin_inset CommandInset citation
2898 LatexCommand cite
2899 key "JavaScript"
2900
2901 \end_inset
2902
2903 .
2904 \end_layout
2905
2906 \begin_layout Standard
2907 \begin_inset ERT
2908 status collapsed
2909
2910 \begin_layout Plain Layout
2911
2912
2913 \backslash
2914 ifinsdljs
2915 \end_layout
2916
2917 \end_inset
2918
2919
2920 \begin_inset Note Note
2921 status open
2922
2923 \begin_layout Plain Layout
2924 The following section will only be displayed when the LaTeX package
2925 \series bold
2926 insdljs
2927 \series default
2928  is installed.
2929 \end_layout
2930
2931 \end_inset
2932
2933
2934 \end_layout
2935
2936 \begin_layout Standard
2937 For the following choice menu this JavaScript code was used:
2938 \end_layout
2939
2940 \begin_layout Standard
2941 \begin_inset listings
2942 lstparams "language=TeX"
2943 inline false
2944 status open
2945
2946 \begin_layout Plain Layout
2947
2948
2949 \backslash
2950 begin{insDLJS}[exaaae]{exaaae}{JavaScript}
2951 \end_layout
2952
2953 \begin_layout Plain Layout
2954
2955  function validateTime(){
2956 \end_layout
2957
2958 \begin_layout Plain Layout
2959
2960   this.delay = true;
2961 \end_layout
2962
2963 \begin_layout Plain Layout
2964
2965   if((event.value == "u") || (event.value == "unlimited")) {
2966 \end_layout
2967
2968 \begin_layout Plain Layout
2969
2970    this.getField("from").display = display.hidden;
2971 \end_layout
2972
2973 \begin_layout Plain Layout
2974
2975    this.getField("to").display = display.hidden;
2976 \end_layout
2977
2978 \begin_layout Plain Layout
2979
2980   } else {
2981 \end_layout
2982
2983 \begin_layout Plain Layout
2984
2985    this.getField("from").display = display.visible;
2986 \end_layout
2987
2988 \begin_layout Plain Layout
2989
2990    this.getField("to").display = display.visible;
2991 \end_layout
2992
2993 \begin_layout Plain Layout
2994
2995    this.getField("from").setFocus();
2996 \end_layout
2997
2998 \begin_layout Plain Layout
2999
3000   }
3001 \end_layout
3002
3003 \begin_layout Plain Layout
3004
3005   this.delay = false;
3006 \end_layout
3007
3008 \begin_layout Plain Layout
3009
3010  }
3011 \end_layout
3012
3013 \begin_layout Plain Layout
3014
3015
3016 \backslash
3017 end{insDLJS}
3018 \end_layout
3019
3020 \end_inset
3021
3022
3023 \end_layout
3024
3025 \begin_layout Standard
3026 \begin_inset Note Greyedout
3027 status open
3028
3029 \begin_layout Plain Layout
3030
3031 \series bold
3032 Note:
3033 \series default
3034
3035 \emph on
3036 All
3037 \emph default
3038  JavaScript funtions must be inserted into the same
3039 \family sans
3040 insDLJS
3041 \family default
3042  environment.
3043 \end_layout
3044
3045 \end_inset
3046
3047
3048 \end_layout
3049
3050 \begin_layout Standard
3051 The
3052 \family sans
3053 PDF
3054 \begin_inset space ~
3055 \end_inset
3056
3057 form
3058 \begin_inset space ~
3059 \end_inset
3060
3061 parameters
3062 \family default
3063  of the following choice menu are
3064 \begin_inset Newline newline
3065 \end_inset
3066
3067
3068 \series bold
3069 name=contract,radio,default=tl,validate={validateTime();}
3070 \end_layout
3071
3072 \begin_layout Standard
3073 \begin_inset Flex ChoiceMenu
3074 status open
3075
3076 \begin_layout Plain Layout
3077 \begin_inset Argument 1
3078 status open
3079
3080 \begin_layout Plain Layout
3081 name=contract,radio,default=tl,validate=
3082 \begin_inset ERT
3083 status collapsed
3084
3085 \begin_layout Plain Layout
3086
3087 {
3088 \end_layout
3089
3090 \end_inset
3091
3092 validateTime();
3093 \begin_inset ERT
3094 status collapsed
3095
3096 \begin_layout Plain Layout
3097
3098 }
3099 \end_layout
3100
3101 \end_inset
3102
3103
3104 \end_layout
3105
3106 \end_inset
3107
3108 term-limited=tl, unlimited=u
3109 \begin_inset Argument 2
3110 status open
3111
3112 \begin_layout Plain Layout
3113 Job contract:
3114 \end_layout
3115
3116 \end_inset
3117
3118
3119 \end_layout
3120
3121 \end_inset
3122
3123
3124 \begin_inset VSpace defskip
3125 \end_inset
3126
3127
3128 \end_layout
3129
3130 \begin_layout Standard
3131 \begin_inset Tabular
3132 <lyxtabular version="3" rows="3" columns="2">
3133 <features rotate="0" tabularvalignment="middle">
3134 <column alignment="left" valignment="top">
3135 <column alignment="center" valignment="top">
3136 <row>
3137 <cell alignment="left" valignment="top" usebox="none">
3138 \begin_inset Text
3139
3140 \begin_layout Plain Layout
3141 From:
3142 \end_layout
3143
3144 \end_inset
3145 </cell>
3146 <cell alignment="center" valignment="top" usebox="none">
3147 \begin_inset Text
3148
3149 \begin_layout Plain Layout
3150 \begin_inset Flex TextField
3151 status open
3152
3153 \begin_layout Plain Layout
3154 \begin_inset Argument 1
3155 status open
3156
3157 \begin_layout Plain Layout
3158 name=from,width=10em
3159 \end_layout
3160
3161 \end_inset
3162
3163
3164 \end_layout
3165
3166 \end_inset
3167
3168
3169 \end_layout
3170
3171 \end_inset
3172 </cell>
3173 </row>
3174 <row>
3175 <cell alignment="center" valignment="top" usebox="none">
3176 \begin_inset Text
3177
3178 \begin_layout Plain Layout
3179
3180 \end_layout
3181
3182 \end_inset
3183 </cell>
3184 <cell alignment="center" valignment="top" usebox="none">
3185 \begin_inset Text
3186
3187 \begin_layout Plain Layout
3188 \begin_inset VSpace -1.5mm
3189 \end_inset
3190
3191
3192 \end_layout
3193
3194 \end_inset
3195 </cell>
3196 </row>
3197 <row>
3198 <cell alignment="left" valignment="top" usebox="none">
3199 \begin_inset Text
3200
3201 \begin_layout Plain Layout
3202 To:
3203 \end_layout
3204
3205 \end_inset
3206 </cell>
3207 <cell alignment="center" valignment="top" usebox="none">
3208 \begin_inset Text
3209
3210 \begin_layout Plain Layout
3211 \begin_inset Flex TextField
3212 status open
3213
3214 \begin_layout Plain Layout
3215 \begin_inset Argument 1
3216 status open
3217
3218 \begin_layout Plain Layout
3219 name=to,width=10em
3220 \end_layout
3221
3222 \end_inset
3223
3224
3225 \end_layout
3226
3227 \end_inset
3228
3229
3230 \end_layout
3231
3232 \end_inset
3233 </cell>
3234 </row>
3235 </lyxtabular>
3236
3237 \end_inset
3238
3239
3240 \end_layout
3241
3242 \begin_layout Standard
3243 \begin_inset VSpace bigskip
3244 \end_inset
3245
3246
3247 \end_layout
3248
3249 \begin_layout Standard
3250 To check and assure that the user only enters a number to a text field you
3251  can for example use this JavaScript code:
3252 \end_layout
3253
3254 \begin_layout Standard
3255 \begin_inset listings
3256 lstparams "language=TeX"
3257 inline false
3258 status open
3259
3260 \begin_layout Plain Layout
3261
3262 function checkNumber() {
3263 \end_layout
3264
3265 \begin_layout Plain Layout
3266
3267  event.rc = true;
3268 \end_layout
3269
3270 \begin_layout Plain Layout
3271
3272  if (!Number(event.value)) {
3273 \end_layout
3274
3275 \begin_layout Plain Layout
3276
3277   app.alert("Value must be a number!");
3278 \end_layout
3279
3280 \begin_layout Plain Layout
3281
3282   event.value = "";
3283 \end_layout
3284
3285 \begin_layout Plain Layout
3286
3287  } else {
3288 \end_layout
3289
3290 \begin_layout Plain Layout
3291
3292   event.target.textColor = color.green;
3293 \end_layout
3294
3295 \begin_layout Plain Layout
3296
3297 }
3298 \end_layout
3299
3300 \end_inset
3301
3302
3303 \end_layout
3304
3305 \begin_layout Standard
3306 An example text field:
3307 \begin_inset Flex TextField
3308 status open
3309
3310 \begin_layout Plain Layout
3311 \begin_inset Argument 1
3312 status open
3313
3314 \begin_layout Plain Layout
3315 name=onlyNumbers, align=1, validate=
3316 \begin_inset ERT
3317 status collapsed
3318
3319 \begin_layout Plain Layout
3320
3321 {
3322 \end_layout
3323
3324 \end_inset
3325
3326 checkNumber();
3327 \begin_inset ERT
3328 status collapsed
3329
3330 \begin_layout Plain Layout
3331
3332 }
3333 \end_layout
3334
3335 \end_inset
3336
3337
3338 \end_layout
3339
3340 \end_inset
3341
3342
3343 \end_layout
3344
3345 \end_inset
3346
3347
3348 \end_layout
3349
3350 \begin_layout Standard
3351 \begin_inset ERT
3352 status collapsed
3353
3354 \begin_layout Plain Layout
3355
3356
3357 \backslash
3358 else
3359 \end_layout
3360
3361 \end_inset
3362
3363
3364 \begin_inset Note Note
3365 status open
3366
3367 \begin_layout Plain Layout
3368 The following will be displayed when the LaTeX package
3369 \series bold
3370 insdljs
3371 \series default
3372  is not installed:
3373 \end_layout
3374
3375 \end_inset
3376
3377
3378 \end_layout
3379
3380 \begin_layout Standard
3381 You need to install the package
3382 \series bold
3383 insdljs
3384 \series default
3385  to see the content of this section in the output.
3386 \end_layout
3387
3388 \begin_layout Standard
3389 \begin_inset ERT
3390 status collapsed
3391
3392 \begin_layout Plain Layout
3393
3394
3395 \backslash
3396 fi
3397 \end_layout
3398
3399 \end_inset
3400
3401
3402 \end_layout
3403
3404 \begin_layout End PDF Form
3405 \begin_inset Note Note
3406 status open
3407
3408 \begin_layout Plain Layout
3409 keep this emtpy
3410 \end_layout
3411
3412 \end_inset
3413
3414
3415 \end_layout
3416
3417 \begin_layout Section
3418 General notes and hints
3419 \end_layout
3420
3421 \begin_layout Itemize
3422 Submitting and applying data requires that all form fields have a name.
3423 \end_layout
3424
3425 \begin_layout Itemize
3426 All braces, brackets, backslashes and quote characters in form parameters
3427  must be inserted as TeX code!
3428 \end_layout
3429
3430 \begin_layout Itemize
3431 It is not possible to create a PDF form using XeTeX.
3432  Use either the LyX export formats
3433 \family sans
3434 PDF (pdflatex)
3435 \family default
3436  or
3437 \family sans
3438 PDF (LuaTeX)
3439 \family default
3440 .
3441 \end_layout
3442
3443 \begin_layout Itemize
3444 To be able to use all kinds of colors and color definitions you must load
3445  the LaTeX package
3446 \series bold
3447 xcolor
3448 \series default
3449  in the document preamble this way:
3450 \begin_inset Newline newline
3451 \end_inset
3452
3453
3454 \series bold
3455
3456 \backslash
3457 usepackage[svgnames,rgb]{xcolor}
3458 \end_layout
3459
3460 \begin_layout Itemize
3461 To see in
3462 \emph on
3463 Adobe Reader
3464 \emph default
3465  and
3466 \emph on
3467 Acrobat
3468 \emph default
3469  custom background colors you must disable in these programs to highlight
3470  the available form fields in the PDF.
3471 \end_layout
3472
3473 \begin_layout Bibliography
3474 \begin_inset CommandInset bibitem
3475 LatexCommand bibitem
3476 key "JavaScript"
3477
3478 \end_inset
3479
3480
3481 \begin_inset CommandInset href
3482 LatexCommand href
3483 name "JavaScript reference"
3484 target "https://developer.mozilla.org/en/docs/Web/JavaScript/Reference"
3485
3486 \end_inset
3487
3488
3489 \end_layout
3490
3491 \begin_layout Bibliography
3492 \begin_inset CommandInset bibitem
3493 LatexCommand bibitem
3494 key "hyperref"
3495
3496 \end_inset
3497
3498
3499 \begin_inset CommandInset href
3500 LatexCommand href
3501 name "Documentation"
3502 target "http://mirrors.ctan.org/macros/latex/contrib/hyperref/doc/manual.pdf"
3503
3504 \end_inset
3505
3506  of the LaTeX package
3507 \series bold
3508 hyperref
3509 \end_layout
3510
3511 \begin_layout Bibliography
3512 \begin_inset CommandInset bibitem
3513 LatexCommand bibitem
3514 key "pifont"
3515
3516 \end_inset
3517
3518
3519 \begin_inset CommandInset href
3520 LatexCommand href
3521 name "Documentation"
3522 target "http://mirrors.ctan.org/macros/latex/required/psnfss/psnfss2e.pdf"
3523
3524 \end_inset
3525
3526  of the LaTeX package
3527 \series bold
3528 pifont
3529 \end_layout
3530
3531 \end_body
3532 \end_document