NAME

DtEditorSetContentsFromFile − load data from a file into a DtEditor widget

SYNOPSIS

#include <Dt/Editor.h>
DtEditorErrorCode DtEditorSetContentsFromFile(Widget widget,
char ∗fileName)

DESCRIPTION

The DtEditorSetContentsFromFile() function loads the contents of a file into a DtEditor widget. Any data currently in the DtEditor widget are lost. After the data is loaded, the insertion cursor is positioned at the first character.

The widget argument specifies the DtEditor widget ID. 

The fileName argument is the path and name of the file relative to the local system. 

For a complete definition of the DtEditor widget and its associated resources, see DtEditor(3). 

RETURN VALUE

Upon successful completion, the DtEditorSetContentsFromFile() function returns one of the following values when it sucessfully loads the data into the DtEditor widget:

DtEDITOR_NO_ERRORS
File is readable and writable

DtEDITOR_READ_ONLY_FILE
File is read only;

otherwise, if it cannot load the data into the DtEditor widget, the function returns one of the following values:

DtEDITOR_NONEXISTANT_FILE
File does not exist

DtEDITOR_DIRECTORY
File is a directory

DtEDITOR_CHAR_SPECIAL_FILE
File is a character-special device

DtEDITOR_BLOCK_MODE_FILE
File is a block-mode device

DtEDITOR_UNREADABLE_FILE
File is unreadable for an unlisted reason

APPLICATION USAGE

If the data is in memory, rather than a disk file, the application should use DtEditorSetContents(3). 

SEE ALSO

DtEditor(5), DtEditor(3), DtEditorAppend(3), DtEditorAppendFromFile(3), DtEditorGetContents(3), DtEditorInsert(3), DtEditorInsertFromFile(3), DtEditorReplace(3), DtEditorReplaceFromFile(3), DtEditorSaveContentsToFile(3), DtEditorSetContents(3). 
 
 
 

  —  30 July 1994