CDHtmlDialog クラス

  • [アーティクル]

ダイアログ リソースではなく HTML を使用してユーザー インターフェイスを実装するダイアログ ボックスを作成するために使用されます。

構文

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

メンバー

パブリック コンストラクター

名前 説明
CDHtmlDialog::CDHtmlDialog CDHtmlDialog オブジェクトを構築します。
CDHtmlDialog::~CDHtmlDialog CDHtmlDialog オブジェクトを破棄します。

パブリック メソッド

名前 説明
CDHtmlDialog::CanAccessExternal 読み込まれたページのスクリプト オブジェクトがコントロール サイトの外部ディスパッチにアクセスできるかどうかを確認するためのアクセス チェックとして呼び出されるオーバーライド可能。 ディスパッチがスクリプトに対して安全であることを確認するか、現在のゾーンでスクリプトに安全ではないオブジェクトを許可するかを確認します。
CDHtmlDialog::CreateControlSite ダイアログで WebBrowser コントロールをホストするコントロール サイト インスタンスを作成するために使用されるオーバーライド可能。
CDHtmlDialog::DDX_DHtml_AxControl メンバー変数と、HTML ページ上の ActiveX コントロールのプロパティ値の間でデータを交換します。
CDHtmlDialog::DDX_DHtml_CheckBox メンバー変数と HTML ページのチェック ボックスの間でデータを交換します。
CDHtmlDialog::DDX_DHtml_ElementText メンバー変数と HTML ページ上の任意の HTML 要素プロパティの間でデータを交換します。
CDHtmlDialog::DDX_DHtml_Radio メンバー変数と HTML ページのラジオ ボタンの間でデータを交換します。
CDHtmlDialog::DDX_DHtml_SelectIndex HTML ページのリスト ボックスのインデックスを取得または設定します。
CDHtmlDialog::DDX_DHtml_SelectString HTML ページのリスト ボックス エントリ (現在のインデックスに基づく) の表示テキストを取得または設定します。
CDHtmlDialog::DDX_DHtml_SelectValue HTML ページのリスト ボックス エントリ (現在のインデックスに基づく) の値を取得または設定します。
CDHtmlDialog::DestroyModeless モードレス ダイアログ ボックスを破棄します。
CDHtmlDialog::EnableModeless モードレス ダイアログ ボックスが有効になります。
CDHtmlDialog::FilterDataObject ダイアログで、ホストされているブラウザーによって作成されたクリップボード データ オブジェクトをフィルター処理できるようにします。
CDHtmlDialog::GetControlDispatch HTML ドキュメントに埋め込まれた ActiveX コントロールの IDispatch インターフェイスを取得します。
CDHtmlDialog::GetControlProperty 指定した ActiveX コントロールの要求されたプロパティを取得します。
CDHtmlDialog::GetCurrentUrl 現在のドキュメントに関連付けられている Uniform Resource Locator (URL) を取得します。
CDHtmlDialog::GetDHtmlDocument 現在読み込まれている HTML ドキュメントの IHTMLDocument2 インターフェイスを取得します。
CDHtmlDialog::GetDropTarget ダイアログが代替の IDropTargetを提供できるように、ドロップ ターゲットとして使用されている場合に、含まれている WebBrowser コントロールによって呼び出されます。
CDHtmlDialog::GetElement HTML 要素のインターフェイスを取得します。
CDHtmlDialog::GetElementHtml HTML 要素の innerHTML プロパティを取得します。
CDHtmlDialog::GetElementInterface HTML 要素から要求されたインターフェイス ポインターを取得します。
CDHtmlDialog::GetElementProperty HTML 要素のプロパティの値を取得します。
CDHtmlDialog::GetElementText HTML 要素の innerText プロパティを取得します。
CDHtmlDialog::GetEvent 現在のイベント オブジェクトへの IHTMLEventObj ポインターを取得します。
CDHtmlDialog::GetExternal ホストの IDispatch インターフェイスを取得します。
CDHtmlDialog::GetHostInfo ホストの UI 機能を取得します。
CDHtmlDialog::GetOptionKeyPath ユーザー設定が格納されているレジストリ キーを取得します。
CDHtmlDialog::HideUI ホストの UI を非表示にします。
CDHtmlDialog::IsExternalDispatchSafe ホストの IDispatch インターフェイスがスクリプト作成に安全かどうかを示します。
CDHtmlDialog::LoadFromResource 指定したリソースを WebBrowser コントロールに読み込みます。
CDHtmlDialog::Navigate 指定された URL に移動します。
CDHtmlDialog::OnBeforeNavigate ナビゲーション イベントが発生する前にフレームワークによって呼び出されます。
CDHtmlDialog::OnDocumentComplete ドキュメントが READYSTATE_COMPLETE 状態に達したときにアプリケーションに通知するためにフレームワークによって呼び出されます。
CDHtmlDialog::OnDocWindowActivate ドキュメント ウィンドウがアクティブ化または非アクティブ化されたときにフレームワークによって呼び出されます。
CDHtmlDialog::OnFrameWindowActivate フレーム ウィンドウがアクティブ化または非アクティブ化されたときにフレームワークによって呼び出されます。
CDHtmlDialog::OnInitDialog WM_INITDIALOG メッセージに応答して呼び出されます。
CDHtmlDialog::OnNavigateComplete ナビゲーション イベントの完了後にフレームワークによって呼び出されます。
CDHtmlDialog::ResizeBorder 境界領域のサイズを変更する必要があるオブジェクトに警告します。
CDHtmlDialog::SetControlProperty ActiveX コントロールのプロパティを新しい値に設定します。
CDHtmlDialog::SetElementHtml HTML 要素の innerHTML プロパティを設定します。
CDHtmlDialog::SetElementProperty HTML 要素のプロパティを設定します。
CDHtmlDialog::SetElementText HTML 要素の innerText プロパティを設定します。
CDHtmlDialog::SetExternalDispatch ホストの IDispatch インターフェイスを設定します。
CDHtmlDialog::SetHostFlags ホストの UI フラグを設定します。
CDHtmlDialog::ShowContextMenu コンテキスト メニューが表示されようとしているときに呼び出されます。
CDHtmlDialog::ShowUI ホストの UI を表示します。
CDHtmlDialog::TranslateAccelerator メニュー アクセラレータ キー メッセージを処理するために呼び出されます。
CDHtmlDialog::TranslateUrl 読み込まれる URL を変更するために呼び出されます。
CDHtmlDialog::UpdateUI コマンドの状態が変更されたことをホストに通知するために呼び出されます。

