|
GetGlobalRC
- 0 2.0
Queries the current default settings and fills an RC structure with the global values. In version 2.0 of the Pen API, RC is made obsolete by the HRC object.
Note This function is provided only for compatibility with version 1.0 of the Pen
API and will not be supported in future versions.
UINT GetGlobalRC( LPRC lprc, LPSTR lpszDefRecog, LPSTR lpszDefDict, int cbDefDictMax )
Parameters
lprc
Address of an RC structure. This parameter can be NULL.
lpszDefRecog
Address of a character string in which the default recognizer module name is
returned. This must be at least 128 bytes long. This parameter can be NULL.
lpszDefDict
Buffer in which the default dictionary path is returned. This path ends with
two null characters. This parameter can be NULL.
cbDefDictMax
Size of lpszDefDict buffer to be filled.
Return Value
Returns GGRC_OK if successful; otherwise, the return value may be one of the
following values:
Constant
| Description
| GGRC_PARAMERROR
| One or more invalid parameters were detected. The call to GetGlobalRC has no effect.
| GGRC_DICTBUFTOOSMALL
| The size of the lpszDefDict buffer is not large enough to contain the entire dictionary path. The buffer
is filled with as many complete dictionary module names as allowed by the size.
The list is terminated by a null string.
|
Comments
GetGlobalRC fills the RC structure with global values. Values that have no default settings for example, the bounding rectangle are set to 0.
An application does not need to call this function to use the default values.
When an application initializes an RC structure using InitRC, the system default values are set as the values for the structure members.
This function returns the actual current values for RC members. The InitRC function returns the default values, which include placeholder values for
some RC members.
See Also
InitRC, SetGlobalRC, RC
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|