Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members

FX::FXTextField Class Reference

#include <FXTextField.h>

Inheritance diagram for FX::FXTextField:
FX::FXFrame FX::FXWindow FX::FXDrawable FX::FXId FX::FXObject

List of all members.

Public Types

enum  {
  ID_CURSOR_HOME = FXFrame::ID_LAST,
  ID_CURSOR_END,
  ID_CURSOR_RIGHT,
  ID_CURSOR_LEFT,
  ID_CURSOR_WORD_LEFT,
  ID_CURSOR_WORD_RIGHT,
  ID_CURSOR_WORD_START,
  ID_CURSOR_WORD_END,
  ID_MARK,
  ID_EXTEND,
  ID_SELECT_ALL,
  ID_DESELECT_ALL,
  ID_CUT_SEL,
  ID_COPY_SEL,
  ID_PASTE_SEL,
  ID_PASTE_MIDDLE,
  ID_DELETE_SEL,
  ID_DELETE_ALL,
  ID_OVERST_STRING,
  ID_INSERT_STRING,
  ID_BACKSPACE,
  ID_DELETE,
  ID_TOGGLE_EDITABLE,
  ID_TOGGLE_OVERSTRIKE,
  ID_BLINK,
  ID_LAST
}

Public Member Functions

 FXTextField (FXComposite *p, FXint ncols, FXObject *tgt=NULL, FXSelector sel=0, FXuint opts=TEXTFIELD_NORMAL, FXint x=0, FXint y=0, FXint w=0, FXint h=0, FXint pl=DEFAULT_PAD, FXint pr=DEFAULT_PAD, FXint pt=DEFAULT_PAD, FXint pb=DEFAULT_PAD)
virtual void create ()
virtual void layout ()
virtual void enable ()
virtual void disable ()
virtual FXint getDefaultWidth ()
virtual FXint getDefaultHeight ()
virtual bool canFocus () const
virtual void setFocus ()
virtual void killFocus ()
void setEditable (FXbool edit=TRUE)
FXbool isEditable () const
void setOverstrike (FXbool over=TRUE)
FXbool isOverstrike () const
void setCursorPos (FXint pos)
FXint getCursorPos () const
void setAnchorPos (FXint pos)
FXint getAnchorPos () const
void setText (const FXString &text, FXbool notify=FALSE)
FXString getText () const
void setFont (FXFont *fnt)
FXFontgetFont () const
void setTextColor (FXColor clr)
FXColor getTextColor () const
void setSelBackColor (FXColor clr)
FXColor getSelBackColor () const
void setSelTextColor (FXColor clr)
FXColor getSelTextColor () const
void setCursorColor (FXColor clr)
FXColor getCursorColor () const
void setNumColumns (FXint cols)
FXint getNumColumns () const
void setJustify (FXuint mode)
FXuint getJustify () const
void setDelimiters (const FXchar *delims=textDelimiters)
const FXchargetDelimiters () const
void setHelpText (const FXString &text)
const FXStringgetHelpText () const
void setTipText (const FXString &text)
const FXStringgetTipText () const
void setTextStyle (FXuint style)
FXuint getTextStyle () const
FXbool selectAll ()
FXbool setSelection (FXint pos, FXint len)
FXbool extendSelection (FXint pos)
FXbool killSelection ()
FXbool isPosSelected (FXint pos) const
FXbool isPosVisible (FXint pos) const
void makePositionVisible (FXint pos)
virtual void save (FXStream &store) const
virtual void load (FXStream &store)
virtual ~FXTextField ()

Static Public Attributes

static const FXchar textDelimiters []

Detailed Description

A text field is a single-line text entry widget.

The text field widget supports clipboard for cut-and-paste operations. Text input may be constrained to a certain format; the built-in capabilities support integer and real number entry constraints; additional constraints on the input may be implemented by intercepting the SEL_VERIFY message; a custom handler should examine the tentative input string passed as type const FXchar* in the message data, and return a value of "0" if the new input is accepted. During text entry, the text field sends a SEL_CHANGED message to its target, with the message data set to the current text value of type const FXchar*. When the text is accepted by hitting ENTER, the SEL_COMMAND message is sent. The text field also sends SEL_COMMAND when the focus moves to another control. TEXTFIELD_ENTER_ONLY can be passed to suppress this feature. Typically, this flag is used in dialogs that close when ENTER is hit in a text field.

See also:


Member Enumeration Documentation

anonymous enum
Enumerator:
ID_CURSOR_HOME 
ID_CURSOR_END 
ID_CURSOR_RIGHT 
ID_CURSOR_LEFT 
ID_CURSOR_WORD_LEFT 
ID_CURSOR_WORD_RIGHT 
ID_CURSOR_WORD_START 
ID_CURSOR_WORD_END 
ID_MARK 
ID_EXTEND 
ID_SELECT_ALL 
ID_DESELECT_ALL 
ID_CUT_SEL 
ID_COPY_SEL 
ID_PASTE_SEL 
ID_PASTE_MIDDLE 
ID_DELETE_SEL 
ID_DELETE_ALL 
ID_OVERST_STRING 
ID_INSERT_STRING 
ID_BACKSPACE 
ID_DELETE 
ID_TOGGLE_EDITABLE 
ID_TOGGLE_OVERSTRIKE 
ID_BLINK 
ID_LAST 

