en:docs:fapi:viowrtcharstratt

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
en:docs:fapi:viowrtcharstratt [2018/09/01 10:16] – created prokusheven:docs:fapi:viowrtcharstratt [2021/09/19 04:36] (current) prokushev
Line 1: Line 1:
 +{{page>en:templates:fapiint}} 
 +====== VioWrtCharStrAtt ====== 
 + 
 This call writes a character string with repeated attribute to the display.  This call writes a character string with repeated attribute to the display. 
  
-==Syntax== +===== Syntax ===== 
- VioWrtCharStrAtt (CharStr, Length, Row, Column, Attr, VioHandle)+<code c> 
 +VioWrtCharStrAtt (CharStr, Length, Row, Column, Attr, VioHandle) 
 +</code> 
 +===== Parameters =====
  
-==Parameters== +  * CharStr ([[PCH]]) - input : Address of the character string to be written. 
-;CharStr (PCH) - input : Address of the character string to be written. +  Length ([[USHORT]]) - input : Length, in bytes, of the character string. 
-;Length (USHORT) - input : Length, in bytes, of the character string. +  Row ([[USHORT]]) - input : Starting cursor row. 
-;Row (USHORT) - input : Starting cursor row. +  Column ([[USHORT]]) - input : Starting cursor column. 
-;Column (USHORT) - input : Starting cursor column. +  Attr ([[PBYTE]]) - input : Address of the attribute(s) (1 or 3 bytes) to be used in the display buffer for each character of the string written. 
-;Attr (PBYTE) - input : Address of the attribute(s) (1 or 3 bytes) to be used in the display buffer for each character of the string written. +  VioHandle ([[HVIO]]) - input : This must be zero unless the caller is a Presentation Manager application, in which case it must be the value returned by VioGetPs.  
-;VioHandle (HVIO) - input : This must be zero unless the caller is a Presentation Manager application, in which case it must be the value returned by VioGetPs. + 
 +===== Return Code ===== 
 + 
 +rc ([[USHORT]]) - return
  
-==Return Code== 
- rc (USHORT) - return 
 Return code descriptions are: Return code descriptions are:
-* 0          NO_ERROR  
-* 355        ERROR_VIO_MODE  
-* 358        ERROR_VIO_ROW  
-* 359        ERROR_VIO_COL  
-* 436        ERROR_VIO_INVALID_HANDLE  
-* 465        ERROR_VIO_DETACHED 
  
-==Remarks==+  * 0          NO_ERROR  
 +  * 355        ERROR_VIO_MODE  
 +  * 358        ERROR_VIO_ROW  
 +  * 359        ERROR_VIO_COL  
 +  * 436        ERROR_VIO_INVALID_HANDLE  
 +  * 465        ERROR_VIO_DETACHED 
 + 
 +===== Remarks ===== 
 If a string write gets to the end of the line and is not complete, the string write continues at the beginning of the next line. If the write gets to the end of the screen, the write terminates. If a string write gets to the end of the line and is not complete, the string write continues at the beginning of the next line. If the write gets to the end of the screen, the write terminates.
  
-===PM Considerations===+==== PM Considerations ===
 Write a character string with a repeated attribute string to the Advanced VIO presentation space. The caller must specify the starting location on the presentation space where the string is to be written. Write a character string with a repeated attribute string to the Advanced VIO presentation space. The caller must specify the starting location on the presentation space where the string is to be written.
  
-==Example Code== +===== Bindings ===== 
-=== C Binding=== + 
-<PRE>+==== C Binding==== 
 +<code c>
 #define INCL_VIO #define INCL_VIO
  
Line 46: Line 56:
 USHORT           rc;            /* return code */ USHORT           rc;            /* return code */
  
-</PRE>+</code>
  
-===MASM Binding=== +====MASM Binding==== 
-<PRE>+<code asm>
 EXTRN  VioWrtCharStrAtt:FAR EXTRN  VioWrtCharStrAtt:FAR
 INCL_VIO            EQU 1 INCL_VIO            EQU 1
Line 62: Line 72:
  
 Returns WORD Returns WORD
-</PRE> +</code>
- +
  
-====== Note ======+===== Note =====
  
 Text based on [[http://www.edm2.com/index.php/VioWrtCharStrAtt_(FAPI)]] Text based on [[http://www.edm2.com/index.php/VioWrtCharStrAtt_(FAPI)]]