|

Properties


(table) A table containing the checkbox object's properties indexed by the following keys:



KEY


TYPE DESCRIPTION


Checked


boolean


True if the checkbox should be checked, false if it should be unchecked.


CONSTANT


VALUE DESCRIPTION


ANSI_CHARSET


0


ANSI character set.


CONSTANT


VALUE DESCRIPTION


FW_DONTCARE


0


Font weight not specified.


FW_THIN


100


Font weight 'thin'.


FW_EXTRALIGHT


200


Font weight 'extra-light'.


FW_LIGHT


300


Font weight 'light'.


FW_NORMAL


400


Font weight 'normal'.


FW_MEDIUM


500


Font weight 'medium'.


FW_SEMIBOLD


600


Font weight 'semi-bold'.


FW_BOLD


700


Font weight 'bold'.


FW_EXTRABOLD


800


Font weight 'extra bold'.


FW_HEAVY


900


Font weight 'heavy'.



Text


string


The text to be displayed in the checkbox object.


FontName


string


The font name.


FontSize


number


The font size (in points).


FontStrikeout


boolean


True if the font should be set to strikeout, false if it should not be.


FontUnderline


boolean


True if the font should be set to underline, false if it should not be.


FontAntiAlias


boolean


True if the font should be set to anti alias, false if it should not be.


FontItalic


boolean


True if the font should be set to italic, false if it should not be.


FontWeight


number


The weight of the font (how 'dark' the text will appear):


FontScript


number


The character set in use by the radiobutton object:


BALTIC_CHARSET


186


Baltic character set.


CHINESEBIG5_CHARSET


136


Chinese character set.


DEFAULT_CHARSET


1


Default character set.


EASTEUROPE_CHARSET


238


Eastern European character set.


GB2312_CHARSET


134


GB2312 character set.


GREEK_CHARSET


161


Greek character set.


HANGUL_CHARSET


129


Hangul character set.


MAC_CHARSET


77


MAC character set.


OEM_CHARSET


255


OEM character set.


RUSSIAN_CHARSET


204


Russian character set.


SHIFTJIS_CHARSET


128


Shiftjis character set.


SYMBOL_CHARSET


2


Symbol character set.


TURKISH_CHARSET


162


Turkish character set.



TextAlignment


number


The alignment of the text in the checkbox object. Choose from:


CONSTANT


VALUE DESCRIPTION


ALIGN_LEFT


0


Text is left aligned.


ALIGN_CENTER


1


Text is center aligned.

ALIGN_RIGHT

2

Text is right aligned.


CONSTANT


VALUE DESCRIPTION


READ_STANDARD


0


Display the characters left to right.


READ_RIGHT_TO_LEFT


1


Display the characters right to left.


CONSTANT


VALUE DESCRIPTION


BTN_ALIGN_LEFT


0


Button is to the left of the text.


BTN_ALIGN_RIGHT


1


Button is to the right of the text.

image



ALIGN_RIGHT 2 Text is right aligned.


ButtonAlignment


number


The alignment of the button in the checkbox object:


ReadOrder


number


How text should be displayed in the checkbox object:


ColorNormal


number


The 'normal' color of the checkbox object's text.


ColorHighlight


number


The 'highlight' color of the checkbox object's text.


ColorDisabled


number


The 'disabled' color of the checkbox object's text.


ColorDown


number


The 'down' color of the checkbox object's text.


Enabled


boolean


True if the checkbox object should be enabled, false if it should not be.


Visible


boolean


True if the checkbox object should be visible, false if it should not be.


X


number


The horizontal position (in pixels) of the top left corner of the checkbox object in relation to the current page or dialog.


Note: The top left corner of the current page or dialog has an X value of 0


Y


number


The vertical position (in pixels) of the top left corner of the checkbox object in relation to the current page or dialog.


Note: The top left corner of the current page or dialog has


CONSTANT


VALUE DESCRIPTION


CURSOR_ARROW


0


Standard mouse arrow cursor.


CURSOR_HAND


1


Hand cursor.


CURSOR_BLACK_ARROW


2


Black arrow cursor.


CURSOR_CROSSHAIR


3


Crosshair cursor.


CURSOR_EXPLORE


4


Explore cursor.


CURSOR_HELP


5


Help cursor.


CURSOR_MAGNIFY


6


Magnify cursor.


CURSOR_MEDIA


7


Media cursor.


CURSOR_MONEY


8


Money cursor.


CURSOR_NOTEPAD


9


Notepad cursor.


CURSOR_PENCIL


10


Pencil cursor.


CURSOR_PRINTER


11


Printer cursor.


CURSOR_SPEAKER


12


Speaker cursor.


CURSOR_UP_ARROW


13


Up arrow cursor.



a Y value of 0


Width


number


The width (in pixels) of the checkbox object.


Height


number


The height (in pixels) of the checkbox object.


TooltipText


string


The mouseover tooltip of the checkbox object. Tip: If you want a "&" character in the text, you must enter "&&&".


Cursor


number


The mouse cursor that should be displayed when the mouse is over the checkbox object:



ResizeLeft


boolean


True if the left side of the object should move when the application is resized, false if it should not.


ResizeRight


boolean


True if the right side of the object should move when the application is resized, false if it should not.


ResizeTop


boolean


True if the top of the object should move when the application is resized, false if it should not.


ResizeBottom


boolean


True if the bottom of the object should move when the application is resized, false if it should not.


HighlightSound


number


The type of sound that should be played when the mouse moves over the object.


HighlightSoundFile


string


The path to the object's custom highlight sound file.


ClickSound


number


The type of sound that should be played when the mouse clicks the object.


ClickSoundFile


string


The path to the object's custom click sound file.



CONSTANT


VALUE DESCRIPTION


SND_NONE


0


No highlight sound.


SND_STANDARD


1


Standard highlight sound.


SND_CUSTOM


2


Custom highlight sound.


CONSTANT


VALUE DESCRIPTION


SND_NONE


0


No click sound.


SND_STANDARD


1


Standard click sound.


SND_CUSTOM


2


Custom click sound.

Re t u r n s


Nothing. You can use Application.GetLastError to determine whether this action failed, and why.


See also: Related Actions


image

CheckBox.SetSize


OverviewExamples

image

CheckBox.SetSize ( string ObjectName,


number Width,


number Height )


De s cr ip t ion


Sets the size of a checkbox object.


P arame t er s


ObjectName


(string) The name of the checkbox object.


|