Show / Hide Table of Contents

# Class ComboBoxWidget

An object representing a combo box used in a PDF Form.

##### Inheritance

object
Annot
Widget
ComboBoxWidget

##### Implements

IDisposable

##### Inherited Members

Widget.Create(SDFDoc, Rect, Field)
Widget.GetField()
Widget.GetHighlightingMode()
Widget.SetHighlightingMode(Widget.HighlightingMode)
Widget.GetAction()
Widget.SetAction(Action)
Widget.GetBorderColorCompNum()
Widget.GetBorderColor()
Widget.SetBorderColor(ColorPt, int)
Widget.GetBackgroundColorCompNum()
Widget.GetBackgroundColor()
Widget.SetBackgroundColor(ColorPt, int)
Widget.GetStaticCaptionText()
Widget.SetStaticCaptionText(string)
Widget.GetRolloverCaptionText()
Widget.SetRolloverCaptionText(string)
Widget.GetMouseDownCaptionText()
Widget.SetMouseDownCaptionText(string)
Widget.GetStaticIcon()
Widget.SetStaticIcon(Obj)
Widget.GetRolloverIcon()
Widget.SetRolloverIcon(Obj)
Widget.GetMouseDownIcon()
Widget.SetMouseDownIcon(Obj)
Widget.GetScaleType()
Widget.SetScaleType(Widget.ScaleType)
Widget.GetIconCaptionRelation()
Widget.SetIconCaptionRelation(Widget.IconCaptionRelation)
Widget.GetScaleCondition()
Widget.SetScaleCondition(Widget.ScaleCondition)
Widget.GetHIconLeftOver()
Widget.SetHIconLeftOver(double)
Widget.GetVIconLeftOver()
Widget.SetVIconLeftOver(double)
Widget.GetFitFull()
Widget.SetFitFull(bool)
Widget.SetTextColor(ColorPt, int)
Widget.GetTextColor()
Widget.GetTextColorCompNum()
Widget.SetFontSize(double)
Widget.GetFontSize()
Widget.SetFont(Font)
Widget.GetFont()
Annot.Dispose()
Annot.Dispose(bool)
Annot.GetHandleInternal()
Annot.GetRefHandleInternal()
Annot.CreateInternal(IntPtr, object)
Annot.Create(SDFDoc, Annot.Type, Rect)
Annot.op_Assign(Annot)
Annot.Equals(object)
Annot.IsValid()
Annot.GetSDFObj()
Annot.GetType()
Annot.IsMarkup()
Annot.GetRect()
Annot.GetVisibleContentBox()
Annot.SetRect(Rect)
Annot.GetContents()
Annot.SetContents(string)
Annot.GetPage()
Annot.SetPage(Page)
Annot.GetUniqueID()
Annot.SetUniqueID(string)
Annot.GetDate()
Annot.SetDate(Date)
Annot.GetFlag(Annot.Flag)
Annot.SetFlag(Annot.Flag, bool)
Annot.GetBorderStyle()
Annot.SetBorderStyle(Annot.BorderStyle)
Annot.GetAppearance()
Annot.GetAppearance(Annot.AnnotationState)
Annot.GetAppearance(Annot.AnnotationState, string)
Annot.SetAppearance(Obj)
Annot.SetAppearance(Obj, Annot.AnnotationState)
Annot.SetAppearance(Obj, Annot.AnnotationState, string)
Annot.RemoveAppearance()
Annot.RemoveAppearance(Annot.AnnotationState)
Annot.RemoveAppearance(Annot.AnnotationState, string)
Annot.Flatten(Page)
Annot.GetActiveAppearanceState()
Annot.SetActiveAppearanceState(string)
Annot.GetColorAsRGB()
Annot.GetColorAsCMYK()
Annot.GetColorAsGray()
Annot.GetColorCompNum()
Annot.SetColor(ColorPt, int)
Annot.SetColor(ColorPt)
Annot.GetStructParent()
Annot.SetStructParent(int)
Annot.GetOptionalContent()
Annot.SetOptionalContent(Obj)
Annot.Resize(Rect)
Annot.GetRotation()
Annot.SetRotation(int)
Annot.RefreshAppearance()
Annot.GetCustomData(string)
Annot.SetCustomData(string, string)
Annot.DeleteCustomData(string)
object.Equals(object, object)
object.GetHashCode()
object.MemberwiseClone()
object.ReferenceEquals(object, object)
object.ToString()

