CDocument::GetFile

virtual CFile* GetFile( LPCTSTR lpszFileName, UINT nOpenFlags, CFileException* pError );

Возвращаемое значение

Указатель на объект класса CFile.

Аргументы

0. lpszFileName — строка, содержащая путь к открываемому файлу. Путь может быть как относительным, так и абсолютным.

1. nOpenFlags — флаги, определяющие режим доступа к файлу, определяющие действия, которые необходимо предпринять при открытии файла. Эти флаги могут принимать те же самые значения, что и соответствующие флаги конструктора класса CFile и они, также, объединяются оператором побитового ИЛИ (|).Необходимо указать как минимум один флаг доступа и один флаг разделения ресурсов. Флаги modeCreate и modeNoInherit являются не обязательными.

2. pError — указатель на существующий объект класса исключений файла в который будут помещены результаты открытия файла.

Примечание

Данная функция используется для получения указателя на объект класса CFile.

CDocument::GetPathName

const CString& GetPathName( ) const;

Возвращаемое значение

Полный путь к файлу документа. Эта строка является пустой в том случае, если документ ещё не был сохранён или несвязан с дисковым файлом.

Примечание

Данная функция позволяет получить полный путь к файлу документа на диске.

CDocument::OnNewDocument

virtual BOOL OnNewDocument( );

Возвращаемое значение

Отличное от нуля, если документ был успешно инициализирован, в противном случае — 0.

Примечание

Вызывается приложением как часть обработки команды меню File, New. По умолчанию данная функция вызывает функцию DeleteContents, гарантирующую, что данный документ пуст, и отмечает данный документ, как пустой. В данную функцию следует помещать инициализацию всех структур данных нового документа, причём все операторы инициализации должны располагаться после вызова функции базового класса.

Если данная функция вызывается в однооконном приложении, то она уничтожает содержимое существующего документа. В случае многооконного приложения при выборе команды File, New происходит создание нового документа и уже для него вызывается данная функция. Поскольку в однооконном приложении класс документа создаётся с помощью конструктора при инициализации приложения, а новые документы создаются путём уничтожения текущего документа при запуске функции OnNewDocument, то все процедуры инициализации документа в однооконном приложении должны располагаться в данной функции, а не в конструкторе.

CDocument::ReleaseFile

virtual void ReleaseFile( CFile* pFile, BOOL bAbort );

Аргументы

0. pFile — указатель на объект класса CFile, который необходимо освободить.

1. bAbort — определяет функцию, которая будет использована при освобождении файла. Если данный аргумент имеет значение FALSE, то для освобождения файла используется функция CFile::Close, в противном случае используется функция CFile::Abort.

Примечание

Данная функция вызывается приложением для освобождения файла, делая его доступным для других приложений. Если аргумент bAbort имеет значение TRUE, то функция ReleaseFile вызывает функцию CFile::Abort и файл освобождается. Функция CFile::Abort не вызывает исключения. Если аргумент bAbort имеет значение FALSE, то функция ReleaseFile вызывает функцию CFile::Close и файл освобождается.

Данная функция перегружается в том случае, если пользователь должен выполнить определённые действия перед закрытием файла.