CHtmlView クラス

MFC のドキュメント/ビュー アーキテクチャのコンテキストで WebBrowser コントロールの機能を提供します。

構文

class CHtmlView : public CFormView

メンバー

パブリック メソッド

名前	説明
CHtmlView::Create	WebBrowser コントロールを作成します。
CHtmlView::CreateControlSite	フォーム上のコントロールをホストするコントロール サイトのインスタンスを作成するために使用する、オーバーライド可能なメソッド。
CHtmlView::ExecFormsCommand	指定されたコマンドを IOleCommandTarget::Exec メソッドを使用して実行します。
CHtmlView::ExecWB	コマンドを実行します。
CHtmlView::GetAddressBar	Internet Explorer オブジェクトのアドレス バーが表示されるかどうかを判別します。 (WebBrowser コントロールでは無視されます。Internet Explorer の場合のみです。)
CHtmlView::GetApplication	Internet Explorer アプリケーションの現在のインスタンスを含むアプリケーションを表すアプリケーション オブジェクトを取得します。
CHtmlView::GetBusy	ダウンロードやその他のアクティビティが進行中かどうかを示す値を取得します。
CHtmlView::GetContainer	WebBrowser コントロールのコンテナーを取得します。
CHtmlView::GetFullName	Web ブラウザーに表示されるリソースのフル ネームを、パスも含めて取得します。 (WebBrowser コントロールでは無視されます。Internet Explorer の場合のみです。)
CHtmlView::GetFullScreen	WebBrowser コントロールが全画面表示モードと標準ウィンドウ モードのどちらで動作しているかを示します。
CHtmlView::GetHeight	Internet Explorer のメイン ウィンドウの高さを取得します。
CHtmlView::GetHtmlDocument	アクティブな HTML ドキュメントを取得します。
CHtmlView::GetLeft	Internet Explorer のメイン ウィンドウの左端の画面座標を取得します。
CHtmlView::GetLocationName	WebBrowser が現在表示しているリソースの名前を取得します。
CHtmlView::GetLocationURL	WebBrowser が現在表示しているリソースの URL を取得します。
CHtmlView::GetMenuBar	メニュー バーが表示されるかどうかを判別する値を取得します。
CHtmlView::GetOffline	コントロールがオフラインかどうかを判別する値を取得します。
CHtmlView::GetParentBrowser	IDispatch インターフェイスへのポインターを取得します。 詳細については、「IDispatch インターフェイスの実装を参照してください。
CHtmlView::GetProperty	指定したオブジェクトに関連付けられているプロパティの現在の値を取得します。
CHtmlView::GetReadyState	Web ブラウザーのオブジェクトの準備完了状態を取得します。
CHtmlView::GetRegisterAsBrowser	WebBrowser コントロールがターゲット名解決の最上位レベルのブラウザーとして登録されているかどうかを示します。
CHtmlView::GetRegisterAsDropTarget	WebBrowser コントロールがナビゲーションのドロップ先として登録されているかどうかを示します。
CHtmlView::GetSilent	ダイアログ ボックスを表示できるかどうかを示します。
CHtmlView::GetSource	Web ページの HTML ソース コード。
CHtmlView::GetStatusBar	Internet Explorer のステータス バーが表示されているかどうかを示します。 (WebBrowser コントロールでは無視されます。Internet Explorer の場合のみです。)
CHtmlView::GetTheaterMode	WebBrowser コントロールがシアター モードかどうかを示します。
CHtmlView::GetToolBar	ツール バーが表示されているかどうかを判別する値を取得します。
CHtmlView::GetTop	Internet Explorer のメイン ウィンドウの上端の画面座標を取得します。
CHtmlView::GetTopLevelContainer	現在のオブジェクトが WebBrowser コントロールの最上位のコンテナーかどうかを示す値を取得します。
CHtmlView::GetType	ドキュメント オブジェクトの型名を取得します。
CHtmlView::GetVisible	オブジェクトの表示または非表示を示す値を取得します。
CHtmlView::GetWidth	Internet Explorer のメイン ウィンドウの幅を取得します。
CHtmlView::GoBack	履歴の一覧の前の項目に移動します。
CHtmlView::GoForward	履歴の一覧の次の項目に移動します。
CHtmlView::GoHome	現在のホーム ページまたはスタート ページに移動します。
CHtmlView::GoSearch	現在の検索ページに移動します。
CHtmlView::LoadFromResource	WebBrowser コントロールのリソースを読み込みます。
CHtmlView::Navigate	URL で識別されるリソースに移動します。
CHtmlView::Navigate2	URL で識別されるリソースまたは完全なパスで識別されるファイルに移動します。
CHtmlView::OnBeforeNavigate2	特定の WebBrowser (ウィンドウまたはフレームセット要素) でナビゲーション操作が行われる前に呼び出されます。
CHtmlView::OnCommandStateChange	Web ブラウザー コマンドの有効な状態が変更されたことをアプリケーションに通知するために呼び出されます。
CHtmlView::OnDocumentComplete	ドキュメントが READYSTATE_COMPLETE 状態に達していることをアプリケーションに通知するために呼び出されます。
CHtmlView::OnDocWindowActivate	コンテナーのドキュメント ウィンドウがアクティブまたは非アクティブになったときにアクティブなインプレース オブジェクトに通知する、 IOleInPlaceActiveObject::OnDocWindowActivateの Internet Explorer または MSHTML 実装から呼び出されます。
CHtmlView::OnDownloadBegin	ナビゲーション操作が開始中であることをアプリケーションに通知するために呼び出されます。
CHtmlView::OnDownloadComplete	ナビゲーション操作が終了したとき、中止したとき、または失敗したときに呼び出されます。
CHtmlView::OnEnableModeless	コンテナーがモーダル ダイアログ ボックスを作成または破棄するときに、モードレス ダイアログ ボックスを有効または無効にするために呼び出されます。
CHtmlView::OnFilterDataObject	ホストが Internet Explorer または MSHTML のデータ オブジェクトを置き換えできるように Internet Explorer または MSHTML によってホスト上で呼び出されます。
CHtmlView::OnFrameWindowActivate	コンテナーの最上位フレーム ウィンドウがアクティブ化または非アクティブ化されたときにオブジェクトに通知するために、 IOleInPlaceActiveObject::OnFrameWindowActivate から呼び出されます。
CHtmlView::OnFullScreen	FullScreen プロパティが変更されたときに呼び出されます。
CHtmlView::OnGetDropTarget	Internet Explorer または MSHTML がドロップ ターゲットとして使用されている場合に呼び出され、ホストが代替 IDropTargetを提供できるようにします。
CHtmlView::OnGetExternal	ホストの IDispatch インターフェイスを取得するために Internet Explorer または MSHTML によって呼び出されます。
CHtmlView::OnGetHostInfo	Internet Explorer または MSHTML ホストの UI 機能を取得します。
CHtmlView::OnGetOptionKeyPath	Internet Explorer または MSHTML がユーザーの設定を格納しているレジストリ キーを返します。
CHtmlView::OnHideUI	Internet Explorer または MSHTML がメニューやツール バーを削除するときに呼び出されます。
CHtmlView::OnMenuBar	MenuBar プロパティが変更されたときに呼び出されます。
CHtmlView::OnNavigateComplete2	ハイパーリンクへのナビゲーションが完了した後に呼び出されます (ウィンドウ要素またはフレームセット要素上)。
CHtmlView::OnNavigateError	ハイパーリンクへの移動が失敗したときに、フレームワークによって呼び出されます。
CHtmlView::OnNewWindow2	リソースを表示する新しいウィンドウが作成されるときに呼び出されます。
CHtmlView::OnProgressChange	ダウンロード操作の進行が更新されたことをアプリケーションに通知するために呼び出されます。
CHtmlView::OnPropertyChange	PutProperty メソッドがプロパティの値を変更したことをアプリケーションに通知するために呼び出されます。
CHtmlView::OnQuit	Internet Explorer アプリケーションが終了しそうなときに、アプリケーションに通知するために呼び出されます。 (Internet Explorer のみに適用)
CHtmlView::OnResizeBorder	IOleInPlaceActiveObject::ResizeBorderの Internet Explorer または MSHTML の実装から呼び出されます。この実装は、境界線領域のサイズを変更する必要があることをオブジェクトに警告します。
CHtmlView::OnShowContextMenu	Internet Explorer または MSHTML から、コンテキスト メニューを表示しようとしているときに呼び出されます。
CHtmlView::OnShowUI	Internet Explorer または MSHTML がメニューやツール バーを表示する前に呼び出されます。
CHtmlView::OnStatusBar	StatusBar プロパティが変更されたときに呼び出されます。
CHtmlView::OnStatusTextChange	WebBrowser コントロールと関連付けられているステータス バーのテキストが変更されたことをアプリケーションに通知するために呼び出されます。
CHtmlView::OnTheaterMode	TheaterMode プロパティが変更されたときに呼び出されます。
CHtmlView::OnTitleChange	WebBrowser コントロールのドキュメントのタイトルが使用できるようになるかどうか、また変更するかどうかを、アプリケーションに通知するために呼び出されます。
CHtmlView::OnToolBar	ToolBar プロパティが変更されたときに呼び出されます。
CHtmlView::OnTranslateAccelerator	コンテナーのメッセージ キューからメニュー アクセラレータ キー メッセージを処理するために IOleInPlaceActiveObject::TranslateAccelerator または IOleControlSite::TranslateAccelerator が呼び出されたときに、Internet Explorer または MSHTML によって呼び出されます。
CHtmlView::OnTranslateUrl	読み込む URL をホストが変更できるようにするため、Internet Explorer または MSHTML によって呼び出されます。
CHtmlView::OnUpdateUI	コマンドの状態が変化したことをホストに通知します。
CHtmlView::OnVisible	WebBrowser コントロールのウィンドウが表示または隠す状態になるべきときに呼び出されます。
CHtmlView::PutProperty	指定したオブジェクトに関連付けられているプロパティの値を設定します。
CHtmlView::QueryFormsCommand	ユーザー インターフェイスのイベントによって生成された 1 つ以上のコマンドの状態を調べるためにクエリを実行します。
CHtmlView::QueryStatusWB	WebBrowser コントロールによって処理されているコマンドの状態を調べるためにクエリを実行します。
CHtmlView::Refresh	現在のファイルを再読み込みします。
CHtmlView::Refresh2	現在のファイルを再読み込みし、必要に応じて pragma:nocache ヘッダーが送信されないようにします。
CHtmlView::SetAddressBar	Internet Explorer のオブジェクトのアドレス バーを表示または非表示にします。 (WebBrowser コントロールでは無視されます。Internet Explorer の場合のみです。)
CHtmlView::SetFullScreen	コントロールが全画面表示モードと標準ウィンドウ モードのどちらで動作するかを決定する値を設定します。 (WebBrowser コントロールでは無視されます。Internet Explorer の場合のみです。)
CHtmlView::SetHeight	Internet Explorer のメイン ウィンドウの高さを設定します。
CHtmlView::SetLeft	Internet Explorer のメイン ウィンドウの水平方向の位置を設定します。
CHtmlView::SetMenuBar	コントロールのメニュー バーを表示するかどうかを決定する値を設定します。 (WebBrowser コントロールでは無視されます。Internet Explorer の場合のみです。)
CHtmlView::SetOffline	コントロールがオフラインであるかどうかを決定する値を設定します。
CHtmlView::SetRegisterAsBrowser	WebBrowser コントロールがターゲット名解決の最上位レベルのブラウザーとして登録されているかどうかを示す値を設定します。
CHtmlView::SetRegisterAsDropTarget	WebBrowser コントロールがナビゲーションのドロップ先として登録されているかどうかを示す値を設定します。
CHtmlView::SetSilent	コントロールがダイアログ ボックスを表示するかどうかを決定する値を設定します。
CHtmlView::SetStatusBar	Internet Explorer のステータス バーを表示するかどうかを決定する値を設定します。 (WebBrowser コントロールでは無視されます。Internet Explorer の場合のみです。)
CHtmlView::SetTheaterMode	WebBrowser コントロールがシアター モードかどうかを示す値を設定します。
CHtmlView::SetToolBar	コントロールのツール バーを表示するかどうかを決定する値を設定します。 (WebBrowser コントロールでは無視されます。Internet Explorer の場合のみです。)
CHtmlView::SetTop	Internet Explorer のメイン ウィンドウの水平方向の位置を設定します。
CHtmlView::SetVisible	オブジェクトの表示または非表示を示す値を設定します。
CHtmlView::SetWidth	Internet Explorer のメイン ウィンドウの幅を設定します。
CHtmlView::Stop	ファイルを開くことを中止します。