パブリック データ メンバー

名前 説明
CDHtmlDialog::m_bUseHtmlTitle HTML ドキュメントのタイトルをダイアログ キャプションとして使用するかどうかを示します。
CDHtmlDialog::m_nHtmlResID 表示する HTML リソースのリソース ID。
CDHtmlDialog::m_pBrowserApp Web ブラウザー アプリケーションへのポインター。
CDHtmlDialog::m_spHtmlDoc HTML ドキュメントへのポインター。
CDHtmlDialog::m_strCurrentUrl 現在の URL。
CDHtmlDialog::m_szHtmlResID HTML リソース ID の文字列バージョン。

解説

CDHtmlDialog は、HTML リソースまたは URL から表示される HTML を読み込むことができます。

CDHtmlDialog また、HTML コントロールを使用してデータ交換を行い、ボタンのクリックなどの HTML コントロールからのイベントを処理することもできます。

継承階層

CObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTarget

CDHtmlSinkHandler

CWnd

CDHtmlEventSink

CDialog

CDHtmlDialog

要件

ヘッダー: afxdhtml.h

DDX_DHtml ヘルパー マクロ

DDX_DHtml ヘルパー マクロを使用すると、HTML ページ上のコントロールの一般的に使用されるプロパティに簡単にアクセスできます。

Data Exchange マクロ

名前 説明
DDX_DHtml_ElementValue 選択したコントロールの Value プロパティを設定または取得します。
DDX_DHtml_ElementInnerText 現在の要素の開始タグと終了タグの間のテキストを設定または取得します。
DDX_DHtml_ElementInnerHtml 現在の要素の開始タグと終了タグの間の HTML を設定または取得します。
DDX_DHtml_Anchor_Href 宛先 URL またはアンカー ポイントを設定または取得します。
DDX_DHtml_Anchor_Target ターゲット ウィンドウまたはフレームを設定または取得します。
DDX_DHtml_Img_Src ドキュメント内の画像またはビデオ クリップの名前を設定または取得します。
DDX_DHtml_Frame_Src 関連付けられたフレームの URL を設定または取得します。
DDX_DHtml_IFrame_Src 関連付けられたフレームの URL を設定または取得します。

