CDocTemplate:: GetDocString

virtu&al BOOL GetDocString ( CStringamp; rString, enum DocStringIndex índice ) const;

Valor de retorno

Diferente de zero se a Subcadeia especificada foi encontrada; caso contrário 0.

Parâmetros

rString

Uma referência a um objeto de CString que irá conter a Cadeia de caracteres quando a função retorna.

índice

Um índice da Subcadeia sendo recuperado da seqüência de caracteres que descreve o tipo de documento. Esse parâmetro pode ter um dos seguintes valores:

• CDocTemplate::windowTitlenbsp;  &Nome que aparece na barra (por exemplo, "Microsoft Excel") de título da janela do aplicativo. Apresentar apenas no modelo de documento para aplicativos SDI.
  
  
• CDocTemplate:: doc&Namenbsp;  Raiz para o nome de documento padrão (por exemplo, "Planilha"). Esta raiz, além de um número, é usado para o nome padrão de um novo documento deste tipo sempre que o usuário escolhe o comando novo no menu arquivo (por exemplo, "Plan1" ou "Sheet2"). Se não especificado, "Sem título" é usado como o padrão.
  
  
• CDocTemplate::file&NewNamenbsp;  Nome deste tipo de documento. Se o aplicativo oferecer suporte a mais de um tipo de documento, essa Cadeia de caracteres é exibida na caixa de diálogo novo arquivo (por exemplo, "planilha"). Se não for especificado, o tipo de documento é inacessível usando o comando novo arquivo.
  
  
• CDocTemplate::filter&Namenbsp;  Descrição do tipo de documento e um filtro curinga correspondência documentos deste tipo. Essa Cadeia de caracteres é exibida na lista Soltar-para baixo lista Files Of Type na caixa de diálogo arquivo abrir (por exemplo, "planilhas (xls)"). Se não for especificado, o tipo de documento é inacessível usando o comando arquivo abrir.
  
  
• CDocTemplate:: filterExt   Extensão para documentos deste tipo (por exemplo, ". xls"). Se não for especificado, o tipo de documento é inacessível usando o comando arquivo abrir.
  
  
• CDocTemplate::regFileTypeId   Identificador para o tipo de documento a ser armazenado no banco de dados de registo mantido pelo Windows. Essa Cadeia de caracteres é somente para uso interno (por exemplo, "ExcelWorksheet"). Se não for especificado, o tipo de documento não pode ser registrado com o Gerenciador de arquivos do Windows.
  
  
• CDocTemplate::regFileType&Namenbsp;  Nome do tipo de documento a ser armazenado no banco de dados registro. Essa Cadeia de caracteres pode ser exibida nas caixas de diálogo de aplicativos que acessem o banco de dados do registro (por exemplo, "planilha do Microsoft Excel").

Observações

Chame essa função para recuperar uma Subcadeia específica que descreve o tipo de documento. A Cadeia de caracteres que contém esses subseqüências é armazenada no modelo de documento e é derivada de uma Cadeia de caracteres no arquivo de recurso para o aplicativo. A estrutura chama essa função para obter as seqüências de caracteres necessárias para interface de usuário do aplicativo. Se você tiver especificado uma extensão de nome de arquivo para documentos do seu aplicativo, a estrutura também chama esta função quando adicionar uma entrada para o banco de dados de registro do Windows; Isso permite que documentos para ser aberto o Gerenciador de arquivos do Windows.

Chamar essa função somente se você estiver derivando sua própria classe de CDocTemplate.

Visão geral de CDocTemplate |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CMultiDocTemplate::CMultiDocTemplate, CSingleDocTemplate::CSingleDocTemplate, CWinApp::RegisterShellFileTypes