解説

WebBrowser コントロールは、ユーザーが World Wide Web 上のサイト、およびローカル ファイル システムおよびネットワーク上のフォルダーを参照できるウィンドウです。 WebBrowser コントロールは、ハイパーリンクと Uniform Resource Locator (URL) のナビゲーションをサポートし、履歴一覧を管理します。

MFC アプリケーションでの CHtmlView クラスの使用

標準の MFC フレームワーク アプリケーション (SDI または MDI ベースのいずれか) では、通常、ビュー オブジェクトは特殊化された一連のクラスから派生します。 これらのクラスはすべて CViewから派生したものであり、 CViewによって提供される範囲を超えて特殊機能を提供します。

CHtmlView 上のアプリケーションのビュー クラスに基づいて、ビューに WebBrowser コントロールを提供します。 これにより、アプリケーションを効率的に Web ブラウザーにできます。 Web ブラウザー スタイルのアプリケーションを作成する場合は、MFC アプリケーション ウィザードを使用して、 CHtmlView をビュー クラスとして指定する方法をお勧めします。 MFC アプリケーション内で WebBrowser コントロールを実装して使用する方法について詳しくは、「 Web ブラウザー スタイルのアプリケーションを作成する」をご覧ください。

Note

WebBrowser ActiveX コントロール (および CHtmlView) は、Internet Explorer 4.0 以降がインストールされている Windows NT Version 4.0 以降で実行されるプログラムでのみ使用できます。

CHtmlView は Web (および/または HTML ドキュメント) にアクセスするアプリケーション用に設計されています。 次の CHtmlView メンバー関数は、Internet Explorer のアプリケーションのみに適用されます。 これらの関数は WebBrowser コントロールで成功しますが、表示効果はありません。

• GetAddressBar
• GetFullName
• GetStatusBar
• SetAddressBar
• SetFullScreen
• SetMenuBar
• SetStatusBar
• SetToolBar

継承階層

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

要件

ヘッダー: afxhtml.h

CHtmlView::Create

Internet Explorer 実行可能ファイルの WebBrowser コントロールまたはコンテナーを作成するには、このメンバー関数を呼び出します。

virtual BOOL Create(
    LPCTSTR lpszClassName,
    LPCTSTR lpszWindowName,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID,
    CCreateContext* pContext = NULL);

パラメーター

lpszClassName
Windows クラスに名前を付ける null で終わる文字列を指します。 クラス名には、 AfxRegisterWndClass グローバル関数または RegisterClass Windows 関数に登録されている任意の名前を指定できます。 NULL場合は、定義済みの既定のCFrameWnd属性を使用します。

lpszWindowName
ウィンドウ名を表す null で終わる文字列を指します。

dwStyle
ウィンドウ スタイル属性を指定します。 既定では、 WS_VISIBLE と WS_CHILD Windows スタイルが設定されます。

rect
ウィンドウのサイズと位置を指定する RECT 構造体への参照。 rectDefault値を使用すると、Windows は新しいウィンドウのサイズと位置を指定できます。

pParentWnd
コントロールの親ウィンドウへのポインター。

nID
ビューの ID 番号。 既定では、AFX_IDW_PANE_FIRST に設定されます。

pContext
CCreateContext を指すポインター。 既定では NULL です。

CHtmlView::CreateControlSite

フォーム上のコントロールをホストするコントロール サイトのインスタンスを作成するために使用する、オーバーライド可能なメソッド。

virtual BOOL CreateControlSite(
    COleControlContainer* pContainer,
    COleControlSite** ppSite,
    UINT nID,
    REFCLSID clsid);

パラメーター

pContainer
コントロールを含む COleControlContainer オブジェクトへのポインター。