###### Namespace: pdftron.PDF.Annots

###### Assembly: PDFTronDotNet.dll

##### Syntax

    public class ComboBoxWidget : Widget, IDisposable

### Constructors

#### ComboBoxWidget(Annot)

Creates a Widget annotation and initialize it using given annotation object.

##### Declaration

    public ComboBoxWidget(Annot ann)

##### Parameters

Type | Name | Description
--- | --- | ---
Annot | ann | The annotation object to use.

##### Remarks

The constructor does not copy any data, but is instead the logical equivalent of a type cast.

##### Exceptions

Type | Condition
--- | ---
PDFNetException | PDFNetException the PDFNet exception

#### ComboBoxWidget(Obj)

Creates a Combo Box Widget annotation and initialize it using given Cos/SDF object.

##### Declaration

    public ComboBoxWidget(Obj d)

##### Parameters

Type | Name | Description
--- | --- | ---
Obj | d | the object to use to initialize the ComboBoxWidget

##### Remarks

The constructor does not copy any data, but is instead the logical equivalent of a type cast.

### Methods

#### AddOption(string)

Add an option to Combo Box widget.

##### Declaration

    public void AddOption(string option)

##### Parameters

Type | Name | Description
--- | --- | ---
string | option | The option to add

##### Exceptions

Type | Condition
--- | ---
PDFNetException | PDFNetException the PDFNet exception

#### AddOptions(string[])

Adds multiple options to Combo Box widget.

##### Declaration

    public void AddOptions(string[] opts)

##### Parameters

Type | Name | Description
--- | --- | ---
string[] | opts | The options to add

##### Exceptions

Type | Condition
--- | ---
PDFNetException | PDFNetException the PDFNet exception

#### Create(PDFDoc, Rect)

Creates a new Combo Box Widget annotation, in the specified document with a default Field name.

##### Declaration

    public static ComboBoxWidget Create(PDFDoc doc, Rect pos)

##### Parameters

Type | Name | Description
--- | --- | ---
PDFDoc | doc | The document to which the annotation is added.
Rect | pos | A rectangle specifying the annotation's bounds, specified in user space coordinates.

##### Returns

Type | Description
--- | ---
ComboBoxWidget | A newly created blank Widget annotation.

##### Exceptions

Type | Condition
--- | ---
PDFNetException | PDFNetException the PDFNet exception

#### Create(PDFDoc, Rect, string)

Creates a new Combo Box Widget annotation, in the specified document.

##### Declaration

    public static ComboBoxWidget Create(PDFDoc doc, Rect pos, string field_name)

##### Parameters

Type | Name | Description
--- | --- | ---
PDFDoc | doc | The document to which the annotation is added.
Rect | pos | A rectangle specifying the annotation's bounds, specified in user space coordinates.
string | field_name | The name of the field for which to create a ComboBox widget

##### Returns

Type | Description
--- | ---
ComboBoxWidget | A newly created blank Widget annotation.

##### Exceptions

Type | Condition
--- | ---
PDFNetException | PDFNetException the PDFNet exception

#### Create(PDFDoc, Rect, Field)

Creates a new Combo Box Widget annotation, in the specified document.

##### Declaration

    public static ComboBoxWidget Create(PDFDoc doc, Rect pos, Field field)

##### Parameters

Type | Name | Description
--- | --- | ---
PDFDoc | doc | The document to which the annotation is added.
Rect | pos | A rectangle specifying the annotation's bounds, specified in user space coordinates.
Field | field | The field for which to create a Text widget

##### Returns

Type | Description
--- | ---
ComboBoxWidget | A newly created blank Widget annotation.

##### Exceptions

Type | Condition
--- | ---
PDFNetException | PDFNetException the PDFNet exception

#### GetSelectedOption()

Retrieves the option selected in the ComboBox widget

##### Declaration

    public string GetSelectedOption()

##### Returns

Type | Description
--- | ---
string | The option selected in the ComboBox widget

##### Exceptions

Type | Condition
--- | ---
PDFNetException | PDFNetException the PDFNet exception

#### SetSelectedOption(string)

Selects the given option in the Combo Box widget

##### Declaration

    public void SetSelectedOption(string option)

##### Parameters

Type | Name | Description
--- | --- | ---
string | option | The option to select

##### Exceptions

Type | Condition
--- | ---
PDFNetException | PDFNetException the PDFNet exception

### Implements

IDisposable