textbox.h

The major functionality added in this release includes: - Rootless mode in X11 - Widget Templt

/* $Id: textbox.h,v 1.22 2002/11/12 22:52:47 micahjd Exp $
 *
 * textbox.h - Interface definitions for the textbox widget. This allows
 *             the main textbox widget functions and the text format loaders
 *             to access textbox utility functions.
 *
 * PicoGUI small and efficient client/server GUI
 * Copyright (C) 2000-2002 Micah Dowty <[e-mail]>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 * 
 * Contributors:
 * 
 * 
 * 
 */

#ifndef __TEXTBOX_H
#define __TEXTBOX_H

#include <pgserver/divtree.h>
#include <pgserver/render.h>
#include <pgserver/paragraph.h>
#include <pgserver/input.h>

struct textbox_document {
  struct paragraph *par_list;     /* Doubly-linked list of paragraphs */
  struct divnode *container_div;  /* Divnode containing everything */
  struct paragraph_cursor *crsr;  /* Current cursor (and therefore current paragraph) */

  /* Owner-settable options */
  int password;                   /* Character to use for password hiding, if nonzero */
  unsigned int multiline : 1;
  unsigned int autoscroll : 1;
};

/******************************************************** Public Methods **/

g_error document_new(struct textbox_document **doc, struct divnode *container_div);
void document_delete(struct textbox_document *doc);

/************************* Editing */

/* This document interface is shared between the textbox_frontend and all text formats.
 */

/* Insert a character/string at the current cursor location.
 * Metadata if any is copied (the document will not reference
 * metadata nodes in the original string). The cursor location
 * afterward will be after the inserted string.
 */
g_error document_insert_char(struct textbox_document *doc, u32 ch, void *metadata);
g_error document_insert_string(struct textbox_document *doc, struct pgstring *str);

/* Seek in the document, same interface as fseek.
 * If this seeks past the end of the stream, document_eof will return true
 */
void document_seek(struct textbox_document *doc, s32 offset, int whence);

/* Like document_seek, but bound it at the edges of the document.
 * document_eof() will never be set after calling this.
 * Returns the amount actually seeked.
 */
int document_bounded_seek(struct textbox_document *doc, s32 offset, int whence);

/* Seek up/down in the document, snapping the cursor to the nearest character
 * This is bounded to the document edges.
 * Returns the number of lines actually seeked (positive or negative)
 */
int document_lineseek(struct textbox_document *doc, s32 offset);

/* Return 0 if the cursor is still inside the document,
 * If the cursor is before the beginning of the document return
 * a negative number equal to the number of characters before,
 * likewise return a positive number indicating the number
 * of characters after if the cursor is after the end of the doc.
 */
int document_eof(struct textbox_document *doc);

/* Delete the character after the cursor. If there's no cursor to delete,
 * document_eof() should be true
 */
g_error document_delete_char(struct textbox_document *doc);

/* Delete the cursor before the cursor
 * This doesn't allow the action if it's at the edge of the document.
 */
g_error document_backspace_char(struct textbox_document *doc);

/* Retrieve the paragraph associated with a divnode */
struct paragraph *document_get_div_par(struct divnode *div);

/* Seek the cursor to the mouse location */
void document_mouseseek(struct textbox_document *doc, struct trigparam_mouse *m);

/* Insert a new paragraph after the one the cursor is on */
g_error document_insert_paragraph(struct textbox_document *doc);

/************************* Text format loaders */

struct txtformat {
  const char *name;
  g_error (*load)(struct textbox_document *doc, struct pgstring *str);
  g_error (*save)(struct textbox_document *doc, struct pgstring **str);
};

/* Load text of the specified format. */
g_error document_load(struct textbox_document *doc, const struct pgstring *format,
		      struct pgstring *str);
g_error document_save(struct textbox_document *doc, const struct pgstring *format,
		      struct pgstring **str);

/* Clear out the existing data and reset the cursor */
g_error document_nuke(struct textbox_document *doc);

extern struct txtformat text_formats[];

/* Format loader functions */
g_error plaintext_load(struct textbox_document *doc, struct pgstring *str);
g_error plaintext_save(struct textbox_document *doc, struct pgstring **str);
g_error html_load(struct textbox_document *doc, struct pgstring *str);
g_error html_save(struct textbox_document *doc, struct pgstring **str);

#endif /* __H_TEXTBOX */   

/* The End */