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 コンテナーのドキュメント ウィンドウがアクティブ化または非アクティブ化されたときにアクティブなインプレース オブジェクトに通知する、インターネット エクスプローラーまたは MSHTML 実装IOleInPlaceActiveObject::OnDocWindowActivateから呼び出されます。
CHtmlView::OnDownloadBegin ナビゲーション操作が開始中であることをアプリケーションに通知するために呼び出されます。
CHtmlView::OnDownloadComplete ナビゲーション操作が終了したとき、中止したとき、または失敗したときに呼び出されます。
CHtmlView::OnEnableModeless コンテナーがモーダル ダイアログ ボックスを作成または破棄するときに、モードレス ダイアログ ボックスを有効または無効にするために呼び出されます。
CHtmlView::OnFilterDataObject ホストが Internet Explorer または MSHTML のデータ オブジェクトを置き換えできるように Internet Explorer または MSHTML によってホスト上で呼び出されます。
CHtmlView::OnFrameWindowActivate IOleInPlaceActiveObject::OnFrameWindowActivateコンテナーの最上位フレーム ウィンドウがアクティブ化または非アクティブ化されたときにオブジェクトに通知するために呼び出されます。
CHtmlView::OnFullScreen プロパティが FullScreen 変更されたときに呼び出されます。
CHtmlView::OnGetDropTarget インターネット エクスプローラーまたは 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 インターネット エクスプローラーまたは MSHTML 実装から呼び出され、境界領域のIOleInPlaceActiveObject::ResizeBorderサイズを変更する必要があるオブジェクトに警告します。
CHtmlView::OnShowContextMenu コンテキスト メニューを表示しようとしているときに、インターネット エクスプローラーまたは MSHTML から呼び出されます。
CHtmlView::OnShowUI Internet Explorer または MSHTML がメニューやツール バーを表示する前に呼び出されます。
CHtmlView::OnStatusBar プロパティが StatusBar 変更されたときに呼び出されます。
CHtmlView::OnStatusTextChange WebBrowser コントロールと関連付けられているステータス バーのテキストが変更されたことをアプリケーションに通知するために呼び出されます。
CHtmlView::OnTheaterMode プロパティが TheaterMode 変更されたときに呼び出されます。
CHtmlView::OnTitleChange WebBrowser コントロールのドキュメントのタイトルが使用できるようになるかどうか、また変更するかどうかを、アプリケーションに通知するために呼び出されます。
CHtmlView::OnToolBar プロパティが ToolBar 変更されたときに呼び出されます。
CHtmlView::OnTranslateAccelerator コンテナーのメッセージ キューからメニュー アクセラレータ キー メッセージを処理するためにインターネット エクスプローラーまたは IOleControlSite::TranslateAccelerator MSHTML IOleInPlaceActiveObject::TranslateAccelerator によって呼び出されます。
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) のナビゲーションをサポートし、履歴一覧を管理します。

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

標準の 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 コントロールで成功しますが、表示効果はありません。

継承階層

CObject
CCmdTarget
CWnd
CView
CScrollView
CFormView

CHtmlView

必要条件

ヘッダー:afxhtml.h

CHtmlView::Create

このメンバー関数を呼び出して、インターネット エクスプローラー実行可能ファイルの WebBrowser コントロールまたはコンテナーを作成します。

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

パラメーター

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

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

dwStyle
ウィンドウ スタイル属性を指定します。 既定では、 WS_VISIBLE Windows スタイルと 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 またはインターネット エクスプローラーでコマンドを実行します。

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

パラメーター

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

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

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

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

解説

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

CHtmlView::GetAddressBar

このメンバー関数を呼び出して、インターネット エクスプローラーのアドレス バーを取得します。

BOOL GetAddressBar() const;

戻り値

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

解説

インターネット エクスプローラーに適用されます。 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

このメンバー関数を呼び出して、インターネット エクスプローラーが現在表示しているファイルの完全なパスを取得します。

CString GetFullName() const;

戻り値

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

解説

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

CHtmlView::GetFullScreen

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

BOOL GetFullScreen() const;

戻り値

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

解説

