virtual BOOL GetDocString( CString& rString, enum DocStringIndex index ) const;
Возвращаемое значение
Отлично от нуля, если определенная подстрока была найдена, иначе 0.
Параметры
rString
Ссылка к объекту CString, который будет содержать строку после возврата функции.
index
Индекс подстроки, получаемой из строки, которая описывает тип документа. Этот параметр может иметь одно из следующих значений:
- CDocTemplate::windowTitle - Имя, которое появляется в области заголовка окна прикладной программы (например, " Microsoft Excel"). Представьте только в шаблоне документа для SDI прикладных программ.
- CDocTemplate::docName - Поддерживают заданное по умолчанию имя документа (например, "Лист"). Этот корень, плюс номер, используется для заданного по умолчанию имени нового документа относительно этого типа всякий раз, когда пользователь выбирает команду New из меню File (например, "Sheet1" или "Sheet2"). Если не определенный, "Неназванный" используется как значение по умолчанию.
- CDocTemplate::fileNewName - Имя этого типа документа. Если прикладная программа поддерживает больше чем один тип документа, эта строка отображается в диалоговом окне File New (например, "Рабочий лист"). Если не определенный, тип документа - недоступное использование команда File New.
- CDocTemplate::filterName - Описание типа документа и фильтра подстановочных знаков, соответствующего документы относительно этого типа. Эта строка отображается в списке файла раскрывающегося списка типа в диалоговом окне File Open (например, " Рабочие листы (*. xls) "). Если не определенный, тип документа - недоступное использование команда File Open.
- CDocTemplate::filterExt - Расширение для документов относительно этого типа (например, ".xls"). Если не определенный, тип документа - недоступное использование команда File Open.
- CDocTemplate::regFileTypeId - Идентификатор для типа документа, который будет сохранен в базе данных регистрации, поддерживаемой Windows. Эта строка - для внутреннего использования только (например, "ExcelWorksheet"). Если не определенный, тип документа не может быть зарегистрирован с Диспетчером файлов Windows.
- CDocTemplate::regFileTypeName - Имя типа документа, который будет сохранен в базе данных регистрации. Эта строка может отображаться в диалоговых окнах прикладных программ, которые обращаются к базе данных регистрации (например, " Microsoft Excel Worksheet").
Замечания
Вызовите эту функцию, чтобы получить специфическую подстроку, описывающую тип документа. Строка, содержащая эти подстроки сохранена в шаблоне документа и получена из строки в файле ресурса для прикладной программы. Рамка вызывает эту функцию, чтобы получить строки, требуется для интерфейса пользователя прикладной программы. Если Вы определили расширение имени файла для документов вашей прикладной программы, рамка также вызывает эту функцию при добавлении входа к базе данных регистрации Windows, это позволяет документам быть открытым из Диспетчера файлов Windows.
Вызовите эту функцию только, если Вы получаете ваш собственный класс из CDocTemplate.