Data Structures
struct	tagWBEditWindow
	Structure that defines an Edit Window. More...

Typedefs
typedef struct tagWBEditWindow	WBEditWindow
	Structure that defines an Edit Window. More...

Functions
WBEditWindow *	WBCreateEditWindow (WBFrameWindow pOwner, WB_FONT pFont, const char szFocusMenu, const WBFWMenuHandler *pHandlerArray, int fFlags)
	Create an Edit Window. More...

void	WBDestroyEditWindow (WBEditWindow *pEditWindow)
	Destroy an Edit Window. More...

WBEditWindow *	WBEditWindowFromWindowID (Window wID)
	Obtain the associated WBEditWindow structure pointer for a Window ID. More...

int	WBEditWindowLoadFile (WBEditWindow pEditWindow, const char pszFileName)
	Open an existing file and read its contents into the Edit Window, storing the file name for later reference. More...

int	WBEditWindowSaveFile (WBEditWindow pEditWindow, const char pszFileName)
	Save the contents from the Edit Window to a file, overwriting the file if it already exists. More...

void	WBEditWindowClear (WBEditWindow *pEditWindow)
	Clear the contents in the Edit Window, and NULL the stored file name. More...

static __inline__ int	WBIsValidEditWindow (WBEditWindow *pEditWindow)
	Check for valid WBEditWindow pointer. More...

void	WBEditWindowRegisterCallback (WBEditWindow *pEditWindow, WBWinEvent pUserCallback)
	Clear the contents in the Edit Window, and NULL the stored file name. More...

Variables
Atom	aEW_HOVER_NOTIFY
	Hover notification to user-callback, sent via ClientMessage event. More...

Atom	aEW_EDIT_CHANGE
	'Edit Change' notification to user-callback, sent via ClientMessage event More...

Detailed Description

Edit windows are 'Child Frame' windows, owned by a frame window, in which text is edited and menu callbacks are processed.
The edited text is typically associated with a file name. An Edit Window uses the TEXT_OBJECT object (structure) to manage its state.

See also: Text Editing Utilities and Objects

Typedef Documentation

◆ WBEditWindow

WBEditWindow

Structure that defines an Edit Window.

The WBEditWindow structure defines an 'Edit Window' that is a 'superclass' of a Child Frame window. The first element MUST be the 'WBChildFrame'. Elements that follow it are specific to the Edit Window.

This uses a TEXT_OBJECT structure to store the actual text data, and to manage the UI functionality.

typedef struct tagWBEditWindow
{
  WBChildFrame childframe;          // elements common to a 'child frame' (derived object)
  unsigned int ulTag;               // 'Tag' identifying this structure as a WBEditWindow
  char *szFileName;                 // malloc'd name of file associated with this edit window (NULL if none)
  unsigned long long llModDateTime; // file's mod date/time - see WBGetFileModDateTime()
  WBWinEvent pUserCallback;         // user callback function to receive notifications and unhandled messages
  TEXT_OBJECT xTextObject;          // the 'TEXT_OBJECT' member, that does MOST of the work
} WBEditWindow;

Additional 'Child Frame' API functions can be called directly by using a type cast from 'WBEditWindow *' to 'WBChildFrame *', or by using the 'WBChildWindowFromWindowID()' function.

See also: TEXT_OBJECT

Function Documentation

◆ WBCreateEditWindow()

WBEditWindow* WBCreateEditWindow	(	WBFrameWindow *	pOwner,
		WB_FONT	pFont,
		const char *	szFocusMenu,
		const WBFWMenuHandler *	pHandlerArray,
		int	fFlags
	)

Create an Edit Window.

Parameters

pOwner	A pointer to the owning WBFrameWindow. Can not be NULL.
pFont	The desired font, or NULL to use the default
szFocusMenu	A const pointer to a text-based menu resource describing the menu that should appear when the Child Frame's tab has the focus. Can be NULL if none.
pHandlerArray	A const pointer to an array of WBFWMenuHandler structures for the 'focus' menu handler. Can be NULL if none.
fFlags	A bitwise 'or' of the desired flags associated with this Edit Window. See 'WBChildFrame_FLAGS'

Returns: a pointer to a WBEditWindow object describing the new edit window, or NULL on error

This function allows you to create an Edit Window that is a regular child of a frame window or dialog box, as a 'single document' handler. To create a window that uses the maximum available space within the client area of the parent, specify '-1' for iTop, iLeft, iWidth, and iHeight.

Header File: edit_window.h

Definition at line 276 of file edit_window.c.

◆ WBDestroyEditWindow()

void WBDestroyEditWindow ( WBEditWindow * pEditWindow )

Destroy an Edit Window.

Parameters

pEditWindow A pointer to the WBEditWindow structure for the edit window

Returns: void

Call this function on any pointer returned by WBCreateEditWindow to destroy it and free its resources.

Header File: edit_window.h

Definition at line 390 of file edit_window.c.

◆ WBEditWindowClear()

void WBEditWindowClear ( WBEditWindow * pEditWindow )

Clear the contents in the Edit Window, and NULL the stored file name.

Parameters

pEditWindow A pointer to the WBEditWindow structure

Use this function to clear an Edit Window, setting the file name to NULL

Header File: edit_window.h