ppSite
コントロールのサイトを提供する、 COleControlSite オブジェクトへのポインターへのポインター。

nID
ホストされるコントロールの識別子。

clsid
ホストされるコントロールの CLSID

戻り値

正常に終了した場合は、TRUE を返します。それ以外の場合は、FALSE を返します。

解説

このメンバー関数をオーバーライドして、独自のコントロール サイト クラスのインスタンスを返すことができます。

CHtmlView::ExecFormsCommand

指定されたコマンドを IOleCommandTarget::Exec メソッドを使用して実行します。

HRESULT ExecFormsCommand(
    DWORD dwCommandID,
    VARIANT* pVarIn,
    VARIANT* pVarOut);

パラメーター

dwCommandID
実行するコマンド。 このコマンドは、 CMDSETID3_Forms3 グループに属している必要があります。

pVarIn
入力引数を含む VARIANT 構造体へのポインター。 NULL の可能性があります。

pVarOut
コマンド出力を受信する VARIANT 構造体へのポインター。 NULL の可能性があります。

戻り値

標準の HRESULT 値。 使用可能な値の完全な一覧については、Windows SDK の IOleCommandTarget::Exec を参照してください。

解説

ExecFormsCommand は、 IOleCommandTarget::Exec メソッドの動作を実装します。

CHtmlView::ExecWB

このメンバー関数を呼び出して、WebBrowser または Internet Explorer でコマンドを実行します。

void ExecWB(
    OLECMDID cmdID,
    OLECMDEXECOPT cmdexecopt,
    VARIANT* pvaIn,
    VARIANT* pvaOut);

パラメーター

cmdID
実行するコマンドです。

cmdexecopt
コマンドを実行するために設定されるオプション。

pvaIn
コマンド入力引数を指定するために使用されるバリアント。

pvaOut
コマンド出力引数を指定するために使用されるバリアント。

解説

Windows SDK の IWebBrowser2::ExecWB に関するページを参照してください。

CHtmlView::GetAddressBar

Internet Explorer のアドレス バーを取得するには、このメンバー関数を呼び出します。

BOOL GetAddressBar() const;

戻り値

アドレス バーが表示されている場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer に適用されます。 WebBrowser コントロールでこの呼び出しを使用すると、エラーは返されませんが、この呼び出しは無視されます。

CHtmlView::GetApplication

このメンバー関数を呼び出して、WebBrowser コントロールを含むアプリケーションでサポートされているオートメーション オブジェクトを取得します。

LPDISPATCH GetApplication() const;

戻り値

作業中のドキュメント オブジェクトの IDispatch インターフェイスへのポインター。 詳細については、「IDispatch インターフェイスの実装を参照してください。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetBusy

このメンバー関数を呼び出して、WebBrowser コントロールがナビゲーション操作またはダウンロード操作に関与しているかどうかを判断します。

BOOL GetBusy() const;

戻り値

Web ブラウザーがビジー状態の場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetContainer

このメンバー関数を呼び出して、Web ブラウザーのコンテナーに評価されるオブジェクトを取得します。

LPDISPATCH GetContainer() const;

戻り値

作業中のドキュメント オブジェクトの IDispatch インターフェイスへのポインター。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetFullName

Internet Explorer が現在表示しているファイルの完全なパスを取得するには、このメンバー関数を呼び出します。

CString GetFullName() const;

戻り値

現在表示されているファイルのパスと名前を含む CString オブジェクト。 パスとファイル名が存在しない場合、 GetFullName は空の CStringを返します。

解説

Internet Explorer に適用されます。 WebBrowser コントロールでこの呼び出しを使用すると、エラーは返されませんが、この呼び出しは無視されます。

CHtmlView::GetFullScreen

このメンバー関数を呼び出して、WebBrowser コントロールが全画面表示モードで動作しているか、通常のウィンドウ モードで動作しているかを判断します。

BOOL GetFullScreen() const;

戻り値

WebBrowser が全画面表示モードで動作している場合は 0 以外。それ以外の場合は 0。

解説

全画面表示モードでは、Internet Explorer のメイン ウィンドウが最大化され、ステータス バー、ツール バー、メニュー バー、タイトル バーが非表示になります。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetHeight

このメンバー関数を呼び出して、WebBrowser コントロールのフレーム ウィンドウの高さをピクセル単位で取得します。

long GetHeight() const;

戻り値

コントロールのフレーム ウィンドウの高さ (ピクセル単位)。

CHtmlView::GetHtmlDocument

このメンバー関数を呼び出して、作業中の文書の HTML ドキュメントを取得します。

LPDISPATCH GetHtmlDocument() const;

戻り値

作業中のドキュメント オブジェクトの IDispatch インターフェイスへのポインター。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetLeft

このメンバー関数を呼び出して、WebBrowser コントロールの内部左端とそのコンテナーの左端との間の距離を取得します。

long GetLeft() const;

戻り値

左端の距離 (ピクセル単位)。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetLocationName

このメンバー関数を呼び出して、WebBrowser に表示されているリソースの名前を取得します。

CString GetLocationName() const;

戻り値

WebBrowser に現在表示されているリソースの名前を含む CString オブジェクト。

解説

リソースが World Wide Web 上の HTML ページの場合、名前はそのページのタイトルです。 リソースがネットワークまたはローカル コンピューター上のフォルダーまたはファイルの場合、名前はフォルダーまたはファイルの UNC または完全パスです。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetLocationURL

このメンバー関数を呼び出して、WebBrowser コントロールが現在表示しているリソースの URL を取得します。

CString GetLocationURL() const;

戻り値

WebBrowser に現在表示されているリソースの URL を含む CString オブジェクト。

解説

リソースがネットワークまたはローカル コンピューター上のフォルダーまたはファイルの場合、名前はフォルダーまたはファイルの UNC または完全パスです。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetMenuBar

このメンバー関数を呼び出して、メニュー バーが表示されているかどうかを確認します。

BOOL GetMenuBar() const;

戻り値

メニュー バーが表示されている場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetOffline

このメンバー関数を呼び出して、Web ブラウザーがオフラインで動作しているかどうかを判断します。

BOOL GetOffline() const;

戻り値

Web ブラウザーが現在オフラインの場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetParentBrowser

このメンバー関数を呼び出して、WebBrowser コントロールの親オブジェクトへのポインターを取得します。

LPDISPATCH GetParentBrowser() const;

戻り値

WebBrowser コントロールの親であるオブジェクトの IDispatch インターフェイスへのポインター。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetProperty

このメンバー関数を呼び出して、コントロールに現在関連付けられているプロパティの値を取得します。

BOOL GetProperty(
    LPCTSTR lpszProperty,
    CString& strValue);

COleVariant GetProperty(LPCTSTR lpszProperty);

パラメーター

lpszProperty
取得するプロパティを含む文字列へのポインター。

strValue
プロパティの現在の値を受け取る CString オブジェクトへの参照。

戻り値

最初のバージョンでは、正常に完了した場合は 0 以外。それ以外の場合は 0。 2 番目のバージョンでは、 COleVariant オブジェクト。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetReadyState

このメンバー関数を呼び出して、WebBrowser オブジェクトの準備完了状態を取得します。

READYSTATE GetReadyState() const;

戻り値

Windows SDK で説明されている READYSTATE 値。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetRegisterAsBrowser

このメンバー関数を呼び出して、WebBrowser オブジェクトがターゲット名解決の最上位ブラウザーとして登録されているかどうかを確認します。

BOOL GetRegisterAsBrowser() const;

戻り値

ブラウザーが最上位のブラウザーとして登録されている場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetRegisterAsDropTarget

このメンバー関数を呼び出して、WebBrowser コントロールがナビゲーションのドロップ ターゲットとして登録されているかどうかを確認します。

BOOL GetRegisterAsDropTarget() const;

戻り値

ブラウザーがドロップ ターゲットとして登録されている場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetSilent

このメンバー関数を呼び出して、WebBrowser コントロールにダイアログ ボックスを表示できるかどうかを判断します。

BOOL GetSilent() const;

戻り値

WebBrowser コントロールからダイアログ ボックスを表示できない場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetSource

このメンバー関数を呼び出して、Web ページの HTML ソース コードを取得します。