全画面表示モードでは、インターネット エクスプローラー メイン ウィンドウが最大化され、ステータス バー、ツール バー、メニュー バー、タイトル バーが非表示になります。

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;

戻り値

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

解説

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

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

CHtmlView::GetLocationURL

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

CString GetLocationURL() const;

戻り値

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

解説

リソースがネットワークまたはローカル コンピューター上のフォルダーまたはファイルの場合、名前はフォルダーまたはファイルの 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;

戻り値

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

解説

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ソース コードを保持する A。

解説

この関数は、インターネット エクスプローラーの "ソースの表示" コマンドに相当します。ただし、ソース コードが CString.

CHtmlView::GetStatusBar

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

BOOL GetStatusBar() const;

戻り値

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

解説

インターネット エクスプローラーに適用されます。 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

このメンバー関数を呼び出して、インターネット エクスプローラーが 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

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

void GoSearch();

解説

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

CHtmlView::LoadFromResource

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

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

パラメーター

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

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

戻り値

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

解説

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

このメンバー関数を呼び出して、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 ヘッダーを指定する値へのポインター。 これらのヘッダーは、既定のインターネット エクスプローラー ヘッダーに追加されます。 ヘッダーでは、サーバーに必要なアクション、サーバーに渡されるデータの種類、状態コードなどを指定できます。 HTTP URL でない場合 URL 、このパラメーターは無視されます。

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

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

解説

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

このメンバー関数を呼び出して、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 トランザクションを発行します。 HTTP または HTTPS URL でない場合 URL 、このパラメーターは無視されます。

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

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

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

解説

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

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 であるためです。 たとえば、アプリケーションが呼び出しまたは呼び出しNavigateNavigate2で URL を"www.microsoft.com"指定する場合、渡される OnNavigateComplete2 URL は "<https://www.microsoft.com/>". また、サーバーがブラウザーを別の URL にリダイレクトした場合は、リダイレクトされた URL がここに反映されます。

CHtmlView::OnDocWindowActivate

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

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

インターネット エクスプローラーまたは 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
IDataObjectインターネット エクスプローラーまたは MSHTML によって提供されるインターフェイスのアドレス。

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
インターネット エクスプローラーが全画面表示モードの場合は 0 以外、それ以外の場合は 0。

CHtmlView::OnGetDropTarget

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

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

パラメーター

pDropTarget
IDropTargetインターネット エクスプローラーまたは 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 インターフェイスを公開している場合は、このパラメーターを使用してインターネット エクスプローラーまたは 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
ホストの DOCHOSTUIINFO UI 機能を受け取る構造体のアドレス。

戻り値

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

解説

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

CHtmlView::OnGetOptionKeyPath

このメンバー関数を呼び出して、インターネット エクスプローラーまたは MSHTML がユーザー設定を格納するレジストリ キーを取得します。

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

パラメーター

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

dwReserved
将来利用するために予約されています。 現在は使用しません。

戻り値

S_OK 成功した場合は 〗。それ S_FALSE 以外の場合は の場合S_FALSE、インターネット エクスプローラーまたは MSHTML は既定で独自のユーザー オプションになります。

解説

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

CHtmlView::OnHideUI

このメンバー関数は、インターネット エクスプローラーまたは 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
インターネット エクスプローラーメニュー バーが表示されている場合は 0 以外、それ以外の場合は 0。

CHtmlView::OnNavigateComplete2

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

virtual void OnNavigateComplete2(LPCTSTR strURL);

パラメーター

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

解説

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

この strURL URL は正規化された修飾 URL であるため、ブラウザーが移動するように指定された URL とは異なる URL にすることができます。 たとえば、アプリケーションが呼び出しまたは呼び出しNavigateNavigate2で URL を"www.microsoft.com"指定する場合、渡される 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 またはインターネット エクスプローラー オブジェクトのインターフェイス ポインターを受け取る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

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

virtual void OnQuit();

CHtmlView::OnResizeBorder

インターネット エクスプローラーまたは MSHTML 実装から呼び出され、境界領域のIOleInPlaceActiveObject::ResizeBorderサイズを変更する必要があるオブジェクトに警告します。

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

コンテキスト メニューを表示しようとしているときに、インターネット エクスプローラーまたは 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
インターネット エクスプローラーのステータス バーが表示されている場合は 0 以外、それ以外の場合は 0。

