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 コントロールからのイベントを処理することもできます。
継承階層
CDHtmlSinkHandlerBase2
CDHtmlSinkHandlerBase1
CDHtmlSinkHandler
CDHtmlEventSink
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実装です。
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示