BOOL GetSource(CString& strRef);

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

パラメーター

refString
ソース コードを保持する CString 。

解説

この関数は、Internet Explorer の "ソースの表示" コマンドと同じですが、ソース コードが CStringで返される点が異なります。

CHtmlView::GetStatusBar

このメンバー関数を呼び出して、WebBrowser コントロールにステータス バーが表示されるかどうかを確認します。

BOOL GetStatusBar() const;

戻り値

ステータス バーを表示できる場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer に適用されます。 WebBrowser コントロールでこの呼び出しを使用すると、エラーは返されませんが、この呼び出しは無視されます。

CHtmlView::GetTheaterMode

このメンバー関数を呼び出して、Web ブラウザーがシアター モードかどうかを判断します。

BOOL GetTheaterMode() const;

戻り値

Web ブラウザーがシアター モードの場合は 0 以外。それ以外の場合は 0。

解説

Web ブラウザーがシアター モードの場合、ブラウザーのメイン ウィンドウが画面全体に表示され、ツールバーに最小限のナビゲーション ツール セットが表示され、ステータス バーが画面の右上隅に表示されます。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetToolBar

このメンバー関数を呼び出して、ツール バーが表示されているかどうかを確認します。

int GetToolBar() const;

戻り値

ツール バーが表示されるかどうかを示す値。 ツールバーが表示されている場合は 0 以外。それ以外の場合は 0。

CHtmlView::GetTop

このメンバー関数を呼び出して、WebBrowser コントロールのメイン ウィンドウの上端の画面座標を取得します。

long GetTop() const;

戻り値

メイン ウィンドウの上端の画面座標を受け取る変数のアドレス。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetTopLevelContainer

Internet Explorer が WebBrowser コントロールの最上位コンテナーであるかどうかを判断するには、このメンバー関数を呼び出します。

BOOL GetTopLevelContainer() const;

戻り値

0 以外の場合、コンテナーは最上位レベルのコンテナーです。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetType

このメンバー関数を呼び出して、含まれている作業中の文書の型名を取得します。

CString GetType() const;

戻り値

含まれている作業中の文書の型名を含む CString オブジェクト。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetVisible

このメンバー関数を呼び出して、包含オブジェクトが表示されているかどうかを確認します。

BOOL GetVisible() const;

戻り値

オブジェクトが表示されている場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GetWidth

Internet Explorer のメイン ウィンドウの幅を取得します。

long GetWidth() const;

戻り値

ウィンドウの現在の幅 (ピクセル単位)。

CHtmlView::GoBack

履歴リスト内の 1 つの項目を後方に移動します。

void GoBack();

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GoForward

履歴リスト内の 1 つの項目を前方に移動します。

void GoForward();

CHtmlView::GoHome

Internet Explorer の [インターネット オプション] ダイアログ ボックス、またはコントロール パネルからアクセスする [インターネットのプロパティ] ダイアログ ボックスで指定した、現在のホーム ページまたはスタート ページに移動します。

void GoHome();

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::GoSearch

[Internet Explorer のインターネット オプション] ダイアログ ボックスまたは [インターネットのプロパティ] ダイアログ ボックスで指定した現在の検索ページに移動し、コントロール パネルからアクセスします。

void GoSearch();

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::LoadFromResource

このメンバー関数を呼び出して、指定したリソースを WebBrowser コントロールに読み込みます。

BOOL LoadFromResource(LPCTSTR lpszResource);
BOOL LoadFromResource(UINT nRes);

パラメーター

lpszResource
読み込むリソースの名前を含む文字列へのポインター。

nRes
読み込むリソースの名前を含むバッファーの ID。

戻り値

成功した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::Navigate

このメンバー関数を呼び出して、URL によって識別されるリソースに移動します。

void Navigate(
    LPCTSTR URL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeaders = NULL,
    LPVOID lpvPostData = NULL,
    DWORD dwPostDataLen = 0);

パラメーター

URL
移動する URL、または表示するファイルの完全なパスを含む呼び出し元によって割り当てられた文字列。

dwFlags
リソースを履歴リストに追加するかどうか、キャッシュとの間で読み取りまたは書き込みを行うかどうか、およびリソースを新しいウィンドウに表示するかどうかを指定する変数のフラグ。 変数には、 BrowserNavConstants 列挙体で定義された値の組み合わせを指定できます。

lpszTargetFrameName
リソースを表示するフレームの名前を含む文字列へのポインター。

lpszHeaders
サーバーに送信する HTTP ヘッダーを指定する値へのポインター。 これらのヘッダーは、既定の Internet Explorer ヘッダーに追加されます。 ヘッダーでは、サーバーに必要なアクション、サーバーに渡されるデータの種類、状態コードなどを指定できます。 URLが HTTP URL でない場合、このパラメーターは無視されます。

lpvPostData
HTTP POST トランザクションで送信するデータへのポインター。 たとえば、POST トランザクションは、HTML フォームによって収集されたデータを送信するために使用されます。 このパラメーターでポスト データが指定されていない場合、 Navigate は HTTP GET トランザクションを発行します。 URLが HTTP URL でない場合、このパラメーターは無視されます。

dwPostDataLen
HTTP POST トランザクションで送信するデータ。 たとえば、POST トランザクションは、HTML フォームによって収集されたデータを送信するために使用されます。 このパラメーターでポスト データが指定されていない場合、 Navigate は HTTP GET トランザクションを発行します。 URLが HTTP URL でない場合、このパラメーターは無視されます。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::Navigate2

このメンバー関数を呼び出して、URL で識別されるリソース、または完全なパスで識別されるファイルに移動します。

void Navigate2(
    LPITEMIDLIST pIDL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL);

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags = 0,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeaders = NULL,
    LPVOID lpvPostData = NULL,
    DWORD dwPostDataLen = 0);

void Navigate2(
    LPCTSTR lpszURL,
    DWORD dwFlags,
    CByteArray& baPostedData,
    LPCTSTR lpszTargetFrameName = NULL,
    LPCTSTR lpszHeader = NULL);

パラメーター

pIDL
ITEMIDLIST構造体へのポインター。

dwFlags
リソースを履歴リストに追加するかどうか、キャッシュとの間で読み取りまたは書き込みを行うかどうか、およびリソースを新しいウィンドウに表示するかどうかを指定する変数のフラグ。 変数には、 BrowserNavConstants 列挙体で定義された値の組み合わせを指定できます。

lpszTargetFrameName
リソースを表示するフレームの名前を含む文字列へのポインター。

lpszURL
URL を含む文字列へのポインター。

lpvPostData
HTTP POST トランザクションで送信するデータ。 たとえば、POST トランザクションは、HTML フォームによって収集されたデータを送信するために使用されます。 このパラメーターでポスト データが指定されていない場合、 Navigate2 は HTTP GET トランザクションを発行します。 URLが HTTP または HTTPS URL でない場合、このパラメーターは無視されます。

dwPostDataLen
lpvPostData パラメーターが指すデータの長さ (バイト単位)。

lpszHeaders
サーバーに送信する HTTP ヘッダーまたは HTTPS ヘッダーを指定する値へのポインター。 これらのヘッダーは、既定の Internet Explorer ヘッダーに追加されます。 ヘッダーでは、サーバーに必要なアクション、サーバーに渡されるデータの種類、状態コードなどを指定できます。 URLが HTTP または HTTPS URL でない場合、このパラメーターは無視されます。

baPostedData
CByteArray オブジェクトへの参照です。

解説

このメンバー関数は、パラメーター pIDLで表されるデスクトップやマイ コンピューターなどの特殊なフォルダーの参照をサポートすることで、Navigateメンバー関数を拡張します。

Internet Explorer と WebBrowser に適用されます。

例

void CMyHtmlView::OnGoToMicrosoft()
{
   Navigate2(_T("http://home.microsoft.com"));
}

CHtmlView::OnBeforeNavigate2

このメンバー関数は、Web ブラウザーでナビゲーション操作が発生する前にイベントを発生させるためにフレームワークによって呼び出されます。

virtual void OnBeforeNavigate2(
    LPCTSTR lpszURL,
    DWORD nFlags,
    LPCTSTR lpszTargetFrameName,
    CByteArray& baPostedData,
    LPCTSTR lpszHeaders,
    BOOL* pbCancel);

