`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();

`CDHtmlDialog::Navigate`

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実装です。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-11-07

次の方法で共有

CDHtmlDialog クラス

構文

メンバー

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

パブリック メソッド

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

解説

継承階層

要件

DDX_DHtml ヘルパー マクロ

Data Exchange マクロ

CDHtmlDialog::CanAccessExternal

戻り値

CDHtmlDialog::CDHtmlDialog

パラメーター

解説

CDHtmlDialog::~CDHtmlDialog

解説

CDHtmlDialog::CreateControlSite

パラメーター

戻り値

解説

CDHtmlDialog::DDX_DHtml_AxControl

パラメーター

例

CDHtmlDialog::DDX_DHtml_CheckBox

パラメーター

例

CDHtmlDialog::DDX_DHtml_ElementText

パラメーター

CDHtmlDialog::DDX_DHtml_Radio

パラメーター

CDHtmlDialog::DDX_DHtml_SelectIndex

パラメーター

CDHtmlDialog::DDX_DHtml_SelectString

パラメーター

CDHtmlDialog::DDX_DHtml_SelectValue

パラメーター

例

CDHtmlDialog::DestroyModeless

CDHtmlDialog::EnableModeless

パラメーター

戻り値

解説

CDHtmlDialog::FilterDataObject

パラメーター

戻り値

解説

CDHtmlDialog::GetControlDispatch

パラメーター

戻り値

CDHtmlDialog::GetControlProperty

パラメーター

戻り値

解説

CDHtmlDialog::GetCurrentUrl

パラメーター

CDHtmlDialog::GetDHtmlDocument

パラメーター

戻り値

CDHtmlDialog::GetDropTarget

パラメーター

戻り値

解説

CDHtmlDialog::GetElement

パラメーター

戻り値

解説

CDHtmlDialog::GetElementHtml

パラメーター

戻り値

CDHtmlDialog::GetElementInterface

パラメーター

戻り値

例

CDHtmlDialog::GetElementProperty

パラメーター

戻り値

CDHtmlDialog::GetElementText

`CDHtmlDialog` クラス

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

パブリックメソッド

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

`DDX_DHtml` ヘルパーマクロ

`CDHtmlDialog::CanAccessExternal`

`CDHtmlDialog::CDHtmlDialog`

`CDHtmlDialog::~CDHtmlDialog`

`CDHtmlDialog::CreateControlSite`

`CDHtmlDialog::DDX_DHtml_AxControl`

`CDHtmlDialog::DDX_DHtml_CheckBox`

`CDHtmlDialog::DDX_DHtml_ElementText`

`CDHtmlDialog::DDX_DHtml_Radio`

`CDHtmlDialog::DDX_DHtml_SelectIndex`

`CDHtmlDialog::DDX_DHtml_SelectString`

`CDHtmlDialog::DDX_DHtml_SelectValue`

`CDHtmlDialog::DestroyModeless`

`CDHtmlDialog::EnableModeless`

`CDHtmlDialog::FilterDataObject`

`CDHtmlDialog::GetControlDispatch`

`CDHtmlDialog::GetControlProperty`

`CDHtmlDialog::GetCurrentUrl`

`CDHtmlDialog::GetDHtmlDocument`

`CDHtmlDialog::GetDropTarget`

`CDHtmlDialog::GetElement`

`CDHtmlDialog::GetElementHtml`

`CDHtmlDialog::GetElementInterface`

`CDHtmlDialog::GetElementProperty`

`CDHtmlDialog::GetElementText`

`CDHtmlDialog::GetEvent`

`CDHtmlDialog::GetExternal`

`CDHtmlDialog::GetHostInfo`

`CDHtmlDialog::GetOptionKeyPath`

`CDHtmlDialog::HideUI`

`CDHtmlDialog::IsExternalDispatchSafe`

`CDHtmlDialog::LoadFromResource`

`CDHtmlDialog::m_bUseHtmlTitle`

`CDHtmlDialog::m_nHtmlResID`

`CDHtmlDialog::m_pBrowserApp`

`CDHtmlDialog::m_spHtmlDoc`

`CDHtmlDialog::m_strCurrentUrl`

`CDHtmlDialog::m_szHtmlResID`

`CDHtmlDialog::Navigate`

`CDHtmlDialog::OnBeforeNavigate`

`CDHtmlDialog::OnDocumentComplete`

`CDHtmlDialog::OnDocWindowActivate`

`CDHtmlDialog::OnFrameWindowActivate`

`CDHtmlDialog::OnInitDialog`

`CDHtmlDialog::OnNavigateComplete`

`CDHtmlDialog::ResizeBorder`

`CDHtmlDialog::SetControlProperty`

`CDHtmlDialog::SetElementHtml`

`CDHtmlDialog::SetElementProperty`

`CDHtmlDialog::SetElementText`

`CDHtmlDialog::SetExternalDispatch`

`CDHtmlDialog::SetHostFlags`