class fltk::Output


Class Hierarchy

fltk::Input
   |
   +----fltk::Output
           |
           +----fltk::MultilineOutput

Include Files

#include <fltk/Output.h>

Description

This widget displays a piece of text. When you set the value() , fltk::Output does a strcpy() to it's own storage, which is useful for program-generated values. The user may select portions of the text using the mouse and paste the contents into other fields or programs.

There is a single subclass, fltk::MultilineOutput, which allows you to display multiple lines of text.

The text may contain any characters except \0, and will correctly display anything, using ^X notation for unprintable control characters and \nnn notation for unprintable characters with the high bit set. It assummes the font can draw any characters in the ISO-Latin1 character set.

Methods

fltk::Output::Output(int x, int y, int w, int h, const char *label = 0)

Creates a new fltk::Output widget using the given position, size, and label string. The default boxtype is fltk::DOWN_BOX.

virtual fltk::Output::~Output()

Destroys the widget and any value associated with it.

const char *fltk::Output::value() const
int fltk::Output::value(const char*)
int fltk::Output::value(const char*, int)

The first form returns the current value, which is a pointer to the internal buffer and is valid only until the value is changed.

The second two forms change the text and set the mark and the point to the end of it. The string is copied to the internal buffer. Passing NULL is the same as "". This returns non-zero if the new value is different than the current one. You can use the second version to directly set the length if you know it already or want to put nul's in the text.

int fltk::Output::size() const

Returns the number of characters in value(). This may be greater than strlen(value()) if there are nul characters in it.

char fltk::Output::index(int) const

Same as value()[n], but may be faster in plausible implementations. No bounds checking is done.