Constructor & Destructor Documentation

FX::FXTextField::FXTextField ( FXComposite p,
FXint  ncols,
FXObject tgt = NULL,
FXSelector  sel = 0,
FXuint  opts = TEXTFIELD_NORMAL,
FXint  x = 0,
FXint  y = 0,
FXint  w = 0,
FXint  h = 0,
FXint  pl = DEFAULT_PAD,
FXint  pr = DEFAULT_PAD,
FXint  pt = DEFAULT_PAD,
FXint  pb = DEFAULT_PAD 
)

Construct text field wide enough to display ncols columns.

virtual FX::FXTextField::~FXTextField ( ) [virtual]

Destructor.


Member Function Documentation

virtual void FX::FXTextField::create ( ) [virtual]

Create server-side resources.

Reimplemented from FX::FXWindow.

virtual void FX::FXTextField::layout ( ) [virtual]

Perform layout.

Reimplemented from FX::FXWindow.

virtual void FX::FXTextField::enable ( ) [virtual]

Enable text field.

Reimplemented from FX::FXWindow.

virtual void FX::FXTextField::disable ( ) [virtual]

Disable text field.

Reimplemented from FX::FXWindow.

virtual FXint FX::FXTextField::getDefaultWidth ( ) [virtual]

Return default width.

Reimplemented from FX::FXFrame.

Return default height.

Reimplemented from FX::FXFrame.

virtual bool FX::FXTextField::canFocus ( ) const [virtual]

Yes, text field may receive focus.

Reimplemented from FX::FXWindow.

virtual void FX::FXTextField::setFocus ( ) [virtual]

Move the focus to this window.

Reimplemented from FX::FXWindow.

virtual void FX::FXTextField::killFocus ( ) [virtual]

Remove the focus from this window.

Reimplemented from FX::FXWindow.

void FX::FXTextField::setEditable ( FXbool  edit = TRUE)

Set editable mode.

Return TRUE if text field may be edited.

void FX::FXTextField::setOverstrike ( FXbool  over = TRUE)

Set overstrike mode.

Return TRUE if overstrike mode in effect.

Set cursor position.

Return cursor position.

Change anchor position.

Return anchor position.

void FX::FXTextField::setText ( const FXString text,
FXbool  notify = FALSE 
)

Change the text and move cursor to end.

FXString FX::FXTextField::getText ( ) const [inline]

Get the text for this label.

Set the text font.

FXFont* FX::FXTextField::getFont ( ) const [inline]

Get the text font.

Change text color.

Return text color.

Change selected background color.

Return selected background color.

Change selected text color.

Return selected text color.

Changes the cursor color.

Return the cursor color.

Change the default width of the text field in terms of a number of columns times the width of the numeral '8'.

Return number of columns.

Change text justification mode.

The justify mode is a combination of horizontal justification (JUSTIFY_LEFT, JUSTIFY_RIGHT, or JUSTIFY_CENTER_X), and vertical justification (JUSTIFY_TOP, JUSTIFY_BOTTOM, JUSTIFY_CENTER_Y). Note that JUSTIFY_CENTER_X can not be set from the constructor since by default text fields are left-justified.

Return text justification mode.

void FX::FXTextField::setDelimiters ( const FXchar delims = textDelimiters) [inline]

Change word delimiters.

const FXchar* FX::FXTextField::getDelimiters ( ) const [inline]

Return word delimiters.

void FX::FXTextField::setHelpText ( const FXString text) [inline]

Set the status line help text for this label.

const FXString& FX::FXTextField::getHelpText ( ) const [inline]

Get the status line help text for this label.

void FX::FXTextField::setTipText ( const FXString text) [inline]

Set the tool tip message for this text field.

const FXString& FX::FXTextField::getTipText ( ) const [inline]

Get the tool tip message for this text field.

Change text style.

Return text style.

Select all text.

Select len characters starting at given position pos.

Extend the selection from the anchor to the given position.

Unselect the text.

Return TRUE if position pos is selected.

Return TRUE if position is fully visible.

Scroll text to make the given position visible.

virtual void FX::FXTextField::save ( FXStream store) const [virtual]

Save text field to a stream.

Reimplemented from FX::FXFrame.

virtual void FX::FXTextField::load ( FXStream store) [virtual]

Load text field from a stream.

Reimplemented from FX::FXFrame.


Member Data Documentation

Default text delimiters.

Copyright © 1997-2005 Jeroen van der Zijp