WinSetDlgItemShort
This function converts an integer value into the text of a dialog item.
Syntax
WinSetDlgItemShort(hwndDlg, idItem, usValue, fSigned);
Parameters
- hwndDlg (HWND) - input
- Parent-window handle.
- idItem (ULONG) - input
- Identity of the child window whose text is to be changed.
- It must be greater or equal to 0 and less or equal to 0xFFFF.
- usValue (USHORT) - input
- Integer value used to generate the dialog item text.
- fSigned (BOOL) - input
- Sign indicator.
- TRUE
- Signed integer value
- FALSE
- Unsigned integer value.
Returns
- rc (BOOL) - returns
- Success indicator.
- TRUE
- Successful completion
- FALSE
- Error occurred.
Errors
Possible returns from WinGetLastError
- PMERR_INVALID_HWND (0x1001)
- An invalid window handle was specified.
Remarks
The text produced is an ASCII string.
This function is valid for any window with children; however, it is typically used for dialog items in a dialog window.
Example Code
This example gets the text from a Dialog Box entry field as an integer value.
#define INCL_WINDIALOGS
#define INCL_WINBUTTONS
#include <OS2.H>
#define ID_ENTRYFLD 900
#define EM_SETTEXTLIMIT 2
HAB hab;
HWND hwnd;
ULONG msg;
switch(msg)
{
case WM_INITDLG:
/* set entry field text limit. */
WinSendDlgItemMsg(hwnd,
/* identifier of the entry field window, which is */
/* a child of the the window defined by hwnd. */
(ULONG)ID_ENTRYFLD,
(ULONG)EM_SETTEXTLIMIT, /* Limit length */
/* MPFROM2SHORT macro is of the form (low 2 bytes, */
/* high 2 bytes), the the number passed is simply 2. */
MPFROM2SHORT(2,0),
(MPARAM)0);
/* set entry field to 12. */
WinSetDlgItemShort(hwnd, ID_ENTRYFLD, (SHORT)12,TRUE);
}
Definition
#define INCL_WINDIALOGS /* Or use INCL_WIN, INCL_PM, Also in COMMON section */ #include <os2.h> HWND hwndDlg; /* Parent-window handle. */ ULONG idItem; /* Identity of the child window whose text is to be changed. */ USHORT usValue; /* Integer value used to generate the dialog item text. */ BOOL fSigned; /* Sign indicator. */ BOOL rc; /* Success indicator. */ rc = WinSetDlgItemShort(hwndDlg, idItem, usValue, fSigned);