DisplayMBString

From WikiPrizm
Revision as of 17:12, 22 May 2012 by Tari (talk | contribs)
Jump to navigationJump to search
This page's documentation is not complete and is based off of preliminary testing. There may be errors in the documentation or the naming conventions may not be completely agreed upon.


Synopsis

Header: Not documented
Syscall index: Not documented
Function signature: void DisplayMBString(unsigned char *buffer, int start, int cursor, int x, int y)

Draws a string for manual single-line text editing. A blinking cursor is provided and the string does not wrap.

Parameters

  • buffer - A text string that will be displayed - can be constant
  • start - Location of the first character to display. 0 is the beginning of the string, >0 will shift the string to the left.
  • cursor - Location of the cursor from the start of the string. This is absolute and is from the start of the displayed text (cursor of 3 and start of 2, the cursor is located after the first character displayed, not after the third). 0 is before the first character.
  • x - X location to draw the string, similar to PrintXY.
  • y - Y location to draw the string, similar to PrintXY.

Comments

Function is non-blocking, meant for manual string entry. Cursor blinking cannot be moved unless this function is re-called with updated cursor.

Result of setting cursor out of bounds has not been tested, overflow characters are not drawn.