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 コントロールで成功しますが、表示効果はありません。
GetAddressBar
GetFullName
GetStatusBar
SetAddressBar
SetFullScreen
SetMenuBar
SetStatusBar
SetToolBar
継承階層
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
現在表示されているファイルのパスと名前を含むオブジェクト。 パスとファイル名が存在しない場合は、 GetFullName
空 CString
の値を返します。
解説
インターネット エクスプローラーに適用されます。 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 に適用されます。
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 ヘッダーを指定する値へのポインター。 これらのヘッダーは、既定のインターネット エクスプローラー ヘッダーに追加されます。 ヘッダーでは、サーバーに必要なアクション、サーバーに渡されるデータの種類、状態コードなどを指定できます。 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 に適用されます。
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 トランザクションを発行します。 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 であるためです。 たとえば、アプリケーションが呼び出しまたは呼び出しNavigate
Navigate2
で 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 にすることができます。 たとえば、アプリケーションが呼び出しまたは呼び出しNavigate
Navigate2
で 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
。 コマンドがサポートされている場合は 〗。それ以外の場合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
インターネット エクスプローラーが現在表示しているファイルを再読み込みします。
void Refresh2(int nLevel);
パラメーター
nLevel
更新レベルを指定する変数のアドレス。 使用可能な変数は、Windows SDK で RefreshConstants
定義されています。
解説
とは異なり Refresh
、 Refresh2
更新レベルを指定するパラメーターが含まれています。
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 に適用されます。
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示