パラメーター

lpszURL
移動する URL を含む文字列へのポインター。

nFlags
将来の使用のために予約済み。

lpszTargetFrameName
リソースを表示するフレームの名前を含む文字列。リソースを対象とする名前付きフレームがない場合は NULL 。

baPostedData
HTTP POST トランザクションが使用されている場合にサーバーに送信するデータを含む CByteArray オブジェクトへの参照。

lpszHeaders
サーバーに送信する他の HTTP ヘッダーを含む文字列へのポインター (HTTP URL のみ)。 ヘッダーでは、サーバーに必要なアクション、サーバーに渡されるデータの種類、状態コードなどを指定できます。

pbCancel
キャンセル フラグへのポインター。 アプリケーションでは、このパラメーターを 0 以外に設定してナビゲーション操作を取り消すか、0 に設定して続行することができます。

CHtmlView::OnCommandStateChange

このメンバー関数は、Web ブラウザー コマンドの有効な状態が変更されたことをアプリケーションに通知するためにフレームワークによって呼び出されます。

virtual void OnCommandStateChange(
    long nCommand,
    BOOL bEnable);

パラメーター

nCommand
有効な状態が変更されたコマンドの識別子。

bEnable
有効な状態。 このパラメーターは、コマンドが有効な場合は 0 以外、無効の場合は 0 です。

CHtmlView::OnDocumentComplete

このメンバー関数は、ドキュメントが READYSTATE_COMPLETE 状態に達したことをアプリケーションに通知するためにフレームワークによって呼び出されます。

virtual void OnDocumentComplete(LPCTSTR lpszURL);

パラメーター

lpszURL
URL、UNC ファイル名、または移動先の PIDL (項目識別子リストへのポインター) に評価される文字列へのポインター。

解説

すべてのフレームがこのイベントを発生するわけではありませんが、 OnDownloadBegin イベントを発生する各フレームは、対応する OnDocumentComplete イベントを発生させます。

lpszURLによって示される URL は、ブラウザーに移動するように指示された URL とは異なる場合があります。これは、この URL が正規化および修飾された URL であるためです。 たとえば、アプリケーションがNavigateまたはNavigate2の呼び出しで"www.microsoft.com"の URL を指定した場合、OnNavigateComplete2渡された URL は"<https://www.microsoft.com/>"されます。 また、サーバーがブラウザーを別の URL にリダイレクトした場合は、リダイレクトされた URL がここに反映されます。

CHtmlView::OnDocWindowActivate

コンテナーのドキュメント ウィンドウがアクティブまたは非アクティブになったときにアクティブなインプレース オブジェクトに通知する、 IOleInPlaceActiveObject::OnDocWindowActivateの Internet Explorer または MSHTML 実装から呼び出されます。

virtual HRESULT OnDocWindowActivate(BOOL fActivate);

パラメーター

fActivate
ドキュメント ウィンドウの状態を示します。 この値が 0 以外の場合、ウィンドウがアクティブ化されます。 この値が 0 の場合、ウィンドウは非アクティブ化されています。

戻り値

S_OK 成功した場合は 〗、それ以外の場合は OLE 定義エラー コード。

解説

OnDocWindowActivateをオーバーライドして、Microsoft Web Browser コントロールからのOnDocWindowActivate通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::OnDocWindowActivate に関する記事を参照してください。

CHtmlView::OnDownloadBegin

このメンバー関数は、ドキュメントのダウンロードを開始するためにフレームワークによって呼び出されます。

virtual void OnDownloadBegin();

解説

このイベントは、ナビゲーションが取り消されない限り、 OnBeforeNavigate2 イベントの直後に発生します。 コンテナーが表示する必要があることを示すアニメーションまたは "ビジー" 表示は、このイベントに接続する必要があります。

CHtmlView::OnDownloadComplete

このメンバー関数は、ナビゲーション操作が完了、停止、または失敗したことを示すためにフレームワークによって呼び出されます。

virtual void OnDownloadComplete();

CHtmlView::OnEnableModeless

Internet Explorer または MSHTML がモーダル UI を表示するときに呼び出されます。

virtual HRESULT OnEnableModeless(BOOL fEnable);

パラメーター

fEnable
ホストのモードレス ダイアログ ボックスが有効または無効になっているかどうかを示します。 この値が 0 以外の場合、モードレス ダイアログ ボックスが有効になります。 この値が 0 の場合、モードレス ダイアログ ボックスは無効になります。

戻り値

S_OK 成功した場合は 〗、それ以外の場合は OLE 定義エラー コード。

解説

コンテナーがモーダル ダイアログ ボックスを作成または破棄するときに、モードレス ダイアログ ボックスを有効または無効にします。 OnEnableModelessをオーバーライドして、Microsoft Web Browser コントロールからのEnableModeless通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::EnableModeless に関する記事を参照してください。

CHtmlView::OnFilterDataObject

ホストが Internet Explorer または MSHTML のデータ オブジェクトを置き換えできるように Internet Explorer または MSHTML によってホスト上で呼び出されます。

virtual HRESULT OnFilterDataObject(
    LPDATAOBJECT pDataObject,
    LPDATAOBJECT* ppDataObject);

パラメーター

pDataObject
Internet Explorer または MSHTML によって提供される IDataObject インターフェイスのアドレス。

ppDataObject
ホストによって提供される IDataObject インターフェイス ポインターを受け取るアドレス。 メソッドが失敗した場合でも、このパラメーターの内容は常に NULLするように初期化する必要があります。

戻り値

S_OK データ オブジェクトが置き換えられる場合は S_FALSE 、データ オブジェクトが置き換えられていない場合は。エラーが発生した場合は OLE 定義のエラー コードです。

解説

OnFilterDataObjectをオーバーライドして、Microsoft Web Browser コントロールからのFilterDataObject通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::FilterDataObject に関する記事を参照してください。

CHtmlView::OnFrameWindowActivate

コンテナーの最上位フレーム ウィンドウがアクティブ化または非アクティブ化されたときにオブジェクトに通知するために、 IOleInPlaceActiveObject::OnFrameWindowActivate から呼び出されます。

virtual HRESULT OnFrameWindowActivate(BOOL fActivate);

パラメーター

fActivate
コンテナーの最上位フレーム ウィンドウの状態を示します。 この値が 0 以外の場合、ウィンドウがアクティブ化されます。 この値が 0 の場合、ウィンドウは非アクティブ化されています。

戻り値

S_OK 成功した場合は 〗、それ以外の場合は OLE 定義エラー コード。

解説

OnFrameWindowActivateをオーバーライドして、Microsoft Web Browser コントロールからのOnFrameWindowActivate通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::OnFrameWindowActivate に関する記事を参照してください。

CHtmlView::OnFullScreen

このメンバー関数は、 FullScreen プロパティが変更されたときにフレームワークによって呼び出されます。

virtual void OnFullScreen(BOOL bFullScreen);

パラメーター

bFullScreen
Internet Explorer が全画面表示モードの場合は 0 以外。それ以外の場合は 0。

CHtmlView::OnGetDropTarget

Internet Explorer または MSHTML がドロップ ターゲットとして使用されている場合に呼び出され、ホストが代替 IDropTargetを提供できるようにします。

virtual HRESULT OnGetDropTarget(
    LPDROPTARGET pDropTarget,
    LPDROPTARGET* ppDropTarget);

パラメーター

pDropTarget
IDropTarget Internet Explorer または MSHTML が使用することを提案します。

ppDropTarget
ホストが提供するIDropTarget インターフェイス ポインターを受け取るIDropTargetのアドレス。

戻り値

リターン コードの一覧については、Windows SDK の IDocHostUIHandler::GetDropTarget を参照してください。

解説

OnGetDropTargetをオーバーライドして、Microsoft Web Browser コントロールからのGetDropTarget通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::GetDropTarget に関する記事を参照してください。

CHtmlView::OnGetExternal

ホストの IDispatch インターフェイスを取得するために Internet Explorer または MSHTML によって呼び出されます。

virtual HRESULT OnGetExternal(LPDISPATCH* lppDispatch);

パラメーター

