gecko-dev/include/edt.h

1474 строки
58 KiB
C

/* -*- Mode: C; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*-
*
* The contents of this file are subject to the Netscape Public License
* Version 1.0 (the "NPL"); you may not use this file except in
* compliance with the NPL. You may obtain a copy of the NPL at
* http://www.mozilla.org/NPL/
*
* Software distributed under the NPL is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the NPL
* for the specific language governing rights and limitations under the
* NPL.
*
* The Initial Developer of this code under the NPL is Netscape
* Communications Corporation. Portions created by Netscape are
* Copyright (C) 1998 Netscape Communications Corporation. All Rights
* Reserved.
*/
#ifndef _edt_h_
#define _edt_h_
#ifdef EDITOR
#ifndef _XP_Core_
#include "xp_core.h"
#endif
#ifndef _edttypes_h_
#include "edttypes.h"
#endif
XP_BEGIN_PROTOS
struct java_lang_Object;
/*****************************************************************************
* Layout Interface
*****************************************************************************/
/*
* Create an edit buffer, ready to be pared into.
*/
ED_Buffer* EDT_MakeEditBuffer(MWContext *pContext);
/*
* Destroy an edit buffer.
*/
void EDT_DestroyEditBuffer(MWContext * pContext);
/* CLM:
* Front end can call this to prevent doing
* bad stuff when we failed to load URL
* and don't have a buffer
*/
XP_Bool EDT_HaveEditBuffer(MWContext * pContext);
/*
* Call this to get a special string to feed the editor when you're
* creating an empty document.
* Returns an alias to a special empty document string.
* (You don't own the storage, so don't free it.)
*/
char* EDT_GetEmptyDocumentString(void);
/*
* Parse a tag into an edit buffer.
*/
ED_Element* EDT_ParseTag(ED_Buffer* pEditBuffer, PA_Tag* pTag);
/*
* Called instead of LO_ProcessTag. This routine allows the Edit enginge to
* build up an HTML tree. Inputs and outputs are the same as LO_ProcessTag.
*/
intn EDT_ProcessTag(void *data_object, PA_Tag *tag, intn status);
/*
* Tells the edit engine to position the insert point.
*/
void EDT_SetInsertPoint( ED_Buffer *pBuffer, ED_Element* pElement, int iPosition, XP_Bool bStickyAfter );
/*
* Assocates the layout element with a given edit element. Called from by the
* layout engine onces a layout element has been has been created.
*/
void EDT_SetLayoutElement( ED_Element* pElement, intn iEditOffset, intn lo_type,
LO_Element *pLayoutElement );
/* Breaks the association between a layout element and a given edit element.
* Called by the layout engine when a layout element is being destroyed.
*/
void EDT_ResetLayoutElement( ED_Element* pElement, intn iEditOffset,
LO_Element* pLayoutElement);
/*
* Delete all tags in the chain beginning with pTag.
*/
void EDT_DeleteTagChain( PA_Tag* pTag );
/*
* Retrieve the next tag element from the editor. Returns NULL when there are
* no more tags.
*/
PA_Tag* EDT_TagCursorGetNext( ED_TagCursor* pCursor );
/*
* enclosing html for a given point in the document
*/
PA_Tag* EDT_TagCursorGetNextState( ED_TagCursor* pCursor );
/*
* returns true if at the beginning of a paragraph or break.
*/
XP_Bool EDT_TagCursorAtBreak( ED_TagCursor *pCursor, XP_Bool* pEndTag );
/*
* Get the current line number for the cursor
*/
int32 EDT_TagCursorCurrentLine( ED_TagCursor* pCursor );
/*
* Get the current line number for the cursor
*/
XP_Bool EDT_TagCursorClearRelayoutState( ED_TagCursor* pCursor );
/*
* Clone a cursor. Used to save position state.
*/
ED_TagCursor* EDT_TagCursorClone( ED_TagCursor *pCursor );
/*
* Delete a cloned (or otherwise) cursor
*/
void EDT_TagCursorDelete( ED_TagCursor* pCursor );
/*
* called when LO finishes (only the first time)
*/
void EDT_FinishedLayout( MWContext *pContext );
/*
* Call back from image library giving the height and width of an image.
*/
void EDT_SetImageInfo(MWContext *context, int32 ele_id, int32 width, int32 height);
/*
* Test to see if the editor is currently loading a file.
*/
XP_Bool EDT_IsBlocked( MWContext *pContext );
/*****************************************************************************
* FE Interface
*****************************************************************************/
void EDT_SaveToBuffer ( MWContext * pContext, XP_HUGE_CHAR_PTR* pBuffer );
void EDT_ReadFromBuffer ( MWContext * pContext, XP_HUGE_CHAR_PTR pBuffer );
/*
* Returns ED_ERROR_NONE if files saved OK, else returns error code.
*/
ED_FileError EDT_SaveFile( MWContext * pContext,
char * pSourceURL,
char * pDestURL,
XP_Bool bSaveAs,
XP_Bool bKeepImagesWithDoc,
XP_Bool bAutoAdjustLinks );
/*
* Returns ED_ERROR_NONE if files saved OK, else returns error code.
*/
ED_FileError EDT_PublishFile( MWContext * pContext,
ED_SaveFinishedOption finishedOpt,
char * pSourceURL,
char **pIncludedFiles, /* list of files to publish */
char * pDestURL, /* Should be http:// or ftp:// */
XP_Bool bKeepImagesWithDoc,
XP_Bool bAutoAdjustLinks,
XP_Bool bSavePassword); /* Tied to user checkbox in dialog */
/*
* Check the URL that will be passed into EDT_PublishFile.
* Return TRUE if pURL should be used even with error, or FALSE if the user should
* make another choice - leave user in Publishing dialog
* We now internally correct for bad characters and missing file extensions,
* so the supplied string may have been changed.
* Caller should always update values in Publish dialog based
* on returned string after calling this
* New version returns EDT_PUBLISH_OK (0) if OK,
* ED_PUBLISH_ERROR_FILENAME (1) for error in filename, or
* ED_PUBLISH_ERROR_LOCATION (2) for error in location
*/
/* OTHER PLATFORMS NEED TO CHANGE THIS WHEN THEY CHANGE 2ND PARAM IN FE */
#ifdef XP_WIN
ED_PublishError EDT_CheckPublishURL( MWContext *pContext, char **ppURL);
#else
XP_Bool EDT_CheckPublishURL( MWContext * pContext, char * pURL);
#endif
/*
* Save editor and images to an abstract file system.
* Used by libmsg to write MHTML mail messages.
*/
ED_FileError EDT_SaveFileTo( MWContext * pContext,
ED_SaveFinishedOption finishedOpt,
char * pSourceURL,
void *tapeFS, /* Really a (ITapeFileSystem *) */
XP_Bool bKeepImagesWithDoc,
XP_Bool bAutoAdjustLinks );
/*
* Create a temporary file with the contents of the edit buffer, images and links
* will be adjusted to work from the new location. Call doneFn with the file:// URL
* of the temp file or NULL if failure. doneFn may be called before EDT_SaveToTempFile
* returns. Use EDT_RemoveTempFile when file is no longer needed.
*/
typedef void (*EDT_SaveToTempCallbackFn)(char *pFileURL,void *hook);
void EDT_SaveToTempFile(MWContext *pContext,EDT_SaveToTempCallbackFn doneFn, void *hook);
void EDT_RemoveTempFile(MWContext *pContext,char *pFileURL);
#if defined(MOZ_MAIL_COMPOSE) || defined(MOZ_MAIL_NEWS)
/*
* Like MSG_MailDocument, but will deal properly with dirty or unsaved documents.
* I.e. May save document to a temp file before attaching it to the new mail
* message.
*/
void EDT_MailDocument(MWContext *pContext);
#endif
/*
* Returns the temporary directory (in xpURL format) for all files associated with this document.
* Contents of this directory will be deleted when this edit buffer is destroyed.
*/
char *EDT_GetDocTempDir(MWContext *pContext);
/*
* Return a unique filename (in xpURL format) for a potential file in the documents temp directory. Does not actually
* create the file.
* If prefix is non-NULL, it will give the first few characters of the temp filename.
* Only the first three characters of prefix will be used.
* If extension is non-NULL, it will be the file extension, keep it <= 3 characters for windows,
* default is "TMP".
*/
char *EDT_CreateDocTempFilename(MWContext *pContext,char *prefix,char *extension);
/*
* cancel a load in progress
*/
void EDT_SaveCancel( MWContext *pContext );
/*
* Enable and disable autosave. A value of zero disables autosave.
* AutoSave doesn't start until the document has a file.
*/
void EDT_SetAutoSavePeriod(MWContext *pContext, int32 minutes);
int32 EDT_GetAutoSavePeriod(MWContext *pContext);
void EDT_DisplaySource( MWContext *pContext );
/*
* Edit Navagation prototypes
*/
void EDT_PreviousChar( MWContext *context, XP_Bool bSelect );
void EDT_NextChar( MWContext *context, XP_Bool bSelect );
void EDT_BeginOfLine( MWContext *context, XP_Bool bSelect );
void EDT_EndOfLine( MWContext *context, XP_Bool bSelect );
void EDT_BeginOfDocument( MWContext *context, XP_Bool bSelect );
void EDT_EndOfDocument( MWContext *context, XP_Bool bSelect );
void EDT_Up( MWContext *context, XP_Bool bSelect );
void EDT_Down( MWContext *context, XP_Bool bSelect );
void EDT_PageUp( MWContext *context, XP_Bool bSelect );
void EDT_PageDown( MWContext *context, XP_Bool bSelect );
void EDT_PreviousWord( MWContext *context, XP_Bool bSelect );
void EDT_NextWord( MWContext *context, XP_Bool bSelect );
/* We never select text when moving from cell to cell, so no bSelect.
bEndOfCell determines if caret is placed at beginning or
end of the next or previous cell's contents */
void EDT_NextTableCell( MWContext *context, XP_Bool bEndOfCell );
void EDT_PreviousTableCell( MWContext *context, XP_Bool bEndOfCell );
void EDT_WindowScrolled( MWContext *context );
/*
* Edit functional stuff...
*/
EDT_ClipboardResult EDT_DeletePreviousChar( MWContext *context );
EDT_ClipboardResult EDT_DeleteChar( MWContext *context );
void EDT_PositionCaret( MWContext *context, int32 x, int32 y );
/* Delete current selection and move caret to the insert point
* closest to supplied doc coordinates.
* Use when moving dragged data within the same window.
*/
void EDT_DeleteSelectionAndPositionCaret( MWContext *pContext, int32 x, int32 y );
/* Converts ("snaps") input X, Y (doc coordinates) to X, Y needed for drop caret
* and calls appropriate front-end FE_Display<Text|Generic|Image>Caret to use show where
* a drop would occur. It does NOT change current selection or internal caret position
* Also handles dragging table/cells and will return FALSE if mouse is
* not over a good drop location within a target table
* (Always returns TRUE if not dragging table or cells since
* cursor is always snapped to a valid position)
* Call during mouse moving over a window where drop can occur
*/
XP_Bool EDT_PositionDropCaret( MWContext *pContext, int32 x, int32 y );
/* Call to initialize global static data used for pasting table cells into existing table
* Returns TRUE if we are dragging table or table cells
*/
XP_Bool EDT_StartDragTable( MWContext *pContext, int32 x, int32 y );
/* Clear the XP data for dragging tables and cells */
void EDT_StopDragTable( MWContext *pContext );
XP_Bool EDT_IsDraggingTable( MWContext *pContext );
void EDT_DoubleClick( MWContext *context, int32 x, int32 y );
void EDT_SelectObject( MWContext *context, int32 x, int32 y);
EDT_ClipboardResult EDT_ReturnKey( MWContext *pContext );
/* Indent one level after doing regular ReturnKey processing
* Makes typing in lists easier
*/
EDT_ClipboardResult EDT_ReturnKeyAndIndent( MWContext *pContext );
/* Do what the TAB key should do
* Moves from cell to cell in Tables (in direction given by bForward)
* unless 3rd param is TRUE, which forces regular tab insert in table text
*/
EDT_ClipboardResult EDT_TabKey( MWContext *context, XP_Bool bForward, XP_Bool bForceTabChar );
void EDT_Indent( MWContext *context );
void EDT_Outdent( MWContext *context );
void EDT_RemoveList( MWContext *context );
void EDT_Reload( MWContext *pContext );
/*
* Kludge, supports only the windows front end now.
*/
EDT_ClipboardResult EDT_KeyDown( MWContext *context, uint16 nChar, uint16 b, uint16 c );
/*
* Insert a nonbreaking space character. Usually wired to shift spacebar
*/
EDT_ClipboardResult EDT_InsertNonbreakingSpace( MWContext *context );
/*
* Undo/Redo. Usage:
* To tell if there's a command to undo:
* if ( EDT_GetUndoCommandID(context, 0 ) != CEDITCOMMAND_ID_NULL )
*
* To undo the most recent command:
* EDT_Undo( context );
*
* (Similarly for redo.)
*
* Use the CommandID to look up a string for saying "Undo <type of command>..."
* on the menu.
*/
#define CEDITCOMMAND_ID_NULL 0
#define CEDITCOMMAND_ID_GENERICCOMMAND 1
void EDT_Undo( MWContext *pContext );
void EDT_Redo( MWContext *pContext );
intn EDT_GetUndoCommandID( MWContext *pContext, intn index );
intn EDT_GetRedoCommandID( MWContext *pContext, intn index );
/* Lets the front end specify the command history limit. This is used to limit the total of commands on
* both the undo and the redo lists.
*/
intn EDT_GetCommandHistoryLimit(void);
void EDT_SetCommandHistoryLimit(intn limit); /* Must be greater than or equal to zero. Ignored if less than zero. */
/* Call from dialogs to batch changes for undo. To use, call EDT_BeginBatchChanges,
* make the changes you want, and then call EDT_EndBatchChanges. It's OK to
* not make any changes -- in that case the undo history won't be affected.
*/
void EDT_BeginBatchChanges(MWContext *pContext);
void EDT_EndBatchChanges(MWContext *pContext);
/*
* Used to control display of paragraph marks.
*/
void EDT_SetDisplayParagraphMarks(MWContext *pContext, XP_Bool display);
XP_Bool EDT_GetDisplayParagraphMarks(MWContext *pContext);
/*
* Used to control display of tables in either wysiwyg or flat mode.
*/
void EDT_SetDisplayTables(MWContext *pContext, XP_Bool display);
XP_Bool EDT_GetDisplayTables(MWContext *pContext);
/*
* need to figure out how to handle tags and parameters.
*/
void EDT_MorphContainer( MWContext *pContext, TagType t );
TagType EDT_GetParagraphFormatting( MWContext *pContext );
ED_Alignment EDT_GetParagraphAlign( MWContext *pContext);
void EDT_SetParagraphAlign( MWContext* pContext, ED_Alignment eAlign );
/* Set Table alignment if caret is inside table or table is selected
* EDT_SetParagraphAlign will also to table if it is selected,
* so use this to force table alignment even if its not selected
*/
void EDT_SetTableAlign( MWContext* pContext, ED_Alignment eAlign );
/*
* Find out what's under the cursor
*/
ED_ElementType EDT_GetCurrentElementType( MWContext *pContext );
/*
* Character Formatting (DEPRECIATED)
* Routines should only be called when EDT_GetCurrentElementType() returns
* ED_ELEMENT_TEXT.
*/
ED_TextFormat EDT_GetCharacterFormatting( MWContext *pContext );
void EDT_FormatCharacter( MWContext *pContext, ED_TextFormat p);
/* Next 4 use the older "relative" scale of 1 to 7 */
/* Decrease or increase by 1 unit
* Goes through selection to keep relative size differences
*/
void EDT_DecreaseFontSize( MWContext *pContext );
void EDT_IncreaseFontSize( MWContext *pContext );
int EDT_GetFontSize( MWContext *pContext );
void EDT_SetFontSize( MWContext *pContext, int iSize );
/* These use the new absolute point size*/
void EDT_SetFontPointSize( MWContext *pContext, int iPoints );
int EDT_GetFontPointSize( MWContext *pContext );
/* List of Font faces - concatenated strings ending in '\0\0'
* Note: First 2 strings are for Default Proportional and Default Fixed width,
* the rest are the "NS Fonts" used to set the FONT FACE tag
* Use these to construct a list of fonts for the user
* We cache 1 static list of faces (implemented in EDTUTIL.CPP)
*/
char *EDT_GetFontFaces(void);
/* Similar to above, but gets a list of the Tag strings
* (what is written in FONT FACE tag that corresponds to a NS Font face name)
*/
char *EDT_GetFontFaceTags(void);
/* Set the Font Face - encapsulates complexity of EDT_CharacterData mangling
* If pCharacterData is suppled, then it is used to set fontface data
* (Note: pCharacterData is not freed).
* If pCharacterData is NULL, then data is obtained from current selection or at caret
* If pMWContext is supplied, then EDT_SetCharacterData() will be called
* with either the supplied struct or the internally-obtained data
*
* Supply either iFontIndex or pFontFace:
* iFontIndex is index within the font list returned by EDT_GetFontFaces(),
* (we will lookup the appropriate string to use for Font Face Tag)
* If pFontFace is supplied, use it exactly as is (iFontIndex is ignored)
*/
void EDT_SetFontFace(MWContext * pMWContext, EDT_CharacterData * pCharacterData,
int iFontIndex, char * pFontFace );
/* Get the index into the FontFace list for the current caret location or selection
* Returns 0 (ED_FONT_VARIABLE), 1 (ED_FONT_FIXED), or 2 (ED_FONT_LOCAL)
*/
int EDT_GetFontFaceIndex(MWContext *pContext);
/* Get the current font face for current selection or insert point
* If the current font matches an XP font 'group',
* this is the platform-specific font matching the group,
* else it is the font face string from EDT_CharacterData or
* the appropriate XP string for the Variable and Fixed Width states.
* Use this to search your local font list in menu or listbox.
*
An empty string is returned when selection is mixed (> 1 face in selection)
* DO NOT FREE RETURN VALUE (it is a static string), but use it quickly,
* because it will change as caret moves throught text
*/
char * EDT_GetFontFace(MWContext *pContext);
/* Find the pFontFace within each set of comma-delimeted FontFace groups
* Return pointer to entire group if pFontFace matches any single font in the group
* If not found, return pFontFace, thus the
* result can be passed directly as the last param of EDT_SetFontFace()
* Comparing pFontFace to result pointer can be used as test that XP font was found
* DO NOT free the resulting string pointer
*/
char * EDT_TranslateToXPFontFace( char * pFontFace );
XP_Bool EDT_GetFontColor( MWContext *pContext, LO_Color *pDestColor );
void EDT_SetFontColor( MWContext *pContext, LO_Color *pColor);
/* Get the current Cell, Table, or Page background based on caret location
* Returns the element type of the background we obtained, one of:
* ED_ELEMENT_NONE if error,
* ED_ELEMENT_TEXT (for page background)
* ED_ELEMENT_TABLE or ED_ELEMENT_CELL for table and cell
*/
ED_ElementType EDT_GetBackgroundColor( MWContext *pContext, LO_Color *pColor );
/* Set the selected cell or table's background, or current cell (contains caret)
or the page background (caret is not in a table) */
void EDT_SetBackgroundColor( MWContext *pContext, LO_Color *pColor );
/* Parse a font colors string in the format: "r,g,b,ColorName" where colors for r,g,b
* are decimal strings in range 0-255
* Returns pointer (within supplied string) to the Color Name
* and converts color strings into integers in supplied the LO_Color struct
*/
char * EDT_ParseColorString(LO_Color * pLoColor, char * pColorString);
/* Get the Netscape solid color. This replaces EDT_GetFontColorFromList */
void EDT_GetNSColor(intn iIndex, LO_Color * pLoColor);
/* Scan our list of colors and return index of matching color
* or -1 if no match found. We NEVER return 0 (default color)
*/
int EDT_GetMatchingFontColorIndex(LO_Color * pLOColor);
/*
* Get and set character formatting.
*/
/*
* EDT_GetCharacterData
* returns the current character formatting for the current selection
* or insert point. Should only be called when GetCurrentElementType is
* ED_ELEMENT_TEXT or ED_ELEMENT_SELECTION.
*
* returns and EDT_CharacterData structure. Caller is responsible for
* destroying the structure by calling EDT_FreeCharacterData().
*
* CharacterData contain on return
* pRet->mask // the that were deterministic (all in insertpoint case
* // and those that were consistant across the selection
* pRet->values // if in the mask, 0 means clear across the selection
* // 1 means set across the selection
*/
EDT_CharacterData* EDT_GetCharacterData( MWContext *pContext );
/*
* EDT_SetCharacterData
* sets the character charistics for the current insert point.
*
* the mask contains the bits to set
* values contains the values to set them to
*
* for example if you wanted to just change the font size to 10 and leave
* the rest alone:
*
* pData = EDT_NewCharacterData();
* pData->mask = TF_FONT_SIZE
* pData->value = TF_FONT_SIZE
* pData->iSize = 5;
* EDT_SetCharacterData( context ,pData );
* EDT_FreeCharacterData(pData);
*
*/
void EDT_SetCharacterData( MWContext *pContext, EDT_CharacterData *pData );
EDT_CharacterData* EDT_NewCharacterData(void);
void EDT_FreeCharacterData( EDT_CharacterData *pData );
/*
* Set character data for a given offset in the buffer.
*/
void EDT_SetCharacterDataAtOffset( MWContext *pContext, EDT_CharacterData *pData,
ED_BufferOffset iBufOffset, int32 iLen );
/*
* Returns colors of all the different fonts.
* Must call XP_FREE( pDest ) after use.
*/
int EDT_GetExtraColors( MWContext *pContext, LO_Color **pDest );
/*
* Selection
*/
void EDT_StartSelection(MWContext *context, int32 x, int32 y);
void EDT_ExtendSelection(MWContext *context, int32 x, int32 y);
void EDT_EndSelection(MWContext *context, int32 x, int32 y); /* cm */
void EDT_ClearSelection(MWContext *context);
void EDT_SelectAll(MWContext *context);
void EDT_SelectTable(MWContext *context);
void EDT_SelectTableCell(MWContext *context);
XP_Block EDT_GetSelectionText(MWContext *context);
XP_Bool EDT_IsSelected( MWContext *pContext );
XP_Bool EDT_SelectionContainsLink( MWContext *pContext );
/* Format all text contents into tab-delimited cells,
** with CR at end of each row.
** Use result to paste into Excell spreadsheets
*/
char *EDT_GetTabDelimitedTextFromSelectedCells( MWContext *pContext );
/* Test if there's a selection, and the beginning and end are not
* split across a cell boundary
*/
XP_Bool EDT_CanConvertTextToTable(MWContext *pMWContext);
/* Convert Selected text into a table (put each paragraph in separate cell)
* Number of rows is automatic - creates as many as needed
*/
void EDT_ConvertTextToTable(MWContext *pMWContext, intn iColumns);
/* Convert the table into text - unravel existing paragraphs in cells */
void EDT_ConvertTableToText(MWContext *pMWContext);
/* Adjust the top or bottom of the supplied rect to surround area of the caption
* Returns TRUE only if top or bottom was changed */
XP_Bool EDT_AdjustTableRectForCaption(LO_TableStruct *pTable, XP_Rect *pRect);
/* Save the character and paragraph style of selection or at caret */
void EDT_CopyStyle(MWContext *pMWContext);
/* This is TRUE after EDT_CopyStyle is called, until the next left mouse up call
* or user cancels with ESC key, or ??? (any suggestions?)
*/
XP_Bool EDT_CanPasteStyle(MWContext *pMWContext);
/* Apply the style to selection or at caret. Use bApplyStyle = FALSE to cancel */
void EDT_PasteStyle(MWContext *pMWContext, XP_Bool bApplyStyle);
XP_Bool EDT_DirtyFlag( MWContext *pContext );
void EDT_SetDirtyFlag( MWContext *pContext, XP_Bool bValue );
/*
* Clipboard stuff
*/
#define EDT_COP_OK 0
#define EDT_COP_DOCUMENT_BUSY 1
#define EDT_COP_SELECTION_EMPTY 2
#define EDT_COP_SELECTION_CROSSES_TABLE_DATA_CELL 3
EDT_ClipboardResult EDT_InsertText( MWContext *pContext, char *pText );
EDT_ClipboardResult EDT_PasteText( MWContext *pContext, char *pText );
#ifdef ENDER
EDT_ClipboardResult EDT_SetDefaultText( MWContext *pContext, char *pText ); /* can done before finishedload can be called. */
EDT_ClipboardResult EDT_SetDefaultHTML( MWContext *pContext, char *pText ); /* can done before finishedload can be called. */
#endif /*ENDER*/
EDT_ClipboardResult EDT_PasteHTML( MWContext *pContext, char *pHtml, ED_PasteType iPasteType );
/* Extract the int that says if we have full columns, rows, just cells, or a table in pBuffer
* Used by FE to give user more choices when pasting into existing table
*/
ED_CopyType EDT_GetHTMLCopyType(char *pBuffer);
/* Front end check for spreadsheet-formated text
(tabs between cells, CR at end of row, equal number of cells per row)
Optional(if pointers supplied): Return number of rows and columns in pText,
and if current caret is inside an existing table
*/
XP_Bool EDT_CanPasteTextAsTable(MWContext *pContext, char * pText,
intn *pRows, intn *pCols, XP_Bool *pIsInTable);
/* Paste text as a table. This will call EDT_CanPasteTextAsTable to be sure its OK
iPasteType applies only if we are inside an existing table,
to determine if we should insert a new table or how to integrate into existing table
*/
EDT_ClipboardResult EDT_PasteTextAsTable( MWContext *pContext, char *pText, ED_PasteType iPasteType );
/** API for pasting quoted text into the editor.
* Call EDT_PasteQuoteBegin, then call EDT_PasteQuoteINTL zero or more times,
* then call EDT_PasteQuoteEnd.
* If EDT_PasteQuoteBegin returns EDT_COP_OK then you must eventually call EDT_PasteQuoteEnd.
* If EDT_PasteQuoteBegin returns an error condition, then you must not call EDT_PasteQuoteEnd.
*
* The "quote" is something of a misnomer. The text isn't quoted. If you want it to be
* quoted, then you have to quote it yourself, before calling EDT_PasteQuoteINTL.
*/
EDT_ClipboardResult EDT_PasteQuoteBegin( MWContext *pContext, XP_Bool isHTML );
/* Pass in the csid of the pasted text. The editor will transcode
* the pasted text to the document's wincsid if nescessary. */
EDT_ClipboardResult EDT_PasteQuoteINTL( MWContext *pContext, char *pText, int16 csid );
/* The non-INTL version is only around for backwards compatability. */
EDT_ClipboardResult EDT_PasteQuote( MWContext *pContext, char *pText );
EDT_ClipboardResult EDT_PasteQuoteEnd(MWContext *pContext);
/*
* Can paste a singe or multiple HREFs. Pointer to array of HREF pointers and
* title pointers.
* Title pointers can be NULL
*/
EDT_ClipboardResult EDT_PasteHREF( MWContext *pContext, char **ppHref, char **ppTitle, int iCount);
/* Depreciated */
void EDT_DropHREF( MWContext *pContext, char *pHref, char* pTitle, int32 x,
int32 y );
/* Depreciated */
XP_Bool EDT_CanDropHREF( MWContext *pContext, int32 x, int32 y );
/*
* The text buffer should also be huge, it isn't
*/
EDT_ClipboardResult EDT_CopySelection( MWContext *pContext, char** ppText,
int32* pTextLen, XP_HUGE_CHAR_PTR* ppHtml, int32* pHtmlLen);
EDT_ClipboardResult EDT_CutSelection( MWContext *pContext,
char** ppText, int32* pTextLen,
XP_HUGE_CHAR_PTR* ppHtml, int32* pHtmlLen);
/*
* Use to enable or disable the UI for cut/copy/paste.
* If bStrictChecking is true, will check for all conditions,
* Otherwise, will just check if the selection is empty.
*/
EDT_ClipboardResult EDT_CanCut(MWContext *pContext, XP_Bool bStrictChecking);
EDT_ClipboardResult EDT_CanCopy(MWContext *pContext, XP_Bool bStrictChecking);
EDT_ClipboardResult EDT_CanPaste(MWContext *pContext, XP_Bool bStrictChecking);
/*
* returns true if we can set an HREF
*/
XP_Bool EDT_CanSetHREF( MWContext *pContext );
/*
* Get the current link under the cursor or inside the current selection.
*/
char *EDT_GetHREF( MWContext *pContext );
/*
* Get the anchor text of the current link under the cursor
*/
char *EDT_GetHREFText( MWContext *pContext );
/*
* Use HREF structure
*/
EDT_HREFData *EDT_GetHREFData( MWContext *pContext );
void EDT_SetHREFData( MWContext *pContext, EDT_HREFData *pData );
EDT_HREFData *EDT_NewHREFData( void );
EDT_HREFData *EDT_DupHREFData( EDT_HREFData *pData );
void EDT_FreeHREFData( EDT_HREFData *pData );
/*
* This routine can only be called when 'EDT_CanSetHREF()'
*/
void EDT_SetHREF(MWContext *pContext, char *pHREF );
/*
* Refresh the entire document.
*/
void EDT_RefreshLayout( MWContext *pContext );
/*
* Getting and setting properties of images. After Getting an image's properties
* the EDT_ImageData must be freed with EDT_FreeImageData(). Routines should
* only be called when EDT_GetCurrentElementType() returns ED_ELEMENT_IMAGE.
*/
EDT_ImageData *EDT_GetImageData( MWContext *pContext );
void EDT_SetImageData( MWContext *pContext, EDT_ImageData *pData, XP_Bool bKeepImagesWithDoc );
EDT_ImageData *EDT_NewImageData(void);
void EDT_FreeImageData( EDT_ImageData *pData );
void EDT_InsertImage( MWContext *pContext, EDT_ImageData *pData, XP_Bool bKeepImageWithdoc );
/* Value to display if EDT_ImageData::iBorder == -1. Different depending on whether the
image has a link or not. */
int32 EDT_GetDefaultBorderWidth( MWContext *pContext );
EDT_HorizRuleData *EDT_GetHorizRuleData( MWContext *pContext );
void EDT_SetHorizRuleData( MWContext *pContext, EDT_HorizRuleData *pData );
EDT_HorizRuleData *EDT_NewHorizRuleData( void );
void EDT_FreeHorizRuleData( EDT_HorizRuleData *pData );
void EDT_InsertHorizRule( MWContext *pContext, EDT_HorizRuleData *pData );
void EDT_ToggleList( MWContext *pContext, intn iTagType); /* All-in-one-call to create numbered or unnumbered lists. */
XP_Bool EDT_GetToggleListState( MWContext *pContext, intn iTagType);
EDT_ListData *EDT_GetListData( MWContext *pContext );
void EDT_SetListData( MWContext *pContext, EDT_ListData *pData );
void EDT_FreeListData( EDT_ListData *pData );
void EDT_InsertBreak( MWContext *pContext, ED_BreakType eBreak );
XP_Bool EDT_IsInsertPointInTable(MWContext *pContext );
XP_Bool EDT_IsInsertPointInNestedTable(MWContext *pContext );
EDT_TableData* EDT_GetTableData( MWContext *pContext );
/* If bCellParent = TRUE:
* Get width and height table enclosing current cell,
* (minus border and cell spacing)
* If bCell = FALSE:
* Get the width/height of current page or
* size the parent cell if insert point is in a nested table,
*/
void EDT_GetTableParentSize( MWContext *pContext, XP_Bool bCell, int32 *pWidth, int32 *pHeight );
void EDT_SetTableData( MWContext *pContext, EDT_TableData *pData );
EDT_TableData* EDT_NewTableData( void );
void EDT_FreeTableData( EDT_TableData *pData );
void EDT_InsertTable( MWContext *pContext, EDT_TableData *pData);
void EDT_DeleteTable( MWContext *pContext);
XP_Bool EDT_IsInsertPointInTableCaption(MWContext *pContext );
EDT_TableCaptionData* EDT_GetTableCaptionData( MWContext *pContext );
void EDT_SetTableCaptionData( MWContext *pContext, EDT_TableCaptionData *pData );
EDT_TableCaptionData* EDT_NewTableCaptionData( void );
void EDT_FreeTableCaptionData( EDT_TableCaptionData *pData );
void EDT_InsertTableCaption( MWContext *pContext, EDT_TableCaptionData *pData);
void EDT_DeleteTableCaption( MWContext *pContext);
XP_Bool EDT_IsInsertPointInTableRow(MWContext *pContext );
EDT_TableRowData* EDT_GetTableRowData( MWContext *pContext );
void EDT_SetTableRowData( MWContext *pContext, EDT_TableRowData *pData );
EDT_TableRowData* EDT_NewTableRowData(void);
void EDT_FreeTableRowData( EDT_TableRowData *pData );
void EDT_InsertTableRows( MWContext *pContext, EDT_TableRowData *pData, XP_Bool bAfterCurrentRow, intn number);
void EDT_DeleteTableRows( MWContext *pContext, intn number);
XP_Bool EDT_IsInsertPointInTableCell(MWContext *pContext );
EDT_TableCellData* EDT_GetTableCellData( MWContext *pContext );
/* Change the table selection and/or move to previous/next cell, row, or column
* depending on iMoveType.
* To just change the selection, set the iHitType to new type
* (ED_HIT_SEL_ROW, ED_HIT_SEL_COL, or ED_HIT_SEL_CELL) and set iMoveType to ED_MOVE_NONE
* To change to another row, col, or cell, set iHitType to same as that in pData or ED_HIT_NONE,
* and set iMoveType to ED_MOVE_PREV or ED_MOVE_NEXT
* If pData is not NULL, it is filled with data for the selected cells
* This will wrap around appropriately when end of selection or table is reached
*/
void EDT_ChangeTableSelection(MWContext *pContext, ED_HitType iHitType, ED_MoveSelType iMoveType, EDT_TableCellData *pData);
void EDT_SetTableCellData( MWContext *pContext, EDT_TableCellData *pData );
EDT_TableCellData* EDT_NewTableCellData( void );
void EDT_FreeTableCellData( EDT_TableCellData *pData );
void EDT_InsertTableCells( MWContext *pContext, EDT_TableCellData *pData, XP_Bool bAfterCurrentCell, intn number);
void EDT_DeleteTableCells( MWContext *pContext, intn number);
void EDT_InsertTableColumns( MWContext *pContext, EDT_TableCellData *pData, XP_Bool bAfterCurrentCell, intn number);
void EDT_DeleteTableColumns( MWContext *pContext, intn number);
XP_Bool EDT_IsInsertPointInLayer(MWContext *pContext );
EDT_LayerData* EDT_GetLayerData( MWContext *pContext );
void EDT_SetLayerData( MWContext *pContext, EDT_LayerData *pData );
EDT_LayerData* EDT_NewLayerData(void);
void EDT_FreeLayerData( EDT_LayerData *pData );
void EDT_InsertLayer( MWContext *pContext, EDT_LayerData *pData);
void EDT_DeleteLayer( MWContext *pContext);
EDT_PageData *EDT_GetPageData( MWContext *pContext );
EDT_PageData *EDT_NewPageData(void);
void EDT_SetPageData( MWContext *pContext, EDT_PageData *pData );
void EDT_FreePageData( EDT_PageData *pData );
/* Use to enable/disable Merge Cells feature.
* Selected cells can be merged only if in a continuous set
* within the same row or column.
* A single cell can be merged with cell to the right
* Returns 0 if neither conditions holds
*/
ED_MergeType EDT_GetMergeTableCellsType( MWContext *pContext );
/* Use to enable/disable Split Cell feature.
* Current cell (containing caret) can be split
* only if it has COLSPAN or ROWSPAN
*/
XP_Bool EDT_CanSplitTableCell( MWContext *pContext );
/* Set appropriate COLSPAN or ROWSPAN and move all
* cell contents into first cell of set
*/
void EDT_MergeTableCells( MWContext *pContext );
/* Separate paragraphs into sepaparate cells,
* removing COLSPAN or ROWSPAN
*/
void EDT_SplitTableCell( MWContext *pContext );
/* Take a single, selected image and turn it into the
* background image of page, deleting it from the page
*/
void EDT_SetImageAsBackground( MWContext *pContext );
/* Get and Set MetaData.
* Get the count of meta data objects.
* enumerate through them (0 based).
* If the name changes, a new meta data is created or may overwrite a different
* name value pair.
*/
intn EDT_MetaDataCount( MWContext *pContext );
EDT_MetaData* EDT_GetMetaData( MWContext *pContext, intn n );
EDT_MetaData* EDT_NewMetaData( void );
void EDT_SetMetaData( MWContext *pContext, EDT_MetaData *pMetaData );
void EDT_DeleteMetaData( MWContext *pContext, EDT_MetaData *pMetaData );
void EDT_FreeMetaData( EDT_MetaData *pMetaData );
/*******************************************************
* CLM: JAVA, PLUG-IN interface
*/
EDT_JavaData *EDT_GetJavaData( MWContext *pContext );
EDT_JavaData *EDT_NewJavaData(void);
void EDT_SetJavaData( MWContext *pContext, EDT_JavaData *pData );
void EDT_FreeJavaData( EDT_JavaData *pData );
EDT_PlugInData *EDT_GetPlugInData( MWContext *pContext );
EDT_PlugInData *EDT_NewPlugInData(void);
void EDT_SetPlugInData( MWContext *pContext, EDT_PlugInData *pData );
void EDT_FreePlugInData( EDT_PlugInData *pData );
/* Parameters: NAME=VALUE pairs used by both Java and PlugIns */
EDT_ParamData* EDT_GetParamData( MWContext *pContext, intn n );
EDT_ParamData* EDT_NewParamData(void);
void EDT_SetParamData( MWContext *pContext, EDT_ParamData *pParamData );
void EDT_DeleteParamData( MWContext *pContext, EDT_ParamData *pParamData );
void EDT_FreeParamData( EDT_ParamData *pParamData );
/*
* Get and Set Named Anchors (Targets)
*/
char* EDT_GetTargetData( MWContext *pContext );
void EDT_SetTargetData( MWContext *pContext, char *pTargetName );
void EDT_InsertTarget( MWContext *pContext, char* pTargetName );
char* EDT_GetAllDocumentTargets( MWContext *pContext );
/* Scroll (move insert point) to a target withing current document
* This tests for valid link to internal target, returns FALSE if not found
*/
XP_Bool EDT_ScrollToTarget(MWContext *pContext, char *pTargetURL);
/* Tells if URL is to an internal Target tag */
XP_Bool EDT_IsInternalLink(MWContext *pContext, char *pURL);
/* Get text to display on status line: "Target Name: name" */
char* EDT_GetTargetNameFromIcon(LO_ImageStruct *pIcon);
/*CLM: Check current file-update time and
* return TRUE if it is different
* Save the newly-found time in edit buffer class
*/
XP_Bool EDT_IsFileModified( MWContext* pContext );
/* CLM: Read a file and build a targets list just like the current doc list */
char* EDT_GetAllDocumentTargetsInFile( MWContext *pContext, char *pHref);
/*
* Returns a list of all local documents associated with
* the current buffer.
*/
char* EDT_GetAllDocumentFiles( MWContext *pContext );
/*
* Also sets ppSelected to be a list of whether each local document should be
* saved/published/sent by default. Must pass in the preference for whether images
* are sent along with the document.
*/
char* EDT_GetAllDocumentFilesSelected( MWContext *pContext, XP_Bool **ppSelected,
XP_Bool bKeepImagesWithDoc );
/*
* Get and Set UnknownTags
*/
char *EDT_GetUnknownTagData( MWContext *pContext );
void EDT_SetUnknownTagData( MWContext *pContext, char *pUnknownTagData );
void EDT_InsertUnknownTag( MWContext *pContext, char* pUnknownTagData );
/* CLM: Validate: check for matching quotes, "<" and ">" if bNoBrackets is FALSE
* Skip (and strip out) <> if bNoBrackets is TRUE,
* used for Attributes-only, such as MOCHA string in HREF
*/
ED_TagValidateResult EDT_ValidateTag( char *pData, XP_Bool bNoBrackets );
/*
* Called by the front end when the user presses the cancel button on the
* Modal dialog
*/
void EDT_ImageLoadCancel( MWContext *pContext );
/*****************************************************************************
* Property Dialogs
*****************************************************************************/
#if 0
/*
* String allocation functions for parameters passed to EDT_Property functions
*/
char *EDT_StringDup(char *pDupString);
void EDT_StringFree(char* pString);
void EDT_GetPageProperties( ED_PageProperties *pProps );
void EDT_SetPageProperties( ED_PageProperties *pProps );
void EDT_GetParagraphProperties( ED_ParagraphProperties *pProps );
void EDT_SetParagraphProperties( ED_ParagraphProperties *pProps );
#endif
/*****************************************************************************
* Utility stuff.
*****************************************************************************/
/* for debug purposes. */
char *EDT_TagString(int32 tagType);
#ifdef DEBUG
void EDT_VerifyLayoutElement( LO_Element *pLoElement );
#endif
/* Cross platform macros */
/* we may changed how we define editor status */
#define EDT_IS_NEW_DOCUMENT(context) (context != NULL && context->is_editor && context->is_new_document)
#define EDT_NEW_DOCUMENT(context,b) if(context != NULL) context->is_new_document=(context->is_editor&&b)
/* Helper to gray UI items not allowed when inside Java Script
* Note that the return value is TRUE if mixed selection,
* allowing the non-script text to be changed.
* Current Font Size, Color, and Character attributes will suppress
* setting other attributes, so it is OK to call these when mixed
*/
XP_Bool EDT_IsJavaScript(MWContext *pContext);
/* Helper to use for enabling Character properties
* (Bold, Italic, etc., but DONT use for clearing (TF_NONE)
* or setting Java Script (Server or Client)
* Tests for:
* 1. Good edit buffer and not blocked because of some action,
* 2. Caret or selection is NOT entirely within Java Script,
* 3. Caret or selection has some text or is mixed selection
* (thus FALSE if single non-text object is selected)
*/
XP_Bool EDT_CanSetCharacterAttribute(MWContext *pContext);
/* Replace the current selection with supplied text */
/* if bReplaceAll is true then pTextToLookFor and the 3 subsequent Boolean need to be set */
void EDT_ReplaceText(MWContext *pContext, char * pReplaceText, XP_Bool bReplaceAll,
char *pTextToLookFor, XP_Bool bCaseless, XP_Bool bBackward, XP_Bool bDoWrap);
#ifdef FIND_REPLACE
/* Currently (12/3/97) not used */
XP_Bool EDT_FindAndReplace(MWContext *pContext, EDT_FindAndReplaceData *pData );
#endif
/* Dynamic Object Sizing
* Note:xVal and yVal for all functions are in Document coordinates
* After calling EDT_StartSizing, either EDT_EndSizing or EDT_CancelSizing
* must be called.
*/
/* How close cursor must be to border to start sizing */
#define ED_SIZING_BORDER 6
/* Get the sizing, selection, or add row/column type define (0 if not at a hit region)
* where xVal, yVal is Cursor position we are over
* This ignores anything inside of tables or cells, so don't call it
* if you want to size an image contained within a cell (use EDT_CanSizeObject instead)
* ppElement is optional: If supplied, the relevant table or cell element is returned
* (a cell ptr is returned for the row/col operations - use this to get col. or row members)
* bModifierKeyPressed is applicable if selecting table (upper left corner)
* or extending selection to multiple cells
* If TRUE (Ctrl key is pressed in Windows), returns
* ED_HIT_SEL_ALL_CELLS instead of ED_HIT_SEL_TABLE
*/
ED_HitType EDT_GetTableHitRegion(MWContext *pContext, int32 xVal, int32 yVal,
LO_Element **ppElement, XP_Bool bModifierKeyPressed);
/* Wrapper for ease of use -- gets last-selected table object's hit type and element */
ED_HitType EDT_GetSelectedTableElement(MWContext *pContext, LO_Element **ppElement);
/* Select a Table, Row, Column, or Cell
* iHitType is a define returned by EDT_GetTableHitRegion()
* Returns TRUE if selection was done - it will fail if
* missing pointers or iHitType doesn't match pLoElement type or
* is not an allowable type for doing selection.
* Selection rules:
* Table: Any corner is OK (ED_HIT_SEL_TABLE, ED_HIT_SIZE_TABLE, ED_HIT_ADD_ROWS, or ED_HIT_ADD_COLS)
* Column: Top of table above desired column (ED_HIT_SEL_COL)
* Row: Left edge of table next to desired row (ED_HIT_SEL_ROW)
* Cell: Left or top edge of cell, including upper right corner (ED_HIT_SEL_CELL)
*
* x and y values are used only when selecting rows or columns
*
* if pLoElement == NULL, we find it from current edit element
* (use it this way to select items from a menu when caret is inside a table)
*
* If bAppendSelection is TRUE, new cells will be added to current selection
* (ignored if selecting a table - all cell selection is cleared for that)
*
* If bExtendSelection is TRUE (Shift key is pressed),
* select all cells withing smallest rect from first-selected to supplied cell
*/
XP_Bool EDT_SelectTableElement(MWContext *pMWContext, int32 x, int32 y,
LO_Element *pLoElement,
ED_HitType iHitType,
XP_Bool bModifierKeyPressed, XP_Bool bExtendSelection);
/* Called on mouse-move message after selection was started
* on a row, column, or cell element
* Returns the hit type: ED_HIT_SEL_ROW, ED_HIT_SEL_COL, ED_HIT_SEL_CELL, or ED_HIT_NONE
* reflecting what type of block we are extended,
* or ED_HIT_NONE if mouse is outside of the table
* Use this to set the type of cursor by the FEs
*/
ED_HitType EDT_ExtendTableCellSelection(MWContext *pMWContext, int32 x, int32 y);
/* Clear the all selected table or cells */
void EDT_ClearTableAndCellSelection(MWContext *pMWContext);
XP_Bool EDT_IsTableSelected(MWContext *pMWContext);
int EDT_GetSelectedCellCount(MWContext *pMWContext);
/* Clear any existing cells selected if current edit element is not inside selection
* Call before poping up context menu inside table
*/
void EDT_ClearCellSelectionIfNotInside(MWContext *pMWContext);
/* Call just before bringing up the Table Properties dialog
* Supply cell data struct so the iSelectionType and iSelectedCount are filled-in
*/
void EDT_StartSpecialCellSelection(MWContext *pMWContext, EDT_TableCellData *pCellData);
/* Call after closing the Table Properties dialog */
void EDT_ClearSpecialCellSelection(MWContext *pMWContext);
/* Called from lo_EndTable (laytable.c) to build list of tables being redrawn */
void EDT_AddToRelayoutTables(MWContext *pMWContext, LO_TableStruct *pLoTable );
/* Called after every table layout so editor size data is accurate */
void EDT_FixupTableData(MWContext *pMWContext);
/* Get the sizing type define (0 if not at a sizing location)
* where xVal, yVal is Cursor position and pElement is the element
* we are over -- if NULL, we will find it (param used for efficiency)
*/
ED_SizeStyle EDT_CanSizeObject(MWContext *pContext, LO_Element *pLoElement, int32 xVal, int32 yVal);
/* Return TRUE if we are currently sizing
*/
XP_Bool EDT_IsSizing(MWContext *pContext);
/* If bLockAspect is TRUE, constrain rect to keep original aspect ratio
* This returns the rect to draw sizing feedback in View's coordinate system
* Returns sizing style if sizing was started OK
*/
ED_SizeStyle EDT_StartSizing(MWContext *pContext, LO_Element *pLoElement, int32 xVal, int32 yVal,
XP_Bool bLockAspect, XP_Rect *pRect);
/* Get the rect in View coordinates, so you can use it
* directly for drawing "selection feedback"
* Returns TRUE if this rect is different from the last
* one calculated by EDT_StartSizing or EDT_GetSizingRect,
* so you need to do sizing feedback only if we return TRUE;
*/
XP_Bool EDT_GetSizingRect(MWContext *pContext, int32 xVal, int32 yVal,
XP_Bool bLockAspect, XP_Rect *pRect);
/* Uses rect (xVal and yVal) from last mouse move to
* get new width and height and change current object size
*/
void EDT_EndSizing(MWContext *pContext);
/* Call this to abort sizing
*/
void EDT_CancelSizing(MWContext *pContext);
/*
* Editor plugin interface
* The strings returned by this interface are from the Java heap. This means that
* they will automaticly be garbage collected once there is no thread that
* is refering to them. So XP_STRDUP them if you want to hold onto them.
*/
void EDT_RegisterPlugin(char* csFileSpec); /* Called by front end to register a plugin file. */
/* The following calls are cheap enough to be called as often as you like. */
int32 EDT_NumberOfPluginCategories(void);
int32 EDT_NumberOfPlugins(int32 category);
/* The result strings are garbage collected by the Java runtime. They are in UTF8 encoding. */
char* EDT_GetPluginCategoryName(int32 category);
char* EDT_GetPluginName(int32 category, int32 index);
char* EDT_GetPluginMenuHelp(int32 category, int32 index);
/*
* Perform a Composer Plugin by category and index. Returns TRUE if the Plug-in was launched
* successfully. Returns FALSE if the Plug-in failed to run. If this method returns true, then
* the actual Plug-in runs asynchronously. When the plugin completes, doneFunction is called
* in the main UI thread. Alternatively, you can poll EDT_IsPluginActive to find out when the
* Plug-in is done.
* If you don't want to be called back when the plugin completes, pass NULL for doneFunction.
* "hook" is a variable for you to use any way you want. It is passed back to your doneFunction.
*/
XP_Bool EDT_PerformPlugin(MWContext *pContext, int32 category, int32 index, EDT_ImageEncoderCallbackFn doneFunction, void* hook);
/*
* Just like EDT_PerformPlugin, except that the Plugin is identified by className rather than by
* category and index. The className is a fully qualified Java class name in UTF8 encoding.
* doneFunction can be NULL, in which case it won't be called.
* Under some circumstances, the doneFunction may be called immediately.
*/
XP_Bool EDT_PerformPluginByClassName(MWContext *pContext, char* className, EDT_ImageEncoderCallbackFn doneFunction, void* hook);
/*
* Just like EDT_PerformPlugin, except that all event handlers are called for
* a particular event.
* doneFunction can be NULL, in which case it won't be called.
* Under some circumstances, the doneFunction may be called immediately.
* pDocURL can be null, or empty
*/
void EDT_PerformEvent(MWContext *pContext, char* pEvent, char* pDocURL, XP_Bool bCanChangeDocument, XP_Bool bCanCancel,
EDT_ImageEncoderCallbackFn doneFunction, void* hook);
XP_Bool EDT_IsPluginActive(MWContext* pContext);
void EDT_StopPlugin(MWContext* pContext);
/* Used internally by the Composer Plug-in implementation.
*/
void EDT_ComposerPluginCallback(MWContext* pContext, int32 action,
struct java_lang_Object* pArg);
/* Image encoder interface.
* The strings returned by this interface are from the Java heap. This means that
* they will automaticly be garbage collected once there is no thread that
* is refering to them. So XP_STRDUP them if you want to hold onto them.
*/
int32 EDT_NumberOfEncoders(void);
char* EDT_GetEncoderName(int32 index); /* The human name of the encoding. e.g. JPEG */
char* EDT_GetEncoderFileExtension(int32 index); /* The file extension, without the period. e.g. jpg */
char* EDT_GetEncoderFileType(int32 index); /* The Macintosh FileType field. An array of 4 characters. */
char* EDT_GetEncoderMenuHelp(int32 index); /* A sentence describing the encoding. e.g. Joint Picture Encoding Group */
XP_Bool EDT_GetEncoderNeedsQuantizedSource(int32 index); /* TRUE if the encoder needs 256 distinct colors or less. */
/* Returns FALSE if there was a problem, or TRUE if the encoder was started successfully.
* The pixels are copied -- you can dispose of the pixels as soon as EDT_StartEncoder returns.
*
*/
XP_Bool EDT_StartEncoder(MWContext* pContext, int32 index, int32 width, int32 height, char** pixels,
char* csFileName, EDT_ImageEncoderCallbackFn doneFunction, void* hook);
/* Will stop the encoder, and will cause the doneFunction to be called. */
void EDT_StopEncoder(MWContext* pContext);
/* Save and restore the cursor position or selection
*/
ED_BufferOffset EDT_GetInsertPointOffset( MWContext *pContext );
void EDT_SetInsertPointToOffset( MWContext *pContext, ED_BufferOffset i,
int32 iLen );
/* Given a character offset, return the layout element and offset for that character
*/
void EDT_OffsetToLayoutElement( MWContext *pContext, ED_BufferOffset i,
LO_Element * *element, int32 *caretPos);
ED_BufferOffset EDT_LayoutElementToOffset( MWContext *pContext,
LO_Element *element, int32 caretPos);
/* Return the layout textblock for a text element
*/
LO_TextBlock* EDT_GetTextBlock(MWContext *pContext, LO_Element *le);
/* Spell check API
*/
XP_Bool EDT_SelectFirstMisspelledWord( MWContext *pContext );
XP_Bool EDT_SelectNextMisspelledWord( MWContext *pContext );
XP_HUGE_CHAR_PTR EDT_GetPositionalText( MWContext* pContext );
void EDT_SetRefresh( MWContext *pContext, XP_Bool bRefreshOn );
void EDT_ReplaceMisspelledWord( MWContext *pContext, char* pOldWord,
char*pNewWord, XP_Bool bAll );
/* Ignore a misspelled word.
* If pWord != NULL and bAll == TRUE. ignore all instances of the specified word
* If pWord == NULL, ignore all misspelled words
*/
void EDT_IgnoreMisspelledWord( MWContext *pContext, char* pWord,
XP_Bool bAll );
/* The selection is 1/2 open -- if the start and end are the same value, then
* the selection is an insertion point.
*/
void EDT_GetSelectionOffsets(MWContext *pContext, ED_BufferOffset* pStart, ED_BufferOffset* pEnd);
/*
* Set the document encoding. Returns TRUE if the encoding
* was changed, or FALSE if it was not. (An encoding change
* may require a save of the current document. The user may
* cancel the save.)
*
*/
XP_Bool EDT_SetEncoding(MWContext* pContext, int16 csid);
/* Take the document for current contextand change appropriate
* params to make it look like a "Untitled" new document
* Allows loading any document as a "Template"
*/
void EDT_ConvertCurrentDocToNewDoc(MWContext * pMWContext);
/* Assemble the filename part from supplied URL to
* the base URL, replacing any filename in the latter
* pURL can be most anything, full URL or local filename
* If NULL, pBaseURL is returned without its filename
* (Use this to strip off filename from a base URL);
* Caller must free returned string
*/
char * EDT_ReplaceFilename(char * pBaseURL, char * pURL, XP_Bool bMustHaveExtension);
/* Simply returns the filename part of a URL or local filespec
* Stuff starting with "#" or "?" is ommited
* Used with EDT_ReplaceFilenam(pURL, NULL) parse out a URL
* into separate "directory" and "filename" parts
* If bMustHaveExtension is TRUE, then name after last "/" or "\"
* must have a period indicating it has an extension
* Note: Assumes bMustHaveExtension = TRUE when getting filename
* Caller must free returned string
*/
char * EDT_GetFilename(char * pURL, XP_Bool bMustHaveExtension);
/* Return a destination URL for publishing:
* If last-failed-published URL (saved globally) is same as URL about to be published,
* then always returns the location, Username, and password last attempted,
* obtained from prefs: "editor.publish_last_loc" and "editor.publish_last_password"
* else:
* If current page URL is
* 1. Remote URL: Return current page name as is, with anything after filename stripped
* 2. Local File: Return last-good location (from pref: "editor.publish_history_0")
* or default (if no last-location) from "editor.publish_location"
* *ppFilename is set to filename portion of current page
* and UserName is parsed out the pref string and returned in ppUsername
* 3. New (unsaved) page: Return pref URL as above, but *ppFilename is set to NULL
*
* Note: Assumes bMustHaveExtension = TRUE when getting filename
* If available, the last-used password is also supplied
* Caller must free returned strings
*/
char * EDT_GetDefaultPublishURL(MWContext * pMWContext, char **ppFilename, char **ppUserName, char **ppPassword);
/* The maximum number of history items shown */
#define MAX_EDIT_HISTORY_LOCATIONS 10
/*
* Get the location, username, and password (plain text) for the Nth
* publish history location. Caller must XP_FREE the returned location,
* username, passwd.
*/
/* OTHER PLATFORMS NEED TO CHANGE CALL TO PASS IN pMWContext */
#ifdef XP_WIN
XP_Bool EDT_GetPublishingHistory(MWContext *pMWContext, unsigned n, char** ppLocation, char** ppUsername, char** ppPassword);
#else
XP_Bool EDT_GetPublishingHistory(unsigned n, char** loc, char** u, char** p);
#endif
/* Get URL and TITLE from the recently-edited history list kept in preferences
* Similar to Publish history list, except caller should NOT XP_FREE the returned strings
* because they are cached in local string arrays for quicker access
*
* Supply MWContext pointer to check if the current document is
* in the list before or at the requested URL.
* If it is, the next item is returned instead, thus the current doc
* never shows up in the list
* Because of this behavior, this function should be used with MWContext*
* both to build the menu items and also to get the URL when the menu item is executed
*
* Note: If there is no Title, *pTitle is set to NULL
* (Front ends should use a compressed version of pUrl instead)
*/
XP_Bool EDT_GetEditHistory(MWContext * pMWContext, unsigned n, char** pUrl, char** pTitle);
/* Call this after opening a file or URL to make it
* the most-recently-edited document in the URL history in preferences
*/
void EDT_SyncEditHistory(MWContext * pMWContext);
/* Called from NET_AskForAuthString in mkaccess.c to tell us the correct
username after the dialog to enter it was used
*/
void EDT_SavePublishUsername(MWContext *pContext, char *pAddress, char *pUsername);
/* Get location, username, and password from the user prefs or the Netcenter publishing data */
XP_Bool EDT_GetUserDefaultPublishData(MWContext *pMWContext, char **ppLocation, char **ppUserName, char **ppPassword);
XP_Bool EDT_GetNetcenterPublishData(MWContext *pMWContext, char **ppLocation, char **ppUserName, char **ppPassword);
/* Construct a page title from supplied filename,
* Extracts the filename part WITHOUT extension
* Stuff starting with "#" or "?" is ommited
* Caller must free returned string
*/
char * EDT_GetPageTitleFromFilename(char * pFilename);
/*
* Call EDT_PreOpen when the user requests that you open an existing HTML document.
* You will get called back with status that indicates whether or not to open the
* document. You can pass anything you want as the hook argument -- it will be
* passed back to you.
*
* The MWContext passed to EDT_PreOpen is only used for reporting errors.
*
* Use the pURL that's passed back to you as the URL to open -- it may be different
* than the URL you passed in.
*
* Note: Unlike other similar calls, in EDT_PreOpen the doneFunction will always be
* called. Under certain circumstances, however, the doneFunction will be called
* immediately, before EDT_PreOpen even returns.
*
*/
typedef void (*EDT_PreOpenCallbackFn)(XP_Bool bUserCancled, char* pURL, void* hook);
void EDT_PreOpen(MWContext *pErrorContext,char* pURL, EDT_PreOpenCallbackFn doneFunction, void* hook);
/*
* Call EDT_PreClose when an editor context is about to be closed. Don't actually
* close the window until the passed in callback function is called.
*
* Similar to EDT_PreOpen, the doneFunction will always be called, and may be called
* befre EDT_PreClose returns.
*
*/
typedef void (*EDT_PreCloseCallbackFn)(void* hook);
void EDT_PreClose(MWContext * pMWContext,char* pURL, EDT_PreCloseCallbackFn doneFunction, void* hook);
/*
* True if both urls are the same, ignores any username/password
* information. Does caseless comparison for file:// URLs
* on windows and mac.
* url1 and url2 are relative to base1 and base2, respectively.
* If url1 or url2 is already absolute, base1 or base2 can
* be passed in as NULL.
*/
XP_Bool EDT_IsSameURL(char *url1,char *url2,char *base1,char *base2);
/* Check for valid image file extensions
* Used primarily to NOT mangle image URLs that are not really files,
* but server-generated images, as with counter URLs
*/
XP_Bool EDT_IsImageURL(char *pImageURL);
/*
* Extract the Extra HTML string from the ED_Element pointer in an image struct
* (ED_Element is a void* to external users
* Implemented in edtutil.cpp
* Caller must XP_FREE result
*/
char * EDT_GetExtraHTML_FromImage(LO_ImageStruct *pImage);
XP_Bool EDT_IsWritableBuffer(MWContext *pContext);
/*
* Hack in pre-encrypted files into the editor. This function lets us
* treat the editor's TapeFS as a net stream without all the baggage associated
* with the regular edt_Stream functions.
*/
NET_StreamClass *EDT_NetToTape(void *);
/*
* Several functions to handle the encrypt/no-encrypt flag
*/
void EDT_EncryptToggle(MWContext *pContext);
void EDT_EncryptSet(MWContext *pContext);
void EDT_EncryptReset(MWContext *pContext);
PRBool EDT_EncryptState(MWContext *pContext);
/* Used for QA only - Ctrl+Alt+Shift+N accelerator for automated testing */
void EDT_SelectNextNonTextObject(MWContext *pContext);
XP_END_PROTOS
#endif /* EDITOR */
#endif /* _edt_h_ */