CDHtmlDialog::CanAccessExternal

読み込まれたページのスクリプト オブジェクトがコントロール サイトの外部ディスパッチにアクセスできるかどうかを確認するためのアクセス チェックとして呼び出されるオーバーライド可能。 ディスパッチがスクリプトに対して安全であることを確認するか、現在のゾーンでスクリプトに安全ではないオブジェクトを許可するかを確認します。

virtual BOOL CanAccessExternal();

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

CDHtmlDialog::CDHtmlDialog

リソースベースの動的 HTML ダイアログ ボックスを作成します。

CDHtmlDialog();

CDHtmlDialog(
    LPCTSTR lpszTemplateName,
    LPCTSTR szHtmlResID,
    CWnd *pParentWnd = NULL);

CDHtmlDialog(
    UINT nIDTemplate,
    UINT nHtmlResID = 0,
    CWnd *pParentWnd = NULL);

パラメーター

lpszTemplateName
ダイアログ ボックス テンプレート リソースの名前である null で終わる文字列。

szHtmlResID
HTML リソースの名前である null で終わる文字列。

pParentWnd
ダイアログ オブジェクトが属する親または所有者ウィンドウ オブジェクト ( CWnd 型) へのポインター。 NULL場合、ダイアログ オブジェクトの親ウィンドウはメイン アプリケーション ウィンドウに設定されます。

nIDTemplate
ダイアログ ボックス テンプレート リソースの ID 番号を格納します。

nHtmlResID
HTML リソースの ID 番号を格納します。

解説

コンストラクターの 2 番目の形式では、テンプレート名を使用してダイアログ リソースにアクセスできます。 コンストラクターの 3 番目の形式では、リソース テンプレートの ID を使用してダイアログ リソースにアクセスできます。 通常、ID は IDD_ プレフィックスで始まります。

CDHtmlDialog::~CDHtmlDialog

CDHtmlDialog オブジェクトを破棄します。

virtual ~CDHtmlDialog();

解説

CWnd::DestroyWindowメンバー関数は、CDialog::Createによって作成されたモードレス ダイアログ ボックスを破棄するために使用する必要があります。

CDHtmlDialog::CreateControlSite

ダイアログで WebBrowser コントロールをホストするコントロール サイト インスタンスを作成するために使用されるオーバーライド可能。

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

パラメーター

pContainer
COleControlContainer オブジェクトを指すポインター。

ppSite
COleControlSiteへのポインターへのポインター。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

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

CDHtmlDialog::DDX_DHtml_AxControl

メンバー変数と、HTML ページ上の ActiveX コントロールのプロパティ値の間でデータを交換します。

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    VARIANT& var);

void DDX_DHtml_AxControl(
    CDataExchange* pDX,
    LPCTSTR szId,
    LPCTSTR szPropName,
    VARIANT& var);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

szId
ActiveX コントロールの HTML ソース内のオブジェクト タグの ID パラメーターの値。

dispId
データを交換するプロパティのディスパッチ ID。

szPropName
プロパティの名前。

var
ActiveX コントロール プロパティと交換される値を保持する、 VARIANT、 COleVariant、または CComVariantのデータ メンバー。

例

// COleVariant m_varSliderValue;
DDX_DHtml_AxControl(pDX, _T("slider1"), 0x0b /* Value */, m_varSliderValue);

CDHtmlDialog::DDX_DHtml_CheckBox

メンバー変数と HTML ページのチェック ボックスの間でデータを交換します。

void DDX_DHtml_CheckBox(
    CDataExchange* pDX,
    LPCTSTR szId,
    int& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

szId
HTML コントロールの ID パラメーターに指定した値。

value
交換される値。

例

// int m_nItalic;
DDX_DHtml_CheckBox(pDX, L"italic", m_nItalic);

CDHtmlDialog::DDX_DHtml_ElementText

メンバー変数と HTML ページ上の任意の HTML 要素プロパティの間でデータを交換します。

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    CString& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    short& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    int& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    long& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    DWORD& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    float& value);