lppDispatch
ホスト アプリケーションの IDispatch インターフェイス ポインターを受け取るアドレスへのポインター。 ホストが Automation インターフェイスを公開している場合は、このパラメーターを使用して Internet Explorer または MSHTML への参照を提供できます。 メソッドが失敗した場合でも、このパラメーターの内容は常に NULLするように初期化する必要があります。

戻り値

S_OK 成功した場合は 〗、それ以外の場合は OLE 定義エラー コード。

解説

OnGetExternalをオーバーライドして、Microsoft Web Browser コントロールからのGetExternal通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::GetExternal に関する記事を参照してください。

CHtmlView::OnGetHostInfo

Internet Explorer または MSHTML ホストの UI 機能を取得します。

virtual HRESULT OnGetHostInfo(DOCHOSTUIINFO* pInfo);

パラメーター

pInfo
ホストの UI 機能を受け取る DOCHOSTUIINFO 構造体のアドレス。

戻り値

S_OK 成功した場合は 〗、それ以外の場合は OLE 定義エラー コード。

解説

OnGetHostInfoをオーバーライドして、Microsoft Web Browser コントロールからのGetHostInfo通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::GetHostInfo に関する記事を参照してください。

CHtmlView::OnGetOptionKeyPath

このメンバー関数を呼び出して、Internet Explorer または MSHTML がユーザー設定を格納するレジストリ キーを取得します。

virtual HRESULT OnGetOptionKeyPath(
    LPOLESTR* pchKey,
    DWORD dwReserved);

パラメーター

pchKey
ホストが既定のオプションを格納するレジストリ サブキー文字列を受け取る LPOLESTR のアドレス。 このサブキーは、 HKEY_CURRENT_USER キーの下にあります。 CoTaskMemAllocを使用してこのメモリを割り当てます。 呼び出し元のアプリケーションは、 CoTaskMemFreeを使用してこのメモリを解放します。 メソッドが失敗した場合でも、このパラメーターは常に NULLに初期化する必要があります。

dwReserved
将来の使用のために予約済み。 現在は使用しません。

戻り値

S_OK 成功した場合は。それ以外の場合 S_FALSE 。 S_FALSE場合、Internet Explorer または MSHTML は既定で独自のユーザー オプションになります。

解説

OnGetOptionKeyPathをオーバーライドして、Microsoft Web Browser コントロールからのGetOptionKeyPath通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::GetOptionKeyPath に関する記事を参照してください。

CHtmlView::OnHideUI

このメンバー関数は、Internet Explorer または MSHTML がメニューとツール バーを削除すると、フレームワークによって呼び出されます。

virtual HRESULT OnHideUI();

戻り値

S_OK 成功した場合は 〗、それ以外の場合は OLE 定義エラー コード。

解説

OnHideUIをオーバーライドして、Microsoft Web Browser コントロールからのHideUI通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::HideUI に関する記事を参照してください。

CHtmlView::OnMenuBar

このメンバー関数は、 MenuBar プロパティが変更されたときにフレームワークによって呼び出されます。

virtual void OnMenuBar(BOOL bMenuBar);

パラメーター

bMenuBar
Internet Explorer のメニュー バーが表示されている場合は 0 以外。それ以外の場合は 0。

CHtmlView::OnNavigateComplete2

このメンバー関数は、ハイパーリンクへのナビゲーションが完了した後にフレームワークによって呼び出されます (ウィンドウ要素またはフレームセット要素上)。

virtual void OnNavigateComplete2(LPCTSTR strURL);

パラメーター

strURL
移動先の URL、UNC ファイル名、または PIDL (項目識別子リストへのポインター) に評価される文字列式。

解説

URL 表現がないシェル名前空間エンティティがある場合は、URL パラメーターに PIDL を指定できます。

strURLに含まれる URL は、ブラウザーが移動するように指定された URL とは異なる場合があります。これは、この URL が正規化および修飾された URL であるためです。 たとえば、アプリケーションがNavigateまたはNavigate2の呼び出しで"www.microsoft.com"の URL を指定した場合、OnNavigateComplete2渡された URL は"<https://www.microsoft.com/>"されます。 また、サーバーがブラウザーを別の URL にリダイレクトした場合は、リダイレクトされた URL がここに反映されます。

CHtmlView::OnNavigateError

ハイパーリンクへの移動が失敗したときに、フレームワークによって呼び出されます。

virtual void OnNavigateError(
    LPCTSTR lpszURL,
    LPCTSTR lpszFrame,
    DWORD dwError,
    BOOL* pbCancel);

パラメーター

lpszURL
ナビゲーションに失敗した URL。

lpszFrame
リソースが表示されるフレームの名前。名前付きフレームがリソースを対象としていない場合は NULL 。

dwError
エラー状態コード (使用可能な場合)。 使用可能な HRESULT と HTTP 状態コードの一覧については、「 NavigateError イベント状態コード.」を参照してください。

pbCancel
エラー ページへのナビゲーションを取り消すか、それ以降の自動検索を取り消すかを指定します。 TRUE (既定値) の場合は、エラー ページまたは自動検索へのナビゲーションを続行します。FALSE場合は、エラー ページまたは自動検索へのナビゲーションを取り消します。

解説

カスタム ナビゲーション エラー処理を提供するには、このメソッドをオーバーライドします。

詳細については、DWebBrowserEvents2::NavigateError を参照してください

CHtmlView::OnNewWindow2

このメンバー関数は、リソースを表示するために新しいウィンドウを作成するときにフレームワークによって呼び出されます。

virtual void OnNewWindow2(
    LPDISPATCH* ppDisp,
    BOOL* Cancel);

パラメーター

ppDisp
必要に応じて、新しい WebBrowser または Internet Explorer オブジェクトの IDispatch インターフェイス ポインターを受け取るインターフェイス ポインターへのポインター。

Cancel
キャンセル フラグへのポインター。 アプリケーションでは、このパラメーターを 0 以外に設定してナビゲーション操作を取り消すか、0 に設定して続行することができます。

解説

このイベントは、WebBrowser 内から新しいウィンドウを作成する前に発生します。

CHtmlView::OnProgressChange

このメンバー関数は、ダウンロード操作の進行状況が更新されたことをアプリケーションに通知するためにフレームワークによって呼び出されます。

virtual void OnProgressChange(
    long nProgress,
    long nProgressMax);

パラメーター

nProgress
表示する進行状況の合計量。進行状況が完了した場合は -1。

nProgressMax
進行状況の最大値。

解説

コンテナーは、このイベントによって提供された情報を使用して、これまでにダウンロードしたバイト数を表示したり、進行状況インジケーターを更新したりできます。

CHtmlView::OnPropertyChange

このメンバー関数は、 PutProperty がプロパティの値を変更したことをアプリケーションに通知するためにフレームワークによって呼び出されます。

virtual void OnPropertyChange(LPCTSTR lpszProperty);

パラメーター

lpszProperty
プロパティの名前を含む文字列へのポインター。

CHtmlView::OnQuit

このメンバー関数は、Internet Explorer アプリケーションを終了する準備ができていることをアプリケーションに通知するために、フレームワークによって呼び出されます。

virtual void OnQuit();

CHtmlView::OnResizeBorder

IOleInPlaceActiveObject::ResizeBorderの Internet Explorer または MSHTML の実装から呼び出されます。この実装は、境界線領域のサイズを変更する必要があることをオブジェクトに警告します。

virtual HRESULT OnResizeBorder(
    LPCRECT prcBorder,
    LPOLEINPLACEUIWINDOW pUIWindow,
    BOOL fFrameWindow);

パラメーター

prcBorder
罫線スペース用の新しい外側の四角形。

pUIWindow
罫線が変更されたフレームまたはドキュメント ウィンドウ オブジェクトのインターフェイスへのポインター。

fFrameWindow
TRUE フレーム ウィンドウが IOleInPlaceActiveObject::ResizeBorderを呼び出している場合は、それ以外の場合は FALSE。

戻り値

S_OK 成功した場合は 〗、それ以外の場合は OLE 定義エラー コード。

解説

OnResizeBorderをオーバーライドして、Microsoft Web Browser コントロールからのResizeBorder通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::ResizeBorder に関する記事を参照してください。

CHtmlView::OnShowContextMenu