Definition at line 564 of file edit_window.c.

◆ WBEditWindowFromWindowID()

WBEditWindow* WBEditWindowFromWindowID ( Window wID )

Obtain the associated WBEditWindow structure pointer for a Window ID.

Parameters

wID	A valid Window ID

Returns: A pointer to the associated WBEditWindow structure (if it is a WBEditWindow), or NULL on error

Use this function to safely obtain the correct WBEditWindow structure for a given Window ID.

Header File: edit_window.h

Definition at line 432 of file edit_window.c.

◆ WBEditWindowLoadFile()

int WBEditWindowLoadFile	(	WBEditWindow *	pEditWindow,
		const char *	pszFileName
	)

Open an existing file and read its contents into the Edit Window, storing the file name for later reference.

Parameters

pEditWindow	A pointer to the WBEditWindow structure
pszFileName	A (const) pointer to a character string containing the file name. PATH rules will be used to locate the actual file.

Returns: A value of zero if successful, non-zero on error.

Use this function to read a file into the Edit Window, replacing any existing contents.

Header File: edit_window.h

Definition at line 446 of file edit_window.c.

◆ WBEditWindowRegisterCallback()

void WBEditWindowRegisterCallback	(	WBEditWindow *	pEditWindow,
		WBWinEvent	pUserCallback
	)

Clear the contents in the Edit Window, and NULL the stored file name.

Parameters

pEditWindow	A pointer to the WBEditWindow structure
pUserCallback	A pointer to the callback function that handles messages (Return 0 for default handling, != 0 if handled). Can be NULL.

Use this function to specify a user callback for an Edit Window. By using this function to specify the callback, you ensure that proper 'Edit Window' event handling will still occur.

As with other callback functions that use WBWinEvent as their data type, you nee to return a value of zero to indicate 'perform default handling', non-zero if you handle the event and do NOT want 'default' handling.

Edit Windows can generate a number of custom Client Message events that are specific to Edit Windows.

Header File: edit_window.h

Definition at line 578 of file edit_window.c.

◆ WBEditWindowSaveFile()

int WBEditWindowSaveFile	(	WBEditWindow *	pEditWindow,
		const char *	pszFileName
	)

Save the contents from the Edit Window to a file, overwriting the file if it already exists.

Parameters

pEditWindow	A pointer to the WBEditWindow structure
pszFileName	A (const) pointer to a character string containing the file name. PATH rules will be used to locate the actual file. A value of NULL uses the stored file name.

Returns: A value of zero if successful, non-zero on error.

Use this function to write the contents of an Edit Window to a file, overwriting any existing file of the same name.

Header File: edit_window.h

Definition at line 538 of file edit_window.c.

◆ WBIsValidEditWindow()

static __inline__ int WBIsValidEditWindow ( WBEditWindow * pEditWindow )

static

Check for valid WBEditWindow pointer.

Parameters

pEditWindow A pointer to a WBEditWindow structure

Returns: non-zero if valid, zero if NOT valid

Header File: edit_window.h

Definition at line 281 of file edit_window.h.

Variable Documentation

◆ aEW_EDIT_CHANGE

Atom aEW_EDIT_CHANGE

'Edit Change' notification to user-callback, sent via ClientMessage event

EW_EDIT_CHANGE message format (relative to XEvent.xclient)
type == ClientMessage
message_type == aEW_EDIT_CHANGE
format == 32 (always)
data.l[0] A value of 1 to indicate text added or deleted, 2 for a 're-do', or 0 for an un-do operation
" data.l[1] The current row (0-based) (hover notify only)
data.l[2] The current column (0-based) (hover notify only)
The Edit Window sends this event directly to the callback specified by WBEditWindowRegisterCallback() whenever the Edit Window text has been modified due to UI interaction. If no user callback is specified (i.e. it is NULL) no such event will be generated the window itself.

Definition at line 210 of file edit_window.c.

◆ aEW_HOVER_NOTIFY

Atom aEW_HOVER_NOTIFY

Hover notification to user-callback, sent via ClientMessage event.

EW_HOVER_NOTIFY message format (relative to XEvent.xclient)
type == ClientMessage
message_type == aEW_HOVER_NOTIFY
format == 32 (always)
data.l[0] A value of 1 to indicate 'hover notify', zero to indicate 'hover cancel'
data.l[1] The current row (0-based) (hover notify only)
data.l[2] The current column (0-based) (hover notify only)
The Edit Window sends this event directly to the callback specified by WBEditWindowRegisterCallback() whenever the Edit Window receives a hover notification. If no user callback is specified (i.e. it is NULL) no such event will be generated the window itself.

Definition at line 192 of file edit_window.c.

Data Structures

Typedefs

Functions

Variables

Detailed Description

Typedef Documentation

◆ WBEditWindow

Function Documentation

◆ WBCreateEditWindow()

◆ WBDestroyEditWindow()

◆ WBEditWindowClear()

◆ WBEditWindowFromWindowID()

◆ WBEditWindowLoadFile()

◆ WBEditWindowRegisterCallback()

◆ WBEditWindowSaveFile()

◆ WBIsValidEditWindow()

Variable Documentation

◆ aEW_EDIT_CHANGE

◆ aEW_HOVER_NOTIFY