GpiQueryCharAngle: Difference between revisions
Created page with "This function returns the current value of the character baseline angle. ==Syntax== GpiQueryCharAngle(hps, pgradlAngle) ==Parameters== ; hps (HPS) - input : Presentation-space handle. ; pgradlAngle (PGRADIENTL) - output : Baseline angle. : A point, relative to (0,0), that defines the character baseline angle vector. : If the character angle is currently set to the default value, (0,0) is returned. ==Return Value== ; rc (BOOL) - returns : Success indicato..." |
mNo edit summary |
||
| Line 5: | Line 5: | ||
==Parameters== | ==Parameters== | ||
; hps ([[HPS]]) - input | ; hps ([[HPS]]) - input: Presentation-space handle. | ||
: Presentation-space handle. | ; pgradlAngle ([[PGRADIENTL]]) - output: Baseline angle. | ||
; pgradlAngle ([[PGRADIENTL]]) - output | |||
: Baseline angle. | |||
: A point, relative to (0,0), that defines the character baseline angle vector. | : A point, relative to (0,0), that defines the character baseline angle vector. | ||
: If the character angle is currently set to the default value, (0,0) is returned. | : If the character angle is currently set to the default value, (0,0) is returned. | ||
==Return Value== | ==Return Value== | ||
; rc ([[BOOL]]) - returns | ; rc ([[BOOL]]) - returns: Success indicator. | ||
: Success indicator. | :: TRUE : Successful completion | ||
: | :: FALSE : Error occurred. | ||
: | |||
==Remarks== | ==Remarks== | ||
| Line 26: | Line 20: | ||
==Errors== | ==Errors== | ||
Possible returns from WinGetLastError: | Possible returns from WinGetLastError: | ||
; PMERR_INV_HPS (0x207F) | ; PMERR_INV_HPS (0x207F): An invalid presentation-space handle was specified. | ||
: An invalid presentation-space handle was specified. | ; PMERR_PS_BUSY (0x20F4): An attempt was made to access the presentation space from more than one thread simultaneously. | ||
; PMERR_PS_BUSY (0x20F4) | ; PMERR_INV_IN_RETAIN_MODE (0x208C): An attempt was made to issue a function (for example, query) that is invalid when the actual drawing mode is not draw or draw-and-retain. | ||
: An attempt was made to access the presentation space from more than one thread simultaneously. | ; PMERR_INV_DC_TYPE (0x2060): An invalid type parameter was specified with DevOpenDC, or a function was issued that is invalid for a OD_METAFILE_NOQUERY device context. | ||
; PMERR_INV_IN_RETAIN_MODE (0x208C) | |||
: An attempt was made to issue a function (for example, query) that is invalid when the actual drawing mode is not draw or draw-and-retain. | |||
; PMERR_INV_DC_TYPE (0x2060) | |||
: An invalid type parameter was specified with DevOpenDC, or a function was issued that is invalid for a OD_METAFILE_NOQUERY device context. | |||
==Example Code== | ==Example Code== | ||
This example uses GpiQueryCharAngle to return the current value of the character baseline angle; if successful, it places the x-component in a variable. | This example uses GpiQueryCharAngle to return the current value of the character baseline angle; if successful, it places the x-component in a variable. | ||
<pre> | <pre> | ||
#define INCL_GPIPRIMITIVES /* Primitive functions */ | #define INCL_GPIPRIMITIVES /* Primitive functions */ | ||
#include | #include <os2.h> | ||
BOOL fSuccess; /* success indicator */ | BOOL fSuccess; /* success indicator */ | ||
HPS hps; /* Presentation-space handle */ | HPS hps; /* Presentation-space handle */ | ||
LONG lxComponent; /* x component of baseline angle */ | LONG lxComponent; /* x component of baseline angle */ | ||
GRADIENTL pgradlAngle; /* Baseline angle */ | GRADIENTL pgradlAngle; /* Baseline angle */ | ||
fSuccess = GpiQueryCharAngle(hps, &pgradlAngle); | fSuccess = GpiQueryCharAngle(hps, &pgradlAngle); | ||
if (fSuccess == TRUE) | if (fSuccess == TRUE) lxComponent = pgradlAngle.x; | ||
</pre> | </pre> | ||
Latest revision as of 11:01, 18 November 2025
This function returns the current value of the character baseline angle.
Syntax
GpiQueryCharAngle(hps, pgradlAngle)
Parameters
- hps (HPS) - input
- Presentation-space handle.
- pgradlAngle (PGRADIENTL) - output
- Baseline angle.
- A point, relative to (0,0), that defines the character baseline angle vector.
- If the character angle is currently set to the default value, (0,0) is returned.
Return Value
- rc (BOOL) - returns
- Success indicator.
- TRUE : Successful completion
- FALSE : Error occurred.
Remarks
This function is invalid when the drawing mode (see GpiSetDrawingMode) is set to retain.
Errors
Possible returns from WinGetLastError:
- PMERR_INV_HPS (0x207F)
- An invalid presentation-space handle was specified.
- PMERR_PS_BUSY (0x20F4)
- An attempt was made to access the presentation space from more than one thread simultaneously.
- PMERR_INV_IN_RETAIN_MODE (0x208C)
- An attempt was made to issue a function (for example, query) that is invalid when the actual drawing mode is not draw or draw-and-retain.
- PMERR_INV_DC_TYPE (0x2060)
- An invalid type parameter was specified with DevOpenDC, or a function was issued that is invalid for a OD_METAFILE_NOQUERY device context.
Example Code
This example uses GpiQueryCharAngle to return the current value of the character baseline angle; if successful, it places the x-component in a variable.
#define INCL_GPIPRIMITIVES /* Primitive functions */ #include <os2.h> BOOL fSuccess; /* success indicator */ HPS hps; /* Presentation-space handle */ LONG lxComponent; /* x component of baseline angle */ GRADIENTL pgradlAngle; /* Baseline angle */ fSuccess = GpiQueryCharAngle(hps, &pgradlAngle); if (fSuccess == TRUE) lxComponent = pgradlAngle.x;