Open Object Rexx™
Windows OODialog Reference
Version 3.2.0 Edition
Revision 0
October 25, 2007
W. David Ashley
Rony G. Flatscher
Mark Hessling
Rick McGuire
Mark Miesfeld
Lee Peedin
Table of Contents
1.
About This Book
Who Should Use This Book
How This Book is Structured
Related Information
How to Read the Syntax Diagrams
A Note About Program Examples in this Document
Getting Help
The Rexx Language Association Mailing List
The Open Object Rexx SourceForge Site
comp.lang.rexx Newsgroup
2.
OODialog Method Reference
3.
Definition of Terms
4.
BaseDialog Class
Preparing and Running the Dialog
Init
InitAutoDetection
NoAutoDetection
AutoDetection
InitDialog
Run
Execute
ExecuteAsync
EndAsyncExecution
Popup
PopupAsChild
IsDialogActive
StopIt
HandleMessages
AsyncMessageHandling
PeekDialogMessage
ClearMessages
SendMessageToItem
Connect Event Methods
ConnectResize
ConnectMove
ConnectPosChanged
ConnectMouseCapture
ConnectHelp
ConnectKeyPress
ConnectFKeyPress
DisconnectKeyPress
HasKeyPressConnection
ConnectButton
ConnectBitmapButton
ConnectControl
ConnectDraw
ConnectList
ConnectListLeftDoubleClick
ConnectScrollBar
ConnectAllSBEvents
AddUserMsg
Connect Attribute Methods
ConnectEntryLine
ConnectComboBox
ConnectCheckBox
ConnectRadioButton
ConnectListBox
ConnectMultiListBox
AddAttribute
Get and Set Methods
GetData
SetData
ItemTitle
SetStaticText
GetEntryLine
SetEntryLine
GetListLine
SetListLine
GetMultiList
SetMultiList
GetComboLine
SetComboLine
GetRadioButton
SetRadioButton
GetCheckBox
SetCheckBox
GetValue
SetValue
GetAttrib
SetAttrib
SetDataStem
GetDataStem
Standard Event Methods
OK
Cancel
Help
Validate
Leaving
DeInstall
Combo Box Methods
AddComboEntry
InsertComboEntry
DeleteComboEntry
FindComboEntry
GetComboEntry
GetComboItems
GetCurrentComboIndex
SetCurrentComboIndex
ChangeComboEntry
ComboAddDirectory
ComboDrop
List Box Methods
GetListWidth
SetListWidth
SetListColumnWidth
AddListEntry
InsertListEntry
DeleteListEntry
FindListEntry
GetListEntry
GetListItems
GetListItemHeight
SetListItemHeight
GetCurrentListIndex
SetCurrentListIndex
ChangeListEntry
SetListTabulators
ListAddDirectory
ListDrop
Scroll Bar Methods
GetSBRange
SetSBRange
GetSBPos
SetSBPos
CombineELwithSB
DetermineSBPosition
Methods to Query Operating System Values
GetSelf
Get
GetItem
GetControlID
GetPos
GetButtonRect
GetWindowRect
GetSystemMetrics
Appearance and Behavior Methods
BackgroundColor
Show
ToTheTop
EnsureVisible
Minimize
Maximize
Restore
IsMinimized
IsMaximized
FocusItem
TabToNext
TabToPrevious
SetGroup
SetTabStop
EnableItem
DisableItem
HideItem
HideItemFast
ShowItem
ShowItemFast
HideWindow
HideWindowFast
ShowWindow
ShowWindowFast
SetWindowRect
RedrawWindow
ResizeItem
MoveItem
Center
SetWindowTitle
FileViewer Example Program
Window Draw Methods
DrawButton
RedrawRect
RedrawButton
RedrawWindowRect
ClearRect
ClearButtonRect
ClearWindowRect
Bitmap Methods
ChangeBitmapButton
GetBitmapSizeX
GetBitmapSizeY
DrawBitmap
ScrollBitmapFromTo
TiledBackgroundBitmap
BackgroundBitmap
DisplaceBitmap
GetBmpDisplacement
Device Context Methods
GetWindowDC
GetButtonDC
FreeWindowDC
FreeButtonDC
Text Methods
Write
ScrollText
ScrollInButton
ScrollButton
SetItemFont
Animated Buttons
AddAutoStartMethod
ConnectAnimatedButton
Menu Methods
ConnectMenuItem
EnableMenuItem
DisableMenuItem
CheckMenuItem
UncheckMenuItem
GrayMenuItem
SetMenuItemRadio
GetMenuItemState
Debugging Method
Dump
5.
DialogControl Class
Appearance and Behavior Methods
Show
Hide
HideFast
ShowFast
Display
Enable
Disable
Group
TabStop
Resize
Move
SetForegroundWindow
ForegroundWindow
GetID
GetStyleRaw
GetRect
SetRect
GetClientRect
GetPos
GetSize
AssignFocus
GetFocus
SetFocus
SetFocusToWindow
SetColor
Update
Title
Title=
SetTitle
Miscellaneous Dialog Control Methods
ProcessMessage
Value
Value=
AssignWindow
Connect Event Methods
ConnectKeyPress
ConnectFKeyPress
DisconnectKeyPress
HasKeyPressConnection
Draw Methods
Draw
Clear
ClearRect
Redraw
RedrawRect
RedrawClient
Conversion Methods
LogRect2AbsRect
AbsRect2LogRect
ScreenToClient
ClientToScreen
Scroll Methods
Scroll
HScrollPos
VScrollPos
SetHScrollPos
SetVScrollPos
Mouse and Cursor Methods
CursorPos
SetCursorPos
RestoreCursorShape
Cursor_Arrow
Cursor_AppStarting
Cursor_Cross
Cursor_No
Cursor_Wait
GetMouseCapture
CaptureMouse
ReleaseMouseCapture
IsMouseButtonDown
Bitmap Methods
LoadBitmap
RemoveBitmap
Device Context Methods
GetDC
FreeDC
Text Methods
Write
WriteDirect
TransparentText
OpaqueText
WriteToWindow
WriteToButton
GetTextSize
SetFont
CreateFont
DeleteFont
FontToDC
FontColor
Graphic Methods
CreateBrush
CreatePen
ObjectToDC
DeleteObject
Graphic Drawing Methods
Rectangle
DrawLine
DrawPixel
GetPixel
DrawArc
GetArcDirection
SetArcDirection
DrawPie
FillDrawing
DrawAngleArc
6.
UserDialog Class
Init
InitAutoDetection
Create
CreateCenter
DefineDialog
Load
LoadFrame
LoadItems
Add... Methods
AddButton
AddBitmapButton
AddIcon
AddGroupBox
AddText
AddEntryLine
AddPasswordLine
AddListBox
AddComboBox
AddCheckBox
AddRadioButton
AddRadioGroup
AddCheckGroup
AddInput
AddInputGroup
AddComboInput
AddInputStem
AddCheckBoxStem
AddRadioStem
AddScrollBar
AddButtonGroup
Frames and Rectangles
AddWhiteRect
AddWhiteFrame
AddGrayRect
AddGreyFrame
AddBlackRect
AddBlackFrame
OK and Cancel Push Buttons
AddOkCancelRightBottom
AddOkCancelLeftBottom
AddOkCancelRightTop
AddOkCancelLeftTop
Dialog Control Methods
StartIt
StopIt
Menu Methods
CreateMenu
AddPopupMenu
AddMenuItem
AddMenuSeparator
SetMenu
LoadMenu
7.
PlainUserDialog Class and PlainBaseDialog Class
8.
Resource File Dialogs
ResDialog Class
Init
StartIt
SetMenu
RcDialog Class
Init
9.
CategoryDialog Class
Setting Up the Dialog
Init
InitCategories
DefineDialog
CategoryPage
CreateCategoryDialog
InitDialog
GetSelectedPage
CurrentCategory
NextPage
PreviousPage
ChangePage
PageHasChanged
StartIt
Connect... Methods
Methods for Dialog Items
Get and Set Methods
SetCategoryStaticText
GetCategoryEntryLine
SetCategoryEntryLine
GetCategoryListLine
SetCategoryListLine
GetCategoryListWidth
SetCategoryListWidth
GetCategoryMultiList
SetCategoryMultiList
GetCategoryComboLine
SetCategoryComboLine
GetCategoryRadioButton
SetCategoryRadioButton
GetCategoryCheckBox
SetCategoryCheckBox
GetCategoryValue
SetCategoryValue
GetCategoryAttrib
SetCategoryAttrib
Combo Box Methods
AddCategoryComboEntry
InsertCategoryComboEntry
DeleteCategoryComboEntry
FindCategoryComboEntry
GetCategoryComboEntry
GetCategoryComboItems
GetCurrentCategoryComboIndex
SetCurrentCategoryComboIndex
ChangeCategoryComboEntry
CategoryComboAddDirectory
CategoryComboDrop
List Box Methods
AddCategoryListEntry
InsertCategoryListEntry
DeleteCategoryListEntry
FindCategoryListEntry
GetCategoryListEntry
GetCategoryListItems
GetCurrentCategoryListIndex
SetCurrentCategoryListIndex
ChangeCategoryListEntry
SetCategoryListTabulators
CategoryListAddDirectory
CategoryListDrop
Appearance Modification Methods
EnableCategoryItem
DisableCategoryItem
ShowCategoryItem
HideCategoryItem
SetCategoryItemFont
FocusCategoryItem
ResizeCategoryItem
MoveCategoryItem
SendMessageToCategoryItem
10.
Standard Dialogs, External Functions, and Public Routines
Standard Dialog Classes
TimedMessage Class
InputBox Class
PasswordBox Class
IntegerBox Class
MultiInputBox Class
ListChoice Class
MultiListChoice Class
CheckList Class
SingleSelection Class
External Functions
InfoMessage
ErrorMessage
YesNoMessage
GetScreenSize
GetSysMetrics
PlaySoundFile
PlaySoundFileInLoop
StopSoundFile
GetFileNameWindow
SleepMS
WinTimer
Public Routines
Play Routine
InfoDialog Routine
ErrorDialog Routine
AskDialog Routine
FileNameDialog Routine
FindWindow Routine
ScreenSize Routine
SystemMetrics Routine
MSSleep Routine
TimedMessage Routine
InputBox Routine
PasswordBox Routine
IntegerBox Routine
MultiInputBox Routine
ListChoice Routine
MultiListChoice Routine
CheckList Routine
SingleSelection Routine
11.
DlgArea and DlgAreaU Classes
DlgArea Class
Init
B
Bottom
CX
CY
H
HR
L
Left
Margin
R
Right
T
Top
W
WR
X
Y
DlgArea Example
DlgAreaU Class
Init
CorrectionFactor
LastError
NoMove
NoResize
Creating Resizeable Dialogs
Possible Problems
Sample Code
12.
AnimatedButton Class
13.
MessageExtensions Class
ConnectCommonNotify
ConnectTreeNotify
DefTreeDragHandler
ConnectListNotify
DefListDragHandler
ConnectListViewNotify
ConnectButtonNotify
ConnectEditNotify
ConnectListBoxNotify
ConnectComboBoxNotify
ConnectScrollBarNotify
ConnectTabNotify
ConnectSliderNotify
14.
AdvancedControls Class
GetStaticControl
GetEditControl
GetButtonControl
GetRadioControl
GetCheckControl
GetListBox
GetComboBox
GetScrollBar
GetTreeControl
GetListControl
GetProgressBar
GetSliderControl
GetTabControl
ConnectTreeControl
ConnectListControl
ConnectSliderControl
ConnectTabControl
AddTreeControl
AddListControl
AddProgressBar
AddSliderControl
AddTabControl
15.
StaticControl Class
16.
EditControl Class
Selected
Select
ScrollCommand
LineScroll
EnsureCaretVisibility
FirstVisibleLine
IsModified
SetModified
Lines
LineIndex
LineFromIndex
LineLength
GetLine
GetText
SetText
ReplaceSelText
SetLimit
PasswordChar=
PasswordChar
SetReadOnly
SetMargins
Margins
SetCue
ShowBalloon
HideBalloon
AddStyle
RemoveStyle
ReplaceStyle
GetStyle
17.
ListControl Class
View Styles
Methods of the ListControl Class
ReplaceStyle
AddStyle
RemoveStyle
AddExtendedStyle
RemoveExtendedStyle
ReplaceExtendedStyle
GetExtendedStyle
GetExtendedStyleRaw
GetHoverTime
SetHoverTime
Check
Uncheck
CheckAll
UncheckAll
GetCheck
IsChecked
InsertColumn
DeleteColumn
ModifyColumn
ColumnInfo
ColumnWidth
SetColumnWidth
StringWidth
Insert
Modify
SetItemText
SetItemState
Add
AddRow
Delete
DeleteAll
Items
Last
Prepare4nItems
SelectedItems
ItemInfo
ItemText
ItemState
Select
Deselect
Selected
LastSelected
Focused
Focus
DropHighlighted
FirstVisible
NextSelected
PreviousSelected
Next
Previous
NextLeft
NextRight
SmallSpacing
Spacing
RedrawItems
UpdateItem
Update
EnsureVisible
SetSmallImages
SetImages
RemoveSmallImages
RemoveImages
Find
FindPartial
FindNearestXY
Arrange
SnapToGrid
AlignLeft
AlignTop
ItemPos
SetItemPos
Edit
EndEdit
SubclassEdit
RestoreEditClass
ItemsPerPage
Scroll
BkColor
BkColor=
TextColor
TextColor=
TextBkColor
TextBkColor=
Notification Messages
18.
ButtonControl Class
State
State=
Style=
ChangeBitmap
DisplaceBitmap
GetBmpDisplacement
Scroll
ScrollText
GetBitmapSizeX
GetBitmapSizeY
DrawBitmap
DimBitmap
ScrollBitmapFromTo
19.
RadioButton Class
IsChecked
Check
Uncheck
Indeterminate
20.
CheckBox Class
21.
ListBox Class
Add
Insert
Delete
DeleteAll
Find
SelectedIndex
Selected
SelectIndex
DeSelectIndex
Select
SelectRange
DeselectRange
Items
SelectedItems
SelectedIndexes
MakeFirstVisible
GetFirstVisible
GetText
Modify
SetTabulators
AddDirectory
SetWidth
Width
ItemHeight
ItemHeight=
ColumnWidth=
22.
ComboBox Class
Add
Insert
Delete
DeleteAll
Find
SelectedIndex
Selected
SelectIndex
Select
Items
GetText
Modify
AddDirectory
OpenDropDown
CloseDropDown
IsDropDownOpen
EditSelection
23.
ScrollBar Class
SetRange
Range
SetPos
Position
DeterminePosition
24.
PropertySheet Class
Init
25.
ProgressBar Class
Step
SetPos
SetStep
SetRange
26.
SliderControl Class
Pos=
SetPos
Pos
InitRange
SetMin
SetMax
Range
ClearTicks
CountTicks
GetTick
SetTickAt
SetTickFrequency
GetLineStep
GetPageStep
SetLineStep
SetPageStep
InitSelRange
SetSelStart
SetSelEnd
ClearSelRange
SelRange
27.
TabControl Class
Insert
Modify
AddSequence
AddFullSeq
Items
Rows
ItemInfo
Delete
DeleteAll
Last
Selected
SelectedIndex
Select
SelectIndex
Focus
Focused
SetImages
RemoveImages
SetPadding
SetSize
PosRectangle
AdjustToRectangle
RequiredWindowSize
28.
TreeControl Class
Methods of the TreeControl Class
Insert
Add
Modify
ItemInfo
Items
VisibleItems
Root
Parent
Child
Selected
DropHighlighted
FirstVisible
Next
NextVisible
Previous
PreviousVisible
Delete
DeleteAll
Collapse
CollapseAndReset
Expand
Toggle
EnsureVisible
Indent
Indent=
Edit
EndEdit
SubclassEdit
RestoreEditClass
Select
MakeFirstVisible
DropHighlight
SortChildren
SetImages
RemoveImages
HitTest
MoveItem
IsAncestor
Notification Messages
29.
VirtualKeyCodes Class
Methods of the VirtualKeyCodes Class
VCode
KeyName
Symbolic Names for Virtual Keys
A.
Notices
Trademarks
Source Code For This Document
B.
Common Public License Version 1.0
Definitions
Grant of Rights
Requirements
Commercial Distribution
No Warranty
Disclaimer of Liability
General
Index
List of Tables
3-1.
Symbolic IDs Used by ooDialog
3-2.
ooDialog Supplied Icons
4-1.
BaseDialog Instance Methods
5-1.
DialogControl Instance Methods
6-1.
UserDialog Instance Methods
7-1.
PlainUserDialog and PlainBaseDialog Class Methods
10-1.
Standard Dialogs, Functions, and Routines
11-1.
DlgAreaU Automatic Resize Elements
11-2.
DlgAreaU Non-Automatic Resize Elements
13-1.
MessageExtensions Instance Methods
14-1.
AdvancedControls Instance Methods
16-1.
EditControl Instance Methods
17-1.
ListControl Instance Methods
18-1.
ButtonControl Instance Methods
19-1.
RadioButton Instance Methods
21-1.
ListBox Instance Methods
22-1.
ComboBox Instance Methods
23-1.
ScrollBar Instance Methods
25-1.
ProgressBar Instance Methods
26-1.
SliderControl Instance Methods
27-1.
TabControl Instance Methods
28-1.
TreeControl Instance Methods
29-1.
Symbolic Names for Virtual Keys
List of Figures
2-1.
The Hierarchy of OODialog Classes
6-1.
Sample Radio Button Group
6-2.
Sample Check Box Group
6-3.
Sample Input Field
6-4.
Frames and Rectangles in 3D Style
11-1.
DlgArea Measurements
11-2.
DlgArea Plan
11-3.
Sample DlgArea
Next
About This Book