GSAK (Geocaching Swiss Army Knife)
Contents - Index

Forms - Combobox

A box that provides a drop down list of choices

Supported properties

Color - This is a number (Use "Macro=>Color picker" to select the corresponding color number (though the forms designer will automatically do this for you).

Container - The control that the combobox control "belongs" to. Every control has a container, and each control defaults to having the form as its container. Only a named Groupbox can be specified for the Container property (or blank to default to the form). When using the properties Top and Left, they are always relative to the control's container. Groupbox containers can be used to group like controls together. Note: You must always define the container before any controls that use this container. 

DirectInput - Yes, No. Use to specify that the user can directly input any value at all in the combobox. Currently, when you add a combobox to a form you can only select from the list of values for that combo box. This property when set to Yes will allow the user to directly enter any value rather than only those listed. Basically it turns the control into a combination of edit/combobox. If a user enters text, this text will not be added to the list of values for selection in subsequent calls. If this is desired, you will need to add the new value to the list of values manually.

Display - Number of entries to display. Combo boxes on forms default to 8 entries before you see the scroll bars to access more than 8. This property allows you to control this value

ExitOnChange - Yes, No. Setting this value to Yes will cause the form to exit immediately you change the combox entry. Use this option when you want to  change something on the form (and then redisplay it) because a combobox selection has changed. Note: This can be problematic if you have also set the DirectInput property to "Yes". This is because the ExitOnChange event is fired immediately when something in the combobox has changed. So just keying in one character from the keyboard will cause the form to exit - this probably not being the behaviour you want. 

Enabled - Yes, No. The enabled property set to "No" will automatically show the control in the "gray ghost" outline and prevent the user moving focus to it.

Height - Vertical height in pixels

Left - Position from the Left, which is the number of pixels relative to the container

Name - The combobox control name

TabOrder - The Taborder property applies to all controls than can receive input focus and regulates the order the controls will jump to when using tab on the keyboard. This means it doesn't matter what order the controls are defined in your code - the taborder property will decide your tabbing order. Taborder is a "smart" property. For example, if you set the value of a control to say 7, then any existing control that has a tab order of 7 will automatically be changed to 8, and all higher tab numbers will be incremented by one.
Also note that the tab order is relative to the container, so controls inside a group box have their own tabbing order starting at zero. The group box itself has a tabbing order within its container as well (usually the form) Don't be alarmed if you update your form and see taborder values starting at 8. The macro form has a few "hidden" controls that take up tab slots. You can actually use any number you like for the Taborder (even zero). You just need to remember that tabbing order is respected in an ascending numerical sequence

Top - Position from the top, which is the number of pixels relative to the container

Type - The control type, which must always be "Combobox"

Values - Specify the caption/label for each corresponding combobox entry. Each single caption/label should be separated by a ; (semi colon). If you need your elements in the combo box to actually show a ; (semi colon) then used *semi* (including the asterisk). This special keyword will be converted to ; when your combobox is displayed. 

Visible - Yes, No. If set to "No" then the button will not be visible on the form

Width - Horizontal length in pixels

Copyright 2004-2019 CWE Computer Services  
Privacy Policy Contact