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 ドキュメントに IDispatch 埋め込まれた ActiveX コントロールのインターフェイスを取得します。 |
CDHtmlDialog::GetControlProperty |
指定した ActiveX コントロールの要求されたプロパティを取得します。 |
CDHtmlDialog::GetCurrentUrl |
現在のドキュメントに関連付けられている Uniform Resource Locator (URL) を取得します。 |
CDHtmlDialog::GetDHtmlDocument |
IHTMLDocument2現在読み込まれている HTML ドキュメントのインターフェイスを取得します。 |
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 コントロール プロパティと交換される値を保持するデータ メンバー (型VARIANTCOleVariant、または 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 を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::EnableModelessです。
CDHtmlDialog::FilterDataObject
ダイアログで、ホストされているブラウザーによって作成されたクリップボード データ オブジェクトをフィルター処理できるようにします。
STDMETHOD(FilterDataObject)(
IDataObject* pDO,
IDataObject** ppDORet);
パラメーター
pDO
Windows SDK をIDocHostUIHandler::FilterDataObject参照してくださいpDO。
ppDORet
Windows SDK をIDocHostUIHandler::FilterDataObject参照してくださいppDORet。
戻り値
S_FALSE を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::FilterDataObjectです。
CDHtmlDialog::GetControlDispatch
IDispatchによって返される HTML ドキュメントに埋め込まれた ActiveX コントロールのインターフェイスをGetDHtmlDocument取得します。
HRESULT GetControlDispatch(
LPCTSTR szId,
IDispatch** ppdisp);
パラメーター
szId
ActiveX コントロールの HTML ID。
ppdisp
IDispatch Web ページで見つかった場合のコントロールのインターフェイス。
戻り値
標準の 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
IDispatch ActiveX コントロールのポインター。
dispId
プロパティのディスパッチ ID。
戻り値
要求されたプロパティを含むバリアント、またはコントロールまたはプロパティが見つからなかった場合は空のバリアント。
解説
オーバーロードは、最も効率的なものから最も効率的なものまで一覧表示されます。
CDHtmlDialog::GetCurrentUrl
現在のドキュメントに関連付けられている Uniform Resource Locator (URL) を取得します。
void GetCurrentUrl(CString& szUrl);
パラメーター
szUrl
CString取得する URL を含むオブジェクト。
CDHtmlDialog::GetDHtmlDocument
IHTMLDocument2現在読み込まれている HTML ドキュメントのインターフェイスを取得します。
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 を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::GetDropTargetです。
CDHtmlDialog::GetElement
で指定された szElementIdHTML 要素のインターフェイスを返します。
HRESULT GetElement(
LPCTSTR szElementId,
IDispatch** ppdisp,
BOOL* pbCollection = NULL);
HRESULT GetElement(
LPCTSTR szElementId,
IHTMLElement** pphtmlElement);
パラメーター
szElementId
HTML 要素の ID。
ppdisp
IDispatch要求された要素または要素のコレクションへのポインター。
pbCollection
BOOL表されるppdispオブジェクトが 1 つの要素であるか、要素のコレクションであるかを示します。
pphtmlElement
IHTMLElement要求された要素へのポインター。
戻り値
標準の HRESULT 値。
解説
指定した ID を持つ複数の要素が存在する可能性がある条件を処理する必要がある場合は、最初のオーバーロードを使用します。 最後のパラメーターを使用して、返されるインターフェイス ポインターがコレクションまたは単一の項目のいずれであるかを調べます。 インターフェイス ポインターがコレクション上にある場合は、クエリを IHTMLElementCollection 実行し、そのプロパティを item 使用して序数位置で要素を参照できます。
ページ内に同じ ID を持つ複数の要素がある場合、2 番目のオーバーロードは失敗します。
CDHtmlDialog::GetElementHtml
でszElementId識別される innerHTML HTML 要素のプロパティを取得します。
BSTR GetElementHtml(LPCTSTR szElementId);
パラメーター
szElementId
HTML 要素の ID。
戻り値
innerHTML要素によってszElementId識別された HTML 要素のプロパティ、またはNULL要素が見つからなかった場合。
CDHtmlDialog::GetElementInterface
によって識別される HTML 要素から要求されたインターフェイス ポインターを szElementId取得します。
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
によって識別される HTML 要素から、指定 dispId されたプロパティの値を szElementId取得します。
VARIANT GetElementProperty(
LPCTSTR szElementId,
DISPID dispId);
パラメーター
szElementId
HTML 要素の ID。
dispId
プロパティのディスパッチ ID。
戻り値
プロパティまたは要素が見つからなかった場合は、プロパティの値または空のバリアント。
CDHtmlDialog::GetElementText
でszElementId識別される innerText HTML 要素のプロパティを取得します。
BSTR GetElementText(LPCTSTR szElementId);
パラメーター
szElementId
HTML 要素の ID。
戻り値
innerTextプロパティまたはNULL要素が見つからなかった場合にszElementId識別される HTML 要素のプロパティ。
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 を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::GetExternalです。
CDHtmlDialog::GetHostInfo
ホストの UI 機能を取得します。
STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);
パラメーター
pInfo
Windows SDK をIDocHostUIHandler::GetHostInfo参照してくださいpInfo。
戻り値
S_OK を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::GetHostInfoです。
CDHtmlDialog::GetOptionKeyPath
ユーザー設定が格納されているレジストリ キーを取得します。
STDMETHOD(GetOptionKeyPath)(
LPOLESTR* pchKey,
DWORD dw);
パラメーター
pchKey
Windows SDK をIDocHostUIHandler::GetOptionKeyPath参照してくださいpchKey。
dw
Windows SDK をIDocHostUIHandler::GetOptionKeyPath参照してくださいdw。
戻り値
E_NOTIMPL を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::GetOptionKeyPathです。
CDHtmlDialog::HideUI
ホストの UI を非表示にします。
STDMETHOD(HideUI)(void);
戻り値
E_NOTIMPL を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::HideUIです。
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;
解説
このTRUE場合、ダイアログ キャプションは HTML ドキュメントのタイトルと同じに設定されます。それ以外の場合m_bUseHtmlTitleは、ダイアログ リソース内のキャプションが使用されます。
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 ヘッダーを指定する値へのポインター。 これらのヘッダーは、既定のインターネット エクスプローラー ヘッダーに追加されます。 ヘッダーでは、サーバーに必要なアクション、サーバーに渡されるデータの種類、状態コードなどの情報を指定できます。 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 を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::OnDocWindowActivateです。
CDHtmlDialog::OnFrameWindowActivate
フレーム ウィンドウがアクティブ化または非アクティブ化されたときにフレームワークによって呼び出されます。
STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);
パラメーター
fActivate
Windows SDK をIDocHostUIHandler::OnFrameWindowActivate参照してくださいfActivate。
戻り値
E_NOTIMPL を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::OnFrameWindowActivateです。
CDHtmlDialog::OnInitDialog
メッセージに応答して呼び出されます WM_INITDIALOG 。
virtual BOOL OnInitDialog();
戻り値
既定の実装では、TRUE が返されます。
解説
このメッセージは、ダイアログ ボックスが表示される直前の 、またはDoModal呼び出し中CreateCreateIndirectにダイアログ ボックスに送信されます。
ダイアログ ボックスの初期化時に特別な処理を実行する必要がある場合は、このメンバー関数をオーバーライドします。 オーバーライドされたバージョンでは、最初に基底クラス 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
IUnknown HTML 要素のポインター。
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
IUnknown HTML 要素のポインター。
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 を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::ShowContextMenuです。
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 を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::ShowUIです。
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 を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::TranslateAcceleratorです。
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 を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::TranslateUrlです。
CDHtmlDialog::UpdateUI
コマンドの状態が変更されたことをホストに通知するために呼び出されます。
STDMETHOD(UpdateUI)(void);
戻り値
E_NOTIMPL を返します。
解説
このメンバー関数は、 CDHtmlDialog Windows SDK で説明されているように、の実装 IDocHostUIHandler::UpdateUIです。
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示