VioCreateLogFont: Difference between revisions
Created page with "==Description== Specifies a font for use by a VIO session. ==Syntax== <PRE> #define INCL_VIO #include <os2.h> PFATTRS attrs; /* Pointer to the font attribute structure. ..." |
mNo edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
Specifies a font for use by a VIO session. | Specifies a font for use by a VIO session. | ||
==Syntax== | ==Syntax== | ||
VioCreateLogFont(attrs, lcid, Name, hvps) | |||
==Parameters== | ==Parameters== | ||
; attrs ( | ;attrs (P[[FATTRS]]) - input : Pointer to the font attribute structure. | ||
;lcid (ULONG) - input : Local identifier. | |||
; lcid (ULONG) - input : Local identifier. | :This must be a value in the range 1 to 3. It is an error if lcid is already in use. | ||
This must be a value in the range 1 to 3. It is an error if lcid is already in use. | ;Name (STR8) - input : Logical font name. | ||
:This string is optional and is used to describe the logical font. | |||
; Name (STR8) - input : Logical font name. | ;hvps (HVIO) - input : VIO presentation-space handle. | ||
This string is optional and is used to describe the logical font. | :This is either 0 to indicate the default VIO session, or a value returned by [[VioCreatePS]]. | ||
; hvps (HVIO) - input : VIO presentation-space handle. | |||
This is either 0 to indicate the default VIO session, or a value returned by VioCreatePS. | |||
==Return Code== | ==Return Code== | ||
;rc (APIRET) - returns:VioCreateLogFont returns one of the following values: | |||
* 0 NO_ERROR | |||
* 421 ERROR_VIO_INVALID_PARMS | |||
* 436 ERROR_VIO_INVALID_HANDLE | |||
==Remarks== | ==Remarks== | ||
The system selects the font most closely matching the specified font from the set of monospaced fonts installed in the system. | The system selects the font most closely matching the specified font from the set of monospaced fonts installed in the system. | ||
In OS/2 2.x, hvps cannot be 0. | In OS/2 2.x, hvps cannot be 0. | ||
[[Category: | [[Category:Vio]] | ||
Latest revision as of 03:49, 17 January 2019
Specifies a font for use by a VIO session.
Syntax
VioCreateLogFont(attrs, lcid, Name, hvps)
Parameters
- attrs (PFATTRS) - input
- Pointer to the font attribute structure.
- lcid (ULONG) - input
- Local identifier.
- This must be a value in the range 1 to 3. It is an error if lcid is already in use.
- Name (STR8) - input
- Logical font name.
- This string is optional and is used to describe the logical font.
- hvps (HVIO) - input
- VIO presentation-space handle.
- This is either 0 to indicate the default VIO session, or a value returned by VioCreatePS.
Return Code
- rc (APIRET) - returns
- VioCreateLogFont returns one of the following values:
- 0 NO_ERROR
- 421 ERROR_VIO_INVALID_PARMS
- 436 ERROR_VIO_INVALID_HANDLE
Remarks
The system selects the font most closely matching the specified font from the set of monospaced fonts installed in the system.
In OS/2 2.x, hvps cannot be 0.