Internet Explorer または MSHTML から、コンテキスト メニューを表示しようとしているときに呼び出されます。

virtual HRESULT OnShowContextMenu(
    DWORD dwID,
    LPPOINT ppt,
    LPUNKNOWN pcmdtReserved,
    LPDISPATCH pdispReserved);

パラメーター

dwID
表示するコンテキスト メニューの識別子。 値の一覧については、Windows SDK の IDocHostUIHandler::ShowContextMenu を参照してください。

ppt
メニューの画面座標。

pcmdtReserved
IOleCommandTarget インターフェイスを使用して、コマンドの状態を照会し、このオブジェクトに対してコマンドを実行します。

pdispReserved
IDispatch 画面座標のオブジェクトのインターフェイス。 これにより、ホストは特定のオブジェクトを区別して、より具体的なコンテキストを提供できます。

戻り値

値の一覧については、Windows SDK の IDocHostUIHandler::ShowContextMenu を参照してください。

解説

OnShowContextMenuをオーバーライドして、Microsoft Web Browser コントロールからのShowContextMenu通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::ShowContextMenu に関する記事を参照してください。

CHtmlView::OnShowUI

Internet Explorer または MSHTML がメニューやツール バーを表示する前に呼び出されます。

virtual HRESULT OnShowUI(
    DWORD dwID,
    LPOLEINPLACEACTIVEOBJECT pActiveObject,
    LPOLECOMMANDTARGET pCommandTarget,
    LPOLEINPLACEFRAME pFrame,
    LPOLEINPLACEUIWINDOW pDoc);

パラメーター

dwID
将来の使用のために予約済み。

pActiveObject
IOleInPlaceActiveObject 現在アクティブなオブジェクトのインターフェイス。

pCommandTarget
IOleCommandTarget オブジェクトのインターフェイス。

pFrame
IOleInPlaceFrame オブジェクトのインターフェイス。 これは、メニューとツール バーに必要です。

pDoc
IOleInPlaceUIWindow オブジェクトのインターフェイス。 これは、ツール バーに必要です。

戻り値

値の一覧については、Windows SDK の IDocHostUIHandler::ShowUI を参照してください。

解説

OnShowUIをオーバーライドして、Microsoft Web Browser コントロールからのShowUI通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::ShowUI に関する記事を参照してください。

CHtmlView::OnStatusBar

このメンバー関数は、 StatusBar プロパティが変更されたときにフレームワークによって呼び出されます。

virtual void OnStatusBar(BOOL bStatusBar);

パラメーター

bStatusBar
Internet Explorer のステータス バーが表示されている場合は 0 以外、それ以外の場合は 0。

CHtmlView::OnStatusTextChange

このメンバー関数は、WebBrowser コントロールに関連付けられているステータス バーのテキストが変更されたことをアプリケーションに通知するために、フレームワークによって呼び出されます。

virtual void OnStatusTextChange(LPCTSTR lpszText);

パラメーター

lpszText
新しいステータス バーのテキストを含む文字列。

CHtmlView::OnTheaterMode

このメンバー関数は、 TheaterMode プロパティが変更されたときにフレームワークによって呼び出されます。

virtual void OnTheaterMode(BOOL bTheaterMode);

パラメーター

bTheaterMode
Internet Explorer がシアター モードの場合は 0 以外。それ以外の場合は 0。

CHtmlView::OnTitleChange

このメンバー関数は、WebBrowser コントロール内のドキュメントのタイトルが使用可能になった場合や変更された場合にアプリケーションに通知するために、フレームワークによって呼び出されます。

virtual void OnTitleChange(LPCTSTR lpszText);

パラメーター

lpszText
新しいドキュメントのタイトル。

解説

HTML の場合、タイトルが変更される可能性があります。HTML のダウンロード中は、ドキュメントの URL がタイトルとして設定されます。 実際のタイトル (ある場合) が HTML から解析された後、タイトルは実際のタイトルを反映するように変更されます。

CHtmlView::OnToolBar

このメンバー関数は、 ToolBar プロパティが変更されたときにフレームワークによって呼び出されます。

virtual void OnToolBar(BOOL bToolBar);

パラメーター

bToolBar
Internet Explorer のツール バーが表示されている場合は 0 以外、それ以外の場合は 0。

CHtmlView::OnTranslateAccelerator

コンテナーのメッセージ キューからメニュー アクセラレータ キー メッセージを処理するために IOleInPlaceActiveObject::TranslateAccelerator または IOleControlSite::TranslateAccelerator が呼び出されたときに、Internet Explorer または MSHTML によって呼び出されます。

