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 コントロール プロパティと交換される値を保持するデータ メンバー (型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
を返します。
解説
このメンバー関数は、 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
で指定された szElementId
HTML 要素のインターフェイスを返します。
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
呼び出し中Create
CreateIndirect
にダイアログ ボックスに送信されます。
ダイアログ ボックスの初期化時に特別な処理を実行する必要がある場合は、このメンバー関数をオーバーライドします。 オーバーライドされたバージョンでは、最初に基底クラス 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
です。
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示