CDocTemplate::GetDocString

Виртуальный BOOL GetDocString ( CString& rString, Enum DocStringIndex индекс ) const;

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

Ненулевое значение, если указанная подстрока был найден; в противном случае 0.

Параметры

rString

Ссылка на объект CString , который будет содержать строку, когда функция возвращает.

индекс

Индекс подстроки, полученных из строки, описывающей тип документа. Этот параметр может иметь одно из следующих значений:

• CDocTemplate::wi&ndowTitlenbsp;  Имя, отображаемое в заголовке окна приложения (например, "Microsoft Excel"). Представляем только в шаблон документа для приложения SDI.
  
  
• CDocTemplate::doc&Namenbsp;  Болеть за имя документа по умолчанию (например, «Лист»). Этот корень, а также ряд, используется имя по умолчанию новый документ этого типа всякий раз, когда пользователь выбирает команду создать в меню файл (например, «Лист1» или «Лист2»). Если не указан, «Без названия» используется как значение по умолчанию.
  
  
• CDocTemplate::file&NewNamenbsp;  Имя типа документа. Если приложение поддерживает несколько типов документов, эта строка отображается в новый файл диалоговом окне (например, "листа"). Если не указан, тип документа является недоступным, используя файл новой команды.
  
  
• CDocTemplate::filter&Namenbsp;  Описание типа документа и подстановочный фильтр соответствия документов данного типа. Эта строка отображается в раскрывающемся списке файлы типа списка в диалоговом окне Открыть файл (например, "листов (*.xls)"). Если не указан тип документа является недоступным, с помощью команды открыть файл.
  
  
• CDocTemplate::filterExt   Расширение для документов этого типа (например, ".xls"). Если не указан тип документа является недоступным, с помощью команды открыть файл.
  
  
• CDocTemplate::regFileTypeId   Идентификатор для типа документа для хранения в базе данных регистрации, поддерживаемых Windows. Эта строка — только для внутреннего использования (например, "ExcelWorksheet"). Если не указан тип документа не могут быть зарегистрированы в менеджере файлов Windows.
  
  
• CDocTemplate::regFileType&Namenbsp;  Имя типа документа для хранения в базе данных регистрации. Эта строка может отображаться в диалоговых окнах приложений, обращающихся к регистрационной базы данных (например, «лист Microsoft Excel").

Примечания

Эта функция вызывается для извлечения конкретного подстроки, описывающие тип документа. Строка, содержащая эти подстроки хранится в шаблоне документа и является производным от строки в файле ресурсов приложения. Платформа вызывает эту функцию для получения строк, необходимых ей для пользовательского интерфейса приложения. Если указано расширение имени файла для документов вашего приложения, платформа также вызывает эту функцию при добавлении записи в базу данных регистрации Windows; Это позволяет открывать документы из диспетчера файлов Windows.

Эта функция вызывается, только если вы извлекают из CDocTemplate -собственный класс.

Обзор CDocTemplate |  Члены класса | Иерархическая схема

См. также CMultiDocTemplate::CMultiDocTemplate, CSingleDocTemplate::CSingleDocTemplate, CWinApp::RegisterShellFileTypes