virtual HRESULT OnTranslateAccelerator(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

パラメーター

lpMsg
翻訳が必要になる可能性があるメッセージを指します。

pguidCmdGroup
コマンド グループ識別子。

nCmdID
コマンド識別子。

戻り値

S_OK 成功した場合は。それ以外の場合 S_FALSE 。

解説

OnTranslateAcceleratorをオーバーライドして、Microsoft Web Browser コントロールからのTranslateAccelerator通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::TranslateAccelerator に関する記事を参照してください。

CHtmlView::OnTranslateUrl

読み込む URL をホストが変更できるようにするため、Internet Explorer または MSHTML によって呼び出されます。

virtual HRESULT OnTranslateUrl(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

パラメーター

dwTranslate
将来の使用のために予約済み。

pchURLIn
変換する URL を表す Internet Explorer または MSHTML によって提供される文字列のアドレス。

ppchURLOut
変換された URL のアドレスを受け取る文字列ポインターのアドレス。 ホストは、タスク メモリ アロケーターを使用してバッファーを割り当てます。 URL が変換されていない場合やメソッドが失敗した場合でも、このパラメーターの内容は常に NULLに初期化する必要があります。

戻り値

S_OK URL が翻訳された場合は S_FALSE 、URL が翻訳されていない場合は。エラーが発生した場合は OLE 定義のエラー コード。

解説

OnTranslateUrlをオーバーライドして、Microsoft Web Browser コントロールからのTranslateUrl通知に対応します。 詳細については、Windows SDK の IDocHostUIHandler::TranslateUrl に関する記事を参照してください。

CHtmlView::OnUpdateUI

コマンドの状態が変化したことをホストに通知します。

virtual HRESULT OnUpdateUI();

戻り値

S_OK 成功した場合は 〗、それ以外の場合は OLE 定義エラー コード。

解説

ホストはツール バー ボタンの状態を更新する必要があります。 このメソッドは、 ShowUIからの戻り値に関係なく呼び出されます。 OnUpdateUIをオーバーライドして、Microsoft Web Browser コントロールからのUpdateUI通知に対応します。

CHtmlView::OnVisible

このメンバー関数は、WebBrowser のウィンドウを表示または非表示にする必要がある場合に、フレームワークによって呼び出されます。

virtual void OnVisible(BOOL bVisible);

パラメーター

bVisible
オブジェクトが表示されている場合は 0 以外、それ以外の場合は 0。

解説

これにより、オブジェクト コントロールのホスト ウィンドウは、Internet Explorer ウィンドウの動作と同じように動作します。

CHtmlView::PutProperty

このメンバー関数を呼び出して、特定のオブジェクトに関連付けられているプロパティを設定します。

void PutProperty(
    LPCTSTR lpszProperty,
    const VARIANT& vtValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    double dValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    long lValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    LPCTSTR lpszValue);

void PutProperty(
    LPCTSTR lpszPropertyName,
    short nValue);

パラメーター

lpszProperty
設定するプロパティを含む文字列。

vtValue
lpszPropertyによって示されるプロパティの新しい値。

lpszPropertyName
設定するプロパティの名前を含む文字列へのポインター。

dValue
プロパティの新しい値です。

lValue
プロパティの新しい値です。

lpszValue
プロパティの新しい値を含む文字列へのポインター。

nValue
プロパティの新しい値です。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::QueryFormsCommand

ユーザー インターフェイスのイベントによって生成された 1 つ以上のコマンドの状態を調べるためにクエリを実行します。

HRESULT QueryFormsCommand(
    DWORD dwCommandID,
    BOOL* pbSupported,
    BOOL* pbEnabled,
    BOOL* pbChecked);

パラメーター

dwCommandID
クエリ対象のコマンドの識別子。

pbSupported
(dwCommandID で識別される) コマンドがサポートされているかどうかを指定するBOOLへのポインター。 TRUE場合は、コマンドがサポートされます。それ以外の場合はFALSE。

pbEnabled
(dwCommandID で識別される) コマンドが有効かどうかを指定するBOOLへのポインター。 TRUE場合は、コマンドがサポートされます。それ以外の場合はFALSE。

pbChecked
(dwCommandIDで識別される) コマンドがチェックされるかどうかを指定するBOOLへのポインター。 TRUE場合は、コマンドがサポートされます。それ以外の場合はFALSE。

戻り値

標準の HRESULT 値。 使用可能な値の完全な一覧については、Windows SDK の IOleCommandTarget::QueryStatus を参照してください。

解説

QueryFormsCommand は、 IOleCommandTarget::QueryStatus メソッドの動作を実装します。

CHtmlView::QueryStatusWB

コマンドの状態を照会するには、このメンバー関数を呼び出します。

OLECMDF QueryStatusWB(OLECMDID cmdID) const;

パラメーター

cmdID
呼び出し元に状態情報が必要なコマンドの OLECMDID 値。

戻り値

コマンドの状態を受け取る OLECMDF 値のアドレス。

解説

QueryStatusWB は、 IOleCommandTarget::QueryStatus メソッドの動作を実装します。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::Refresh

Web ブラウザーが現在表示している URL またはファイルを再読み込みします。

void Refresh();

解説

Refresh には、更新レベルを設定するためのパラメーターが含まれています。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::Refresh2

Internet Explorer で現在表示されているファイルを再読み込みします。

void Refresh2(int nLevel);

パラメーター

nLevel
更新レベルを指定する変数のアドレス。 使用可能な変数は、windows SDK の RefreshConstantsで定義されます。

解説

Refreshとは異なり、Refresh2には更新レベルを指定するパラメーターが含まれています。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetAddressBar

Internet Explorer オブジェクトのアドレス バーを表示または非表示にするには、このメンバー関数を呼び出します。

void SetAddressBar(BOOL bNewValue);

パラメーター

bNewValue
アドレス バーを表示する場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer に適用されます。 WebBrowser コントロールでこの呼び出しを使用すると、エラーは返されませんが、この呼び出しは無視されます。

CHtmlView::SetFullScreen

Internet Explorer を全画面表示または通常のウィンドウ モードに設定するには、このメンバー関数を呼び出します。

void SetFullScreen(BOOL bNewValue);

パラメーター

bNewValue
全画面表示モードの場合は 0 以外。それ以外の場合は 0。

解説

全画面表示モードでは、Internet Explorer のメイン ウィンドウが最大化され、ステータス バー、ツール バー、メニュー バー、タイトル バーが非表示になります。

Internet Explorer に適用されます。 WebBrowser コントロールでこの呼び出しを使用すると、エラーは返されませんが、この呼び出しは無視されます。

CHtmlView::SetHeight

Internet Explorer のメイン ウィンドウの高さを設定するには、このメンバー関数を呼び出します。

void SetHeight(long nNewValue);

パラメーター

nNewValue
メイン ウィンドウの高さ (ピクセル単位)。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetLeft

Internet Explorer のメイン ウィンドウの水平方向の位置を設定します。

void SetLeft(long nNewValue);

パラメーター

nNewValue
メイン ウィンドウの左端の画面座標。

CHtmlView::SetMenuBar

Internet Explorer メニュー バーを表示または非表示にするには、このメンバー関数を呼び出します。

void SetMenuBar(BOOL bNewValue);

パラメーター

bNewValue
メニュー バーを表示する場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer に適用されます。 WebBrowser コントロールでこの呼び出しを使用すると、エラーは返されませんが、この呼び出しは無視されます。

CHtmlView::SetOffline

このメンバー関数を呼び出して、WebBrowser コントロールが現在オフライン モードで動作しているかどうかを示す値を設定します。

void SetOffline(BOOL bNewValue);

パラメーター

bNewValue
ローカル キャッシュから読み取る場合は 0 以外。それ以外の場合は 0。

解説

オフライン モードでは、ブラウザーはソース ドキュメントからではなくローカル キャッシュから HTML ページを読み取ります。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetRegisterAsBrowser

このメンバー関数を呼び出して、WebBrowser コントロールがターゲット名解決の最上位ブラウザーとして登録されているかどうかを示す値を設定します。

void SetRegisterAsBrowser(BOOL bNewValue);

パラメーター

bNewValue
Internet Explorer を最上位のブラウザーとして登録するかどうかを決定します。 0 以外の場合、Web ブラウザーは最上位のブラウザーとして登録されます。0 の場合は、最上位レベルのブラウザーではありません。 既定値はゼロです。

解説

最上位レベルのブラウザーは、既定のブラウザーとしてレジストリに設定されているブラウザーです。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetRegisterAsDropTarget

このメンバー関数を呼び出して、WebBrowser コントロールがナビゲーションのドロップ ターゲットとして登録されているかどうかを示す値を設定します。

void SetRegisterAsDropTarget(BOOL bNewValue);

パラメーター

bNewValue
WebBrowser コントロールがナビゲーションのドロップ ターゲットとして登録されているかどうかを判断します。 0 以外の場合、オブジェクトはドロップ ターゲットとして登録されます。0 の場合は、ドロップ ターゲットではありません。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetSilent

このメンバー関数を呼び出して、ダイアログ ボックスを表示できるかどうかを示す値を設定します。

void SetSilent(BOOL bNewValue);

パラメーター

bNewValue
0 以外の場合、ダイアログ ボックスは表示されません。0 の場合は、ダイアログ ボックスが表示されます。 既定値はゼロです。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetStatusBar

ステータス バーを表示するには、このメンバー関数を呼び出します。

void SetStatusBar(BOOL bNewValue);

パラメーター

bNewValue
ステータス バーが表示されている場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer に適用されます。 WebBrowser コントロールでこの呼び出しを使用すると、エラーは返されませんが、この呼び出しは無視されます。

CHtmlView::SetTheaterMode

このメンバー関数を呼び出して、WebBrowser コントロールがシアター モードかどうかを示す値を設定します。

void SetTheaterMode(BOOL bNewValue);

パラメーター

bNewValue
WebBrowser コントロールをシアター モードに設定する場合は 0 以外。それ以外の場合は 0。 既定値はゼロです。

解説

Web ブラウザーがシアター モードの場合、ブラウザーのメイン ウィンドウが画面全体に表示され、ツールバーに最小限のナビゲーション ツール セットが表示され、ステータス バーが画面の右上隅に表示されます。

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetToolBar

Internet Explorer ツール バーを表示または非表示にするには、このメンバー関数を呼び出します。

void SetToolBar(int nNewValue);

パラメーター

nNewValue
ツール バーを表示するかどうかを示します。 ツールバーを表示する場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer に適用されます。 WebBrowser コントロールでこの呼び出しを使用すると、エラーは返されませんが、この呼び出しは無視されます。

CHtmlView::SetTop

このメンバー関数を呼び出して、WebBrowser コントロールの内部上端とそのコンテナーの上端との間の距離を設定します。

void SetTop(long nNewValue);

パラメーター

nNewValue
メイン ウィンドウの上端の画面座標。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetVisible

このメンバー関数を呼び出して、WebBrowser コントロールの表示状態を設定します。

void SetVisible(BOOL bNewValue);

パラメーター

bNewValue
コントロールが表示されている場合は 0 以外。それ以外の場合は 0。

解説

Internet Explorer と WebBrowser に適用されます。

CHtmlView::SetWidth

Internet Explorer のメイン ウィンドウの幅を設定します。

void SetWidth(long nNewValue);

パラメーター

nNewValue
Internet Explorer メイン ウィンドウの幅 (ピクセル単位)。

CHtmlView::Stop

このメンバー関数を呼び出して、保留中のナビゲーションまたはダウンロード操作を取り消し、バックグラウンド サウンドやアニメーションなどの動的なページ要素を停止します。

void Stop();

解説

Internet Explorer と WebBrowser に適用されます。

関連項目

MFC サンプル MFCIE
CFormView クラス
階層グラフ
IWebBrowser2