CDocTemplate::GetDocString

Artykuł
02/27/2013

Pobiera ciąg skojarzone z typem dokumentu.

virtual BOOL GetDocString(
   CString& rString,
   enum DocStringIndex index 
) const;

Parametry

rString
Odwołanie do CString obiekt, który będzie zawierać ciąg, gdy funkcja zwraca.
Indeks
Indeks podciągu pobierana z ciąg opisujący typ dokumentu.Ten parametr może mieć jedną z następujących wartości:
- CDocTemplate::windowTitle nazwę wyświetlaną na pasku (na przykład "Microsoft Excel") tytułu okna aplikacji.Obecnie tylko w szablonie dokumentu dla aplikacji SDI.
- CDocTemplate::docName główne nazwy dokumentu domyślnego (na przykład "Arkusz").Tego katalogu głównego oraz numer jest używany dla domyślnej nazwy nowego dokumentu tego typu w każdym przypadku, gdy użytkownik wybierze polecenie Nowy w menu Plik (na przykład "Arkusz1" lub "Arkusz2").Jeśli nie określono, "Untitled" jest używany jako domyślny.
- CDocTemplate::fileNewName nazwa tego typu dokumentu.Jeśli aplikacja obsługuje więcej niż jeden typ dokumentu, ten ciąg jest wyświetlany w oknie dialogowym Nowy plik (na przykład "Arkusz").Jeśli nie jest określona, typem dokumentu jest niedostępne, za pomocą polecenia nowy plik.
- CDocTemplate::filterName opis typu dokumentu i filtru symboli wieloznacznych, pasujące dokumenty tego typu.Ciąg ten jest wyświetlany na liście rozwijanej listy plików typu w oknie dialogowym Otwieranie pliku (na przykład "arkusze (*.xls)").Jeśli nie jest określona, typem dokumentu jest niedostępny przy użyciu polecenia Otwórz plik.
- CDocTemplate::filterExt rozszerzenie dokumenty tego typu (na przykład ".xls").Jeśli nie jest określona, typem dokumentu jest niedostępny przy użyciu polecenia Otwórz plik.
- CDocTemplate::regFileTypeId identyfikator typu dokumentu mają być przechowywane w bazie danych rejestracji obsługiwane przez system Windows.Ten ciąg jest tylko do użytku wewnętrznego (na przykład "ExcelWorksheet").Jeśli nie jest określony, typ dokumentu nie można zarejestrować Menedżera plików systemu Windows.
- CDocTemplate::regFileTypeName nazwę typu dokumentu mają być przechowywane w bazie danych rejestracji.Ten ciąg może być wyświetlana w oknach dialogowych aplikacjom dostęp do bazy danych rejestracji (na przykład "Arkusz Microsoft Excel").

Wartość zwracana

Niezerowa, jeśli określony podciąg został znaleziony; 0 inaczej.

Uwagi

Wywołanie tej funkcji do pobierania określonych podciąg, opisujący typ dokumentu.Ciąg zawierające podciągi te są przechowywane w szablonie dokumentu i pochodzi z ciągu w pliku zasobów dla aplikacji.Ramy wywołuje tę funkcję uzyskanie wymaganych dla interfejsu użytkownika aplikacji ciągi.Jeśli zostały określone rozszerzenie nazwy pliku dla aplikacji, dokumentów, ramy również wywołuje tę funkcję, dodając wpis do bazy danych rejestracji systemu Windows; Umożliwia to dokumenty otworzyć Menedżera plików systemu Windows.

Wywołanie tej funkcji tylko wtedy, gdy są wynikające z klasy z CDocTemplate.