Category : BASIC Source Code
Archive   : IDVB.ZIP
Filename : VBFINDID.TXT

 
Output of file : VBFINDID.TXT contained in archive : IDVB.ZIP

VBFindID Documentation

Introduction:

Visual Basic provides no way to determine or define the IDs of Controls in VB
forms. There are several API calls that require that the ID of a child
control be supplied, for example SendDlgItemMessage, SetDlgItemInt,
DlrDirList, etc. The IDs of controls can be determined during run time by
going through a series of SetFocus and API calls, e.g.

aControl.SetFocus
id_aControl = GetDlgCtrlID(GetFocus())
bControl.SetFocus
id_bControl = GetDlgCtrlID(GetFocus())

Even though this method will determine the ID of a control it can only be
implemented once a form is shown (or during Form_Paint) and will not work
with VB Labels since SetFocus flags these. There are many instances when
knowing the ID of a label can be useful, e.g. with API's DlgDirList function.

VBFindID is a small WinApp I wrote in Turbo Pascal for Windows (for
compactness). It can be used to determine the IDs of VB Controls (including
Labels) during development of your VB Apps. Knowing the IDs before hand saves
you from having to determine control IDs during run-time and allows you the
flexibility to use several API calls during the Form_Load procedure without
having to show the form and go through a series of SetFocus statements. Also,
it's the only way I know of to get the IDs of VB labels.


Using VBFindID:

I've installed VBFindID as a Program Item under the Languages Group. This way
I can quickly start it whenever I need to use it with a VB project. Even
though VBFindID was written as a VB utility, it will find the IDs of any
legitimate Windows control. Additionally, it reports the current hWnd
handle of the control (useful only for debugging since this changes all the
time), the Class Name of the control, and finally the control's caption.

After you start VBFindID, click on the "Find ID" button to start the search.
VBFindID loads its own cursor which looks like a frame. The center of the

frame is the cursor's hot spot. Move the VBFindID custom cursor over the
control whose ID you wish to determine so that the center of the cursor is
over a portion of the control. You'll notice VBFindID updates its report
label as you move the frame cursor around. If you want to find the ID of
a button, place the frame cursor over the button on the window you are
researching. If you want to find the ID of a Label place the cursor over the
Label. Do the same for listboxes, combo boxes, option buttons, etc. Make a
note of the IDs you're planning on using in your App and press the right
mouse button (or Escape) to stop the search. To end the VBFindID session,
click on Quit.


Visual Basic and Control IDs:

VB assigns IDs to controls during design time. The first control is assigned
ID: 1, and the IDs are incremented with each control added to the form (the
second control's ID will be 2, the third's 3, etc). If this ID order was
always the case, there would be very little need for VBFindID since you could
make a note of which control you created first, second, third, and so forth,
and immediately know the ID order of your controls. Running VBFindID in
design mode this seems to be the case, but when you choose "Run" to run
your form and inspect the IDs with VBFindID you'll discover that VB reorders
the IDs in a left to right, top to bottom order. So, if your first control
was placed at the bottom left corner it may have an ID of 1 during design
time but an ID of 5 during run time.

You may be wondering: if this is the case then it's hopeless to be able to
accurately determine IDs without the SetFocus/GetFocus routines. There's
good news: Once you design your form to your satisfaction, save the form.
When the form is saved the IDs are set for good. Now, load the form and
"Run" it along with VBFindID. Make a note of the IDs of the controls you
need and you're all set. If you add or delete controls during development
then simply go through the same steps to determine the correct ID
assignments.


About the ID demos:

IDDEMO.MAK is the Shell for two demos: IDOPEN and IDOTHER.

IDOPEN is a simple Win3 style File Open dialog without an Edit control. It
uses DlgDirList and DlgDirSelect as examples of using IDs with VB forms.

IDOTHER demos using SetDlgItemInt, SetDlgItemText, SendDlgItemMessage,
GetDlgItemInt, GetDlgItemText, and GetDlgItem.


Questions/Comments:

If you have questions or comments you may reach me via CIS mail at 73667,1755
or on the MSBASIC forum.


Distribution:

If you'd like to share VBFINDID with your friends and colleagues or upload it
to a BBS you may do so only in the form of the original ZIP archive containing
VBFINDID.EXE, VBFINDID.TXT, IDDEMO.MAK, IDDEMO.FRM, IDOPEN.FRM, and
IDOTHER.FRM. Of course, don't charge anything for VBFINDID or the docs and
demo files.


Enjoy,

Costas Kitsos
October 1991