CDocument クラス
ユーザーが定義するドキュメント クラスの基本機能が用意されています。
class CDocument : public CCmdTarget
メンバー
.gif "y59b487w.collapse_all(ja-jp,VS.110).gif")
パブリック コンストラクター
名前 |
説明 |
|---|---|
CDocument オブジェクトを構築します。 |
パブリック メソッド
名前 |
説明 |
|---|---|
ドキュメントにビューをアタッチします。 |
|
チャンク読み取りを初期化します。 |
|
高度なオーバーライド可能関数です。ドキュメントを表示しているフレーム ウィンドウが閉じられる直前に呼び出されます。 |
|
チャンク リストをクリアします。 |
|
ドキュメント オブジェクトのパスをクリアします。 |
|
ドキュメントのクリーンアップを実行します。 |
|
指定した GUID のチャンクを検索します。 |
|
ポインターを取得するには戻り値 IDocument のインターフェイスを実装します。 |
|
ドキュメントの型に対応するドキュメント テンプレートへのポインターを返します。 |
|
希望する CFile オブジェクトへのポインターを返します。 |
|
ビューのリストの最初の位置を返します。反復の始めに使います。 |
|
ドキュメントに関連付けられているビューのリストを反復処理します。 |
|
ドキュメントのデータ ファイルのパスを返します。 |
|
サムネイルを表示するためにサムネイル プロバイダーで使用されるビットマップを作成するために呼び出されます。 |
|
ドキュメントのタイトルを返します。 |
|
検索コンテンツを検索ハンドラー用に初期化するために呼び出されます。 |
|
最後に保存されてからドキュメントが変更されているかどうかを示します。 |
|
CDocument のオブジェクトのこのインスタンスが検索の&に整理するハンドラーを作成したかどうかを示します。 |
|
ストリームからドキュメント データを読み込むために呼び出されます。 |
|
リッチ プレビューのフォントを変更する前に呼び出されます。 |
|
ドキュメントのビューが追加されるか、ドキュメントからビューが削除されるときに呼び出されます。 |
|
ドキュメントを閉じるために呼び出されます。 |
|
リッチ プレビュー用のプレビュー フレームを作成する必要があるときに、フレームワークにより呼び出されます。 |
|
ドキュメント イベントに応答して、フレームワークにより呼び出されます。 |
|
サムネイルのコンテンツを描画するには、派生クラスでこのメソッドをオーバーライドします。 |
|
ストリームからドキュメント データを読み込む必要があるときに、フレームワークによって呼び出されます。 |
|
新しいドキュメントを作成するために呼び出されます。 |
|
既存のドキュメントを開くために呼び出されます。 |
|
GetFocus 関数を呼び出して取得された HWND を返すように、プレビュー ハンドラーに命令します。 |
|
プレビュー ハンドラーを実行しているプロセスのメッセージ ポンプから渡されたキーストロークを処理するように、プレビュー ハンドラーに命令します。 |
|
リッチ プレビューの背景色を変更したときに呼び出されます。 |
|
リッチ プレビューのフォントが変更されたときに呼び出されます。 |
|
リッチ プレビューのサイトが変更されたときに呼び出されます。 |
|
リッチ プレビューのテキストの色を変更したときに呼び出されます。 |
|
ドキュメントをディスクに保存するために呼び出されます。 |
|
プレビュー ハンドラーがアンロードされるときに、フレームワークにより呼び出されます。 |
|
フレーム ウィンドウが閉じられるときに呼び出されます。 |
|
次のチャンク値を読み取ります。 |
|
ほかのアプリケーションが利用できるようにファイルを解放します。 |
|
指定された GUID とチャンクを削除します。 |
|
ドキュメントからビューを切り離します。 |
|
高度なオーバーライド可能関数です。例外の発生により、オープン、または保存の操作が完了できないときに呼び出されます。 |
|
高度なオーバーライド可能関数です。ドキュメントを保存するかどうかを問い合わせるために、呼び出されます。 |
|
チャンク値を設定します。 |
|
最後に保存されてからドキュメントが変更されているかどうかを示すフラグを設定します。 |
|
ドキュメントのデータ ファイルのパスを設定します。 |
|
ドキュメントのタイトルを設定します。 |
|
ドキュメントが変更されたことをすべてのビューに通知します。 |
プロテクト メソッド
名前 |
説明 |
|---|---|
ドキュメントを添付してメール メッセージを送信します。 |
|
メールがサポートされているときに、Send Mail コマンドを有効にします。 |
パブリック データ メンバー
名前 |
説明 |
|---|---|
CDocument のオブジェクトが縮小表示の dllhost によって作成されたことを指定します。CView::OnDraw で確認する必要があります。 |
|
CDocument のオブジェクトが Rich Previewの prevhost によって作成されたことを指定します。CView::OnDraw で確認する必要があります。 |
|
CDocument のオブジェクトがインデクサーまたはそのほかの検索のアプリケーションで作成されたことを指定します。 |
|
リッチ プレビュー ウィンドウの背景色を指定します。この色はホストにより設定されます。 |
|
リッチ プレビュー ウィンドウの前景色を指定します。この色はホストにより設定されます。 |
|
リッチ プレビュー ウィンドウのテキスト フォントを指定します。このフォント情報はホストにより設定されます。 |
解説
ドキュメントは、ユーザーがファイルを開く]コマンドで一般に開き、ファイルの保存]コマンドと保存データの単位を表します。
CDocument は、ドキュメントの作成、読み込み、および保存などの標準的な操作をサポートします。フレームワークは CDocumentによって定義されるインターフェイスを使用してドキュメントを操作します。
アプリケーションでは、ドキュメントの種類をサポートできます。; たとえば、アプリケーション、およびテキスト ドキュメントの両方をサポートする場合があります。ドキュメントの種類に関連するドキュメント テンプレートは、; は、ドキュメント テンプレート リソース (たとえば、メニュー、アイコン、またはアクセラレータ テーブル) ドキュメント内のその型に使用されるかを指定します。各ドキュメントは CDocTemplate に関連付けられたオブジェクトへのポインターが格納されます。
ユーザーは関連付けられている [CW2CT] のオブジェクトを介してドキュメントと対話します。ビューは、ドキュメントのフレーム ウィンドウでイメージを表示およびドキュメントの操作として、ユーザー入力を解釈します。ドキュメントは、関連付けられた複数のビューを持つことができます。ユーザーがドキュメントのウィンドウを開くと、フレームワークはビューを作成し、ドキュメントにアタッチします。ドキュメント テンプレートによってドキュメントの種類を表示する際にどのようなビュー、およびフレーム ウィンドウを使用するかを指定します。
ドキュメントは、フレームワーク標準のコマンド ルーティングの一部であり、標準的なユーザー インターフェイスのコンポーネントからコマンドを受け取ります (ファイルの保存のメニュー項目など)。ドキュメントは、アクティブなビューによって転送されたコマンドを受け取ります。ドキュメントが特定のコマンドを処理し、それを管理するドキュメント テンプレートに送られます。
ドキュメントのデータが変更されると、ビューには、これらの変更を反映する必要があります。CDocument は、このような変更の概要を通知できるため、ビュー、必要に応じて、自身を再描画できるように UpdateAllViews のメンバー関数を提供します。フレームワークは、ユーザーが閉じる前に変更されたファイルを保存するよう要求します。
一般的なアプリケーションのドキュメントを実装するには、以下を行う必要があります:
ドキュメントの種類ごとに CDocument からクラスを派生します。
各ドキュメントにデータを格納するメンバー変数を追加します。
ドキュメントのデータを読み取って変更するためのメンバー関数を実装します。ドキュメントのビューは、これらのメンバー関数の最も重要なユーザーです。
ディスクに対してドキュメントのデータを読み書きするには、ドキュメント クラスの CObject::Serialize のメンバー関数をオーバーライドします。
CDocument がメールのサポート (MAPI) がある場合は、メールしてドキュメントの送信をサポートします。MAPIMFC の MAPI のサポートおよび" "を参照してください。
CDocumentの詳細については、[シリアル化]、ドキュメント/ビュー アーキテクチャのトピックと ドキュメント/ビューの作成を参照してください。
継承階層
CDocument
必要条件
ヘッダー: afxwin.h