CHtmlView::OnStatusTextChange

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

virtual void OnStatusTextChange(LPCTSTR lpszText);

パラメーター

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

CHtmlView::OnTheaterMode

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

virtual void OnTheaterMode(BOOL bTheaterMode);

パラメーター

bTheaterMode
インターネット エクスプローラーがシアター モードの場合は 0 以外、それ以外の場合は 0。

CHtmlView::OnTitleChange

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

virtual void OnTitleChange(LPCTSTR lpszText);

パラメーター

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

解説

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

CHtmlView::OnToolBar

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

virtual void OnToolBar(BOOL bToolBar);

パラメーター

bToolBar
インターネット エクスプローラーのツール バーが表示されている場合は 0 以外、それ以外の場合は 0。

CHtmlView::OnTranslateAccelerator

コンテナーのメッセージ キューからメニュー アクセラレータ キー メッセージを処理するためにインターネット エクスプローラーまたは IOleControlSite::TranslateAccelerator MSHTML IOleInPlaceActiveObject::TranslateAccelerator によって呼び出されます。

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 を表すインターネット エクスプローラーまたは 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。

解説

これにより、オブジェクト コントロールのホスト ウィンドウは、インターネット エクスプローラー ウィンドウの動作と同じように動作します。

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。 コマンドがサポートされている場合は 〗。それ以外の場合TRUEFALSEは 〗

pbEnabled
コマンド (でdwCommandID識別) が有効になっているかどうかを指定するBOOLポインター。 コマンドがサポートされている場合は 〗。それ以外の場合TRUEFALSEは 〗

pbChecked
コマンド (でdwCommandID識別) がチェックされているかどうかを示すポインターBOOL。 コマンドがサポートされている場合は 〗。それ以外の場合TRUEFALSEは 〗

戻り値

標準の 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

インターネット エクスプローラーが現在表示しているファイルを再読み込みします。

void Refresh2(int nLevel);

パラメーター

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

解説

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

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

CHtmlView::SetAddressBar

インターネット エクスプローラー オブジェクトのアドレス バーを表示または非表示にするには、このメンバー関数を呼び出します。

void SetAddressBar(BOOL bNewValue);

パラメーター

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

解説

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

CHtmlView::SetFullScreen

このメンバー関数を呼び出して、インターネット エクスプローラーを全画面表示または通常のウィンドウ モードに設定します。

void SetFullScreen(BOOL bNewValue);

パラメーター

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

解説

全画面表示モードでは、インターネット エクスプローラー メイン ウィンドウが最大化され、ステータス バー、ツール バー、メニュー バー、タイトル バーが非表示になります。

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

CHtmlView::SetHeight

このメンバー関数を呼び出して、インターネット エクスプローラー メイン ウィンドウの高さを設定します。

void SetHeight(long nNewValue);

パラメーター

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

解説

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

CHtmlView::SetLeft

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

void SetLeft(long nNewValue);

パラメーター

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

CHtmlView::SetMenuBar

インターネット エクスプローラーメニュー バーを表示または非表示にするには、このメンバー関数を呼び出します。

void SetMenuBar(BOOL bNewValue);

パラメーター

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

解説

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

CHtmlView::SetOffline

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

void SetOffline(BOOL bNewValue);

パラメーター

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

解説

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

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

CHtmlView::SetRegisterAsBrowser

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

void SetRegisterAsBrowser(BOOL bNewValue);

パラメーター

bNewValue
インターネット エクスプローラーを最上位のブラウザーとして登録するかどうかを決定します。 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。

解説

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

CHtmlView::SetTheaterMode

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

void SetTheaterMode(BOOL bNewValue);

パラメーター

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

解説

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

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

CHtmlView::SetToolBar

インターネット エクスプローラー ツール バーを表示または非表示にするには、このメンバー関数を呼び出します。

void SetToolBar(int nNewValue);

パラメーター

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

解説

インターネット エクスプローラーに適用されます。 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
インターネット エクスプローラー メイン ウィンドウの幅 (ピクセル単位)。

CHtmlView::Stop

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

void Stop();

解説

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

関連項目

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