次の方法で共有

CDocTemplate::MatchDocType

  • [アーティクル]

ドキュメントの型とテンプレート間で、一致の信頼度を調べます。

virtual Confidence MatchDocType(
   LPCTSTR lpszPathName,
   CDocument*& rpDocMatch 
);

パラメーター

  • lpszPathName
    型が決定されるファイルのパス名。

  • rpDocMatch
    lpszPathName で指定されたファイルが既に開いている場合、一致するドキュメントが割り当てられているドキュメントへのポインター。

戻り値

次のように定義されている Confidence の列挙値の場合:

enum Confidence

{

noAttempt,

maybeAttemptForeign,

maybeAttemptNative,

yesAttemptForeign,

yesAttemptNative,

yesAlreadyOpen

};

解説

ドキュメント テンプレートの種類をファイルを開くために使用するように確認するには、この関数を使用します。アプリケーションが複数のファイルの種類をサポートする場合は、たとえば、各テンプレートに対して MatchDocType を順番に呼び出すことによって、特定のファイルに応じてできるドキュメント テンプレートのかを確認するには、この関数を使用して、であるか、またはテンプレートを返すほとんどの値に従って選択します。

lpszPathName で指定されたファイルが既に開いている場合、この関数がを返す CDocTemplate::yesAlreadyOpen とコピー rpDocMatchのオブジェクトへの CDocument のオブジェクト。

ファイルが開いていない場合は、lpszPathName の拡張子が CDocTemplate::filterExtで指定された拡張子に一致する場合、この関数がを返す CDocTemplate::yesAttemptNative は nullに rpDocMatch を設定します。CDocTemplate::filterExtの詳細については、CDocTemplate::GetDocStringを参照してください。

どちらの場合も当てはまらない場合、関数は CDocTemplate::yesAttemptForeignを返します。

既定の実装では CDocTemplate::maybeAttemptForeign か CDocTemplate::maybeAttemptNativeを返しません。Confidence の列挙体からの二つの値を使用してアプリケーションに、適切な型が一致ロジックを実行するには、この関数をオーバーライドします。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CDocTemplate クラス

階層図

CDocTemplate::GetDocString