void DDX_DHtml_ElementText(
    CDataExchange* pDX,
    LPCTSTR szId,
    DISPID dispId,
    double& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

szId
HTML コントロールの ID パラメーターに指定した値。

dispId
データを交換する HTML 要素のディスパッチ ID。

value
交換される値。

CDHtmlDialog::DDX_DHtml_Radio

メンバー変数と HTML ページのラジオ ボタンの間でデータを交換します。

void DDX_DHtml_Radio(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

szId
HTML コントロールの ID パラメーターに指定した値。

value
交換される値。

CDHtmlDialog::DDX_DHtml_SelectIndex

HTML ページのリスト ボックスのインデックスを取得または設定します。

void DDX_DHtml_SelectIndex(
    CDataExchange* pDX,
    LPCTSTR szId,
    long& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

szId
HTML コントロールの id パラメーターに指定した値。

value
交換される値。

CDHtmlDialog::DDX_DHtml_SelectString

HTML ページのリスト ボックス エントリ (現在のインデックスに基づく) の表示テキストを取得または設定します。

void DDX_DHtml_SelectString(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

szId
HTML コントロールの ID パラメーターに指定した値。

value
交換される値。

CDHtmlDialog::DDX_DHtml_SelectValue

HTML ページのリスト ボックス エントリ (現在のインデックスに基づく) の値を取得または設定します。

void DDX_DHtml_SelectValue(
    CDataExchange* pDX,
    LPCTSTR szId,
    CString& value);

パラメーター

pDX
CDataExchange オブジェクトを指すポインターです。

szId
HTML コントロールの ID パラメーターに指定した値。

value
交換される値。

例

// CString m_strBlurDir;
DDX_DHtml_SelectValue(pDX, L"blurDir", m_strBlurDir);

CDHtmlDialog::DestroyModeless

CDHtmlDialog オブジェクトからモードレス ダイアログ ボックスをデタッチし、オブジェクトを破棄します。

void DestroyModeless();

CDHtmlDialog::EnableModeless

モードレス ダイアログ ボックスが有効になります。

STDMETHOD(EnableModeless)(BOOL fEnable);

パラメーター

fEnable
Windows SDK のIDocHostUIHandler::EnableModelessのfEnableを参照してください。

戻り値

E_NOTIMPL を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::EnableModelessのCDHtmlDialog実装です。

CDHtmlDialog::FilterDataObject

ダイアログで、ホストされているブラウザーによって作成されたクリップボード データ オブジェクトをフィルター処理できるようにします。

STDMETHOD(FilterDataObject)(
    IDataObject* pDO,
    IDataObject** ppDORet);

パラメーター

pDO
Windows SDK のIDocHostUIHandler::FilterDataObjectのpDOを参照してください。

ppDORet
Windows SDK のIDocHostUIHandler::FilterDataObjectのppDORetを参照してください。

戻り値

S_FALSE を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::FilterDataObjectのCDHtmlDialog実装です。

CDHtmlDialog::GetControlDispatch

GetDHtmlDocumentによって返される HTML ドキュメントに埋め込まれた ActiveX コントロールのIDispatch インターフェイスを取得します。

HRESULT GetControlDispatch(
    LPCTSTR szId,
    IDispatch** ppdisp);

パラメーター

szId
ActiveX コントロールの HTML ID。

ppdisp
Web ページで見つかった場合は、コントロールの IDispatch インターフェイス。

戻り値

標準の HRESULT 値。

CDHtmlDialog::GetControlProperty

指定した ActiveX コントロールの要求されたプロパティを取得します。

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

パラメーター

szId
ActiveX コントロールの HTML ID。

szPropName
現在のユーザーの既定のロケールのプロパティの名前。

pdispControl
ActiveX コントロールの IDispatch ポインター。

dispId
プロパティのディスパッチ ID。

戻り値

要求されたプロパティを含むバリアント、またはコントロールまたはプロパティが見つからなかった場合は空のバリアント。

解説

オーバーロードは、最も効率的なものから最も効率的なものまで一覧表示されます。

CDHtmlDialog::GetCurrentUrl

現在のドキュメントに関連付けられている Uniform Resource Locator (URL) を取得します。

void GetCurrentUrl(CString& szUrl);

パラメーター

szUrl
取得する URL を含む CString オブジェクト。

CDHtmlDialog::GetDHtmlDocument

現在読み込まれている HTML ドキュメントの IHTMLDocument2 インターフェイスを取得します。

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

パラメーター

**pphtmlDoc HTML ドキュメントへのポインターへのポインター。

戻り値

標準の HRESULT。 正常に終了した場合は S_OK を返します。

CDHtmlDialog::GetDropTarget

ダイアログが代替の IDropTargetを提供できるように、ドロップ ターゲットとして使用されている場合に、含まれている WebBrowser コントロールによって呼び出されます。

STDMETHOD(GetDropTarget)(
    IDropTarget* pDropTarget,
    IDropTarget** ppDropTarget);

パラメーター

pDropTarget
Windows SDK のIDocHostUIHandler::GetDropTargetのpDropTargetを参照してください。

ppDropTarget
Windows SDK のIDocHostUIHandler::GetDropTargetのppDropTargetを参照してください。

戻り値

E_NOTIMPL を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::GetDropTargetのCDHtmlDialog実装です。

CDHtmlDialog::GetElement

szElementIdで指定された HTML 要素のインターフェイスを返します。

HRESULT GetElement(
    LPCTSTR szElementId,
    IDispatch** ppdisp,
    BOOL* pbCollection = NULL);

HRESULT GetElement(
    LPCTSTR szElementId,
    IHTMLElement** pphtmlElement);

パラメーター

szElementId
HTML 要素の ID。

ppdisp
要求された要素または要素のコレクションへの IDispatch ポインター。

pbCollection
ppdispによって表されるオブジェクトが 1 つの要素であるか、要素のコレクションであるかを示すBOOL。

pphtmlElement
要求された要素への IHTMLElement ポインター。

戻り値

標準の HRESULT 値。

解説

指定した ID を持つ複数の要素が存在する可能性がある条件を処理する必要がある場合は、最初のオーバーロードを使用します。 最後のパラメーターを使用して、返されるインターフェイス ポインターがコレクションまたは単一の項目のいずれであるかを調べます。 インターフェイス ポインターがコレクション上にある場合は、 IHTMLElementCollection を照会し、その item プロパティを使用して序数位置で要素を参照できます。

ページ内に同じ ID を持つ複数の要素がある場合、2 番目のオーバーロードは失敗します。

CDHtmlDialog::GetElementHtml

szElementIdによって識別される HTML 要素のinnerHTML プロパティを取得します。

BSTR GetElementHtml(LPCTSTR szElementId);

パラメーター

szElementId
HTML 要素の ID。

戻り値

szElementIdによって識別される HTML 要素のinnerHTMLプロパティ。要素が見つからなかった場合はNULL。

CDHtmlDialog::GetElementInterface

szElementIdによって識別される HTML 要素から要求されたインターフェイス ポインターを取得します。

template <class Q> HRESULT GetElementInterface(
    LPCTSTR szElementId,
    Q** ppvObj);

HRESULT GetElementInterface(
    LPCTSTR szElementId,
    REFIID refiid,
    void** ppvObj);

パラメーター

szElementId
HTML 要素の ID。

ppvObj
要素が見つかり、クエリが成功した場合に、要求されたインターフェイス ポインターでいっぱいになるポインターのアドレス。

refiid
要求されたインターフェイスのインターフェイス ID (IID)。

戻り値

標準の HRESULT 値。

例

CComPtr<IHTMLInputButtonElement> spBtn1;
CComPtr<IHTMLInputButtonElement> spBtn2;
HRESULT hr = S_OK;

// Use the template overload
hr = GetElementInterface(L"Button1", &spBtn1);

// Use the nontemplate overload
hr = GetElementInterface(L"Button1", IID_IHTMLInputButtonElement,
                         reinterpret_cast<void **>(&spBtn2));

CDHtmlDialog::GetElementProperty

szElementIdで識別される HTML 要素から、dispIdによって識別されるプロパティの値を取得します。

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

パラメーター

szElementId
HTML 要素の ID。

dispId
プロパティのディスパッチ ID。

戻り値

プロパティまたは要素が見つからなかった場合は、プロパティの値または空のバリアント。

CDHtmlDialog::GetElementText

szElementIdによって識別される HTML 要素のinnerText プロパティを取得します。

BSTR GetElementText(LPCTSTR szElementId);

パラメーター

szElementId
HTML 要素の ID。

戻り値

プロパティまたは要素が見つからなかった場合にszElementIdまたはNULLによって識別される HTML 要素のinnerTextプロパティ。

CDHtmlDialog::GetEvent

現在のイベント オブジェクトへの IHTMLEventObj ポインターを返します。

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

パラメーター

ppEventObj
IHTMLEventObj インターフェイス ポインターで塗りつぶされるポインターのアドレス。

戻り値

標準の HRESULT 値。

解説

この関数は、DHTML イベント ハンドラー内からのみ呼び出す必要があります。

CDHtmlDialog::GetExternal

ホストの IDispatch インターフェイスを取得します。

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

パラメーター

ppDispatch
Windows SDK のIDocHostUIHandler::GetExternalのppDispatchを参照してください。

戻り値

成功した場合は S_OK を返し、失敗した場合は E_NOTIMPL を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::GetExternalのCDHtmlDialog実装です。

CDHtmlDialog::GetHostInfo

ホストの UI 機能を取得します。

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

パラメーター

pInfo
Windows SDK のIDocHostUIHandler::GetHostInfoのpInfoを参照してください。

戻り値

S_OK を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::GetHostInfoのCDHtmlDialog実装です。

CDHtmlDialog::GetOptionKeyPath

ユーザー設定が格納されているレジストリ キーを取得します。

STDMETHOD(GetOptionKeyPath)(
    LPOLESTR* pchKey,
    DWORD dw);

パラメーター

pchKey
Windows SDK のIDocHostUIHandler::GetOptionKeyPathのpchKeyを参照してください。

dw
Windows SDK のIDocHostUIHandler::GetOptionKeyPathのdwを参照してください。

戻り値

E_NOTIMPL を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::GetOptionKeyPathのCDHtmlDialog実装です。

CDHtmlDialog::HideUI

ホストの UI を非表示にします。

STDMETHOD(HideUI)(void);

戻り値

E_NOTIMPL を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::HideUIのCDHtmlDialog実装です。

CDHtmlDialog::IsExternalDispatchSafe

ホストの IDispatch インターフェイスがスクリプト作成に安全かどうかを示します。

virtual BOOL IsExternalDispatchSafe();

戻り値

FALSE を返します。

CDHtmlDialog::LoadFromResource

指定したリソースを DHTML ダイアログの WebBrowser コントロールに読み込みます。

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

パラメーター

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

nRes
読み込むリソースの ID です。

戻り値

成功した場合は TRUE。それ以外の場合は FALSE。

CDHtmlDialog::m_bUseHtmlTitle

HTML ドキュメントのタイトルをダイアログ キャプションとして使用するかどうかを示します。

BOOL m_bUseHtmlTitle;

解説

m_bUseHtmlTitleがTRUE場合、ダイアログ キャプションは HTML ドキュメントのタイトルと同じに設定されます。それ以外の場合は、ダイアログ リソース内のキャプションが使用されます。

CDHtmlDialog::m_nHtmlResID

表示する HTML リソースのリソース ID。

UINT m_nHtmlResID;

例

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
mydialog.m_nHtmlResID = IDR_HTML_MYDHTMLDLG;
mydialog.DoModal();

CDHtmlDialog::m_pBrowserApp

Web ブラウザー アプリケーションへのポインター。

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog::m_spHtmlDoc

HTML ドキュメントへのポインター。

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog::m_strCurrentUrl

現在の URL。

CString m_strCurrentUrl;

CDHtmlDialog::m_szHtmlResID

HTML リソース ID の文字列バージョン。

LPTSTR m_szHtmlResID;

例

CDHtmlDialog mydialog(IDD_MYDHTMLDLG);
TCHAR szResID[] = _T("HTML_PAGE");
mydialog.m_szHtmlResID = szResID;
mydialog.DoModal();

lpszURLで指定された URL で識別されるリソースに移動します。

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

パラメーター

lpszURL
対象となる 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 でない場合、このパラメーターは無視されます。

CDHtmlDialog::OnBeforeNavigate

ナビゲーションが発生する前にイベントを発生させるためにフレームワークによって呼び出されます。

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

パラメーター

pDisp
IDispatch オブジェクトへのポインター。

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

CDHtmlDialog::OnDocumentComplete

ドキュメントが READYSTATE_COMPLETE 状態になったときにアプリケーションに通知するためにフレームワークによって呼び出されます。

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

パラメーター

pDisp
IDispatch オブジェクトへのポインター。

szUrl
移動された URL を含む文字列へのポインター。

CDHtmlDialog::OnDocWindowActivate

ドキュメント ウィンドウがアクティブ化または非アクティブ化されたときにフレームワークによって呼び出されます。

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

パラメーター

fActivate
Windows SDK のIDocHostUIHandler::OnDocWindowActivateのfActivateを参照してください。

戻り値

E_NOTIMPL を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::OnDocWindowActivateのCDHtmlDialog実装です。

CDHtmlDialog::OnFrameWindowActivate

フレーム ウィンドウがアクティブ化または非アクティブ化されたときにフレームワークによって呼び出されます。

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

パラメーター

fActivate
Windows SDK のIDocHostUIHandler::OnFrameWindowActivateのfActivateを参照してください。

戻り値

E_NOTIMPL を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::OnFrameWindowActivateのCDHtmlDialog実装です。

CDHtmlDialog::OnInitDialog

WM_INITDIALOG メッセージに応答して呼び出されます。

virtual BOOL OnInitDialog();

戻り値

既定の実装では、TRUE が返されます。

解説

このメッセージは、 Create、 CreateIndirect、または DoModal の呼び出し中にダイアログ ボックスに送信されます。この呼び出しは、ダイアログ ボックスが表示される直前に発生します。

ダイアログ ボックスの初期化時に特別な処理を実行する必要がある場合は、このメンバー関数をオーバーライドします。 オーバーライドされたバージョンでは、最初に基底クラス OnInitDialog を呼び出しますが、戻り値は無視します。 通常は、オーバーライドされたメンバー関数から TRUE を返します。

Windows では、メッセージ マップではなく、すべての Microsoft Foundation クラス ライブラリ ダイアログ ボックスに共通する標準のグローバル ダイアログ ボックス プロシージャを使用して OnInitDialog 関数が呼び出されるため、このメンバー関数のメッセージ マップ エントリは必要ありません。

CDHtmlDialog::OnNavigateComplete

指定した URL へのナビゲーションが完了した後、フレームワークによって呼び出されます。

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

パラメーター

pDisp
IDispatch オブジェクトへのポインター。

szUrl
移動された URL を含む文字列へのポインター。

CDHtmlDialog::ResizeBorder

境界領域のサイズを変更する必要があるオブジェクトに警告します。

STDMETHOD(ResizeBorder)(
    LPCRECT prcBorder,
    IOleInPlaceUIWindow* pUIWindow,
    BOOL fRameWindow);

パラメーター

prcBorder
Windows SDK のIDocHostUIHandler::ResizeBorderのprcBorderを参照してください。

pUIWindow
Windows SDK のIDocHostUIHandler::ResizeBorderのpUIWindowを参照してください。

fFrameWindow
Windows SDK のIDocHostUIHandler::ResizeBorderのfFrameWindowを参照してください。

戻り値

E_NOTIMPL を返します。

CDHtmlDialog::SetControlProperty

ActiveX コントロールのプロパティを新しい値に設定します。

void SetControlProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId,
    VARIANT* pVar);

void SetControlProperty(
    LPCTSTR szElementId,
    LPCTSTR szPropName,
    VARIANT* pVar);

パラメーター

szElementId
ActiveX コントロールの HTML ID。

dispId
設定するプロパティのディスパッチ ID。

pVar
新しいプロパティ値を含む VARIANT へのポインター。

pdispControl
ActiveX コントロールの IDispatch インターフェイスへのポインター。

szPropName
設定するプロパティの名前を含む文字列。

CDHtmlDialog::SetElementHtml

HTML 要素の innerHTML プロパティを設定します。

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

パラメーター

szElementId
HTML 要素の ID。

bstrText
innerHTML プロパティの新しい値。

punkElem
HTML 要素の IUnknown ポインター。

CDHtmlDialog::SetElementProperty

HTML 要素のプロパティを設定します。

void SetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId,
    VARIANT* pVar);

パラメーター

szElementId
HTML 要素の ID。

dispId
設定するプロパティのディスパッチ ID。

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

CDHtmlDialog::SetElementText

HTML 要素の innerText プロパティを設定します。

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

パラメーター

szElementId
HTML 要素の ID。

bstrText
innerText プロパティの新しい値。

punkElem
HTML 要素の IUnknown ポインター。

CDHtmlDialog::SetExternalDispatch

ホストの IDispatch インターフェイスを設定します。

void SetExternalDispatch(IDispatch* pdispExternal);

パラメーター

pdispExternal
新しい IDispatch インターフェイス。

CDHtmlDialog::SetHostFlags

ホスト UI フラグを設定します。

void SetHostFlags(DWORD dwFlags);

パラメーター

dwFlags
使用可能な値については、Windows SDK の DOCHOSTUIFLAG を参照してください。

CDHtmlDialog::ShowContextMenu

コンテキスト メニューが表示されようとしているときに呼び出されます。

STDMETHOD(ShowContextMenu)(
    DWORD dwID,
    POINT* ppt,
    IUnknown* pcmdtReserved,
    IDispatch* pdispReserved);

パラメーター

dwID
Windows SDK のIDocHostUIHandler::ShowContextMenuのdwIDを参照してください。

ppt
Windows SDK のIDocHostUIHandler::ShowContextMenuのpptを参照してください。

pcmdtReserved
Windows SDK のIDocHostUIHandler::ShowContextMenuのpcmdtReservedを参照してください。

pdispReserved
Windows SDK のIDocHostUIHandler::ShowContextMenuのpdispReservedを参照してください。

戻り値

S_FALSE を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::ShowContextMenuのCDHtmlDialog実装です。

CDHtmlDialog::ShowUI

ホストの UI を表示します。

STDMETHOD(ShowUI)(
    DWORD dwID,
    IOleInPlaceActiveObject* pActiveObject,
    IOleCommandTarget* pCommandTarget,
    IOleInPlaceFrame* pFrame,
    IOleInPlaceUIWindow* pDoc);

パラメーター

dwID
Windows SDK のIDocHostUIHandler::ShowUIのdwIDを参照してください。

pActiveObject
Windows SDK のIDocHostUIHandler::ShowUIのpActiveObjectを参照してください。

pCommandTarget
Windows SDK のIDocHostUIHandler::ShowUIのpCommandTargetを参照してください。

pFrame
Windows SDK のIDocHostUIHandler::ShowUIのpFrameを参照してください。

pDoc
Windows SDK のIDocHostUIHandler::ShowUIのpDocを参照してください。

戻り値

S_FALSE を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::ShowUIのCDHtmlDialog実装です。

CDHtmlDialog::TranslateAccelerator

メニュー アクセラレータ キー メッセージを処理するために呼び出されます。

STDMETHOD(TranslateAccelerator)(
    LPMSG lpMsg,
    const GUID* pguidCmdGroup,
    DWORD nCmdID);

パラメーター

lpMsg
Windows SDK のIDocHostUIHandler::TranslateAcceleratorのlpMsgを参照してください。

pguidCmdGroup
Windows SDK のIDocHostUIHandler::TranslateAcceleratorのpguidCmdGroupを参照してください。

nCmdID
Windows SDK のIDocHostUIHandler::TranslateAcceleratorのnCmdIDを参照してください。

戻り値

S_FALSE を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::TranslateAcceleratorのCDHtmlDialog実装です。

CDHtmlDialog::TranslateUrl

読み込まれる URL を変更するために呼び出されます。

STDMETHOD(TranslateUrl)(
    DWORD dwTranslate,
    OLECHAR* pchURLIn,
    OLECHAR** ppchURLOut);

パラメーター

dwTranslate
Windows SDK のIDocHostUIHandler::TranslateUrlのdwTranslateを参照してください。

pchURLIn
Windows SDK のIDocHostUIHandler::TranslateUrlのpchURLInを参照してください。

ppchURLOut
Windows SDK のIDocHostUIHandler::TranslateUrlのppchURLOutを参照してください。

戻り値

S_FALSE を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::TranslateUrlのCDHtmlDialog実装です。

CDHtmlDialog::UpdateUI

コマンドの状態が変更されたことをホストに通知するために呼び出されます。

STDMETHOD(UpdateUI)(void);

戻り値

E_NOTIMPL を返します。

解説

このメンバー関数は、Windows SDK で説明されているように、IDocHostUIHandler::UpdateUIのCDHtmlDialog実装です。

関連項目

MFC サンプル DHtmlExplore
DDX_DHtml ヘルパー マクロ
階層図