LassoScript Utility
Basics Browse Detail

[PDF_Doc->AddComboBox]

Tag Link [PDF_Doc->AddComboBox] Category PDF
Type Member Source Available Yes
Support Preferred Version 6.0
Change Unchanged Data Source Any
Output Type None Security File
Implementation LJAPI Sets Lasso 8.5, Lasso 8.0, Lasso 7.0, Lasso 6.0

Description

[PDF_Doc->AddComboBox] adds a pull-down menu to a form in a [PDF_Doc] variable. A required -Name parameter specifies the name of the pull-down menu, and a required -Values parameter specifies the array of values contained in the menu (Value1, Value2, etc.). An -Options paramter may be used instead of the -Values paramter that specifies a pair for each value. The first element in the pair is the value to be used upon form submission, and the second element is the human-readable label to be used for display only. An optional -Default parameter specifies the name of a default value selected. An optional -Editiable parameter specifies that the user may edit the values on the menu. An optional -Font parameter may be used to specify a [PDF_Font] variable to be userd as the text font.

Syntax

[$PDF_Doc->(AddComboBox:
-Name='Combo_Box_Name',
-Values=(Array: 'Value1', 'Value2', 'Value3'),
-Default='Value1',
-Editable,
-Font=(PDF_Font),
-Left=72.0, -Top=72.0, Width=128.0, Height=128.0 )]

[$PDF_Doc->(AddComboBox:
-Name='Combo_Box_Name',
-Options=(Array: (Pair: (1)=(Value1)), (Pair: (2)=(Value2)), (Pair: (3)=(Value3))),
-Default='1',
-Editable,
-Font=(PDF_Font),
-Left=72.0, -Top=72.0, Width=128.0, Height=128.0 )]

Parameters

Required Parameters
-Name Specifies the name of the pull-down menu.
-Values Specifies an values contained in the pull-down menu ('Value1', 'Value2', etc.).
-Left Specifies the placement of the left side of the form element from the top left corner of the current page in points.
-Top Specifies the placement of the form element from the top of the current page in points.
-Width Specifies the width of the form element in points. Requires a decimal value.
-Height Specifies the height of the form element in points. Requires a decimal value.
-Font Sets the font for the text. Requires the name of a [PDF_Font] variable.
Optional Parameters
-Default Specifies the name of a default value selected.
-Options May be used instead of the -Values parameter to specify a pair for each value (('Value1', 'Value1'), ('Value2', 'Value2')). The first element in the pair is the value to be used upon form submission, and the second element is the human-readable label to be used for display only.
-Editable Specifies that the user may edit the values on the menu.

Change Notes

The -Top parameter was changed in LDML 7 to offset the form element from the page top as expected rather than the page bottom.

Examples

See the Lasso 8 Language Guide for examples of how to use this tag.

Related Tags

Category Tags

Substitution
[PDF_Barcode]
[PDF_Color]
[PDF_Font]
[PDF_Image]
[PDF_List]
[PDF_Read]
[PDF_Table]
[PDF_Text]
Process
[PDF_Serve]
Member
[PDF_Barcode->GenerateChecksum]
[PDF_Barcode->GetBarHeight]
[PDF_Barcode->GetBarMultiplier]
[PDF_Barcode->GetBarWidth]
[PDF_Barcode->GetBaseline]
[PDF_Barcode->GetCode]
[PDF_Barcode->GetFont]
[PDF_Barcode->GetSize]
[PDF_Barcode->GetTextAlignment]
[PDF_Barcode->GetTextSize]
[PDF_Barcode->GetType]
[PDF_Barcode->SetBarHeight]
[PDF_Barcode->SetBarMultiplier]
[PDF_Barcode->SetBarWidth]
[PDF_Barcode->SetBaseline]
[PDF_Barcode->SetCode]
[PDF_Barcode->SetFont]
[PDF_Barcode->SetGenerateChecksum]
[PDF_Barcode->SetShowChecksum]
[PDF_Barcode->SetTextAlignment]
[PDF_Barcode->SetTextSize]
[PDF_Barcode->ShowChecksum]
[PDF_Barcode->ShowCode39StartStop]
[PDF_Barcode->ShowEANGuardBars]
[PDF_Font->GetColor]
[PDF_Font->GetEncoding]
[PDF_Font->GetFace]
[PDF_Font->GetFullFontName]
[PDF_Font->GetPSFontName]
[PDF_Font->GetSize]
[PDF_Font->GetSupportedEncodings]
[PDF_Font->IsTrueType]
[PDF_Font->SetColor]
[PDF_Font->SetEncoding]
[PDF_Font->SetFace]
[PDF_Font->SetSize]
[PDF_Font->SetUnderline]
[PDF_Font->TextWidth]
[PDF_List->Add]
[PDF_Read->AddJavaScript]
[PDF_Read->ExportFDF]
[PDF_Read->FieldNames]
[PDF_Read->FieldType]
[PDF_Read->FieldValue]
[PDF_Read->GetHeaders]
[PDF_Read->ImportFDF]
[PDF_Read->JavaScript]
[PDF_Read->PageCount]
[PDF_Read->PageSize]
[PDF_Read->Save]
[PDF_Read->SetFieldValue]
[PDF_Read->SetPageRange]
[PDF_Table->Add]
[PDF_Table->GetAbsWidth]
[PDF_Table->GetAlignment]
[PDF_Table->GetBorderColor]
[PDF_Table->GetBorderWidth]
[PDF_Table->GetColumnCount]
[PDF_Table->GetPadding]
[PDF_Table->GetRowCount]
[PDF_Table->GetSpacing]
[PDF_Table->Insert]
[PDF_Table->Remove]
[PDF_Table->SetAlignment]
[PDF_Table->SetBorderColor]
[PDF_Table->SetBorderWidth]
[PDF_Table->SetPadding]
[PDF_Table->SetSpacing]
[PDF_Text->Add]