CDHtmlDialog 클래스CDHtmlDialog Class

는 대화 상자 리소스가 아닌 HTML을 사용 하 여 사용자 인터페이스를 구현 하는 대화 상자를 만드는 데 사용 됩니다.Is used to create dialog boxes that use HTML rather than dialog resources to implement their user interface.

구문Syntax

class CDHtmlDialog : public CDialog, public CDHtmlEventSink

멤버Members

Public 생성자Public Constructors

이름Name 설명Description
CDHtmlDialog:: CDHtmlDialogCDHtmlDialog::CDHtmlDialog CDHtmlDialog 개체를 생성 합니다.Constructs a CDHtmlDialog object.
CDHtmlDialog:: ~ CDHtmlDialogCDHtmlDialog::~CDHtmlDialog CDHtmlDialog 개체를 소멸 시킵니다.Destroys a CDHtmlDialog object.

Public 메서드Public Methods

이름Name 설명Description
CDHtmlDialog::CanAccessExternalCDHtmlDialog::CanAccessExternal 로드 된 페이지의 스크립팅 개체가 컨트롤 사이트의 외부 디스패치에 액세스할 수 있는지 여부를 확인 하기 위해 액세스 권한으로 호출 되는 Overridable입니다.Overridable that is called as an access check to see whether scripting objects on the loaded page can access the external dispatch of the control site. 디스패치가 스크립팅에 안전 하거나 현재 영역에서 스크립팅에 안전 하지 않은 개체를 허용 하는지 확인 합니다.Checks to make sure the dispatch is either safe for scripting or the current zone allows for objects that are not safe for scripting.
CDHtmlDialog:: CreateControlSiteCDHtmlDialog::CreateControlSite 대화 상자에서 WebBrowser 컨트롤을 호스트할 컨트롤 사이트 인스턴스를 만드는 데 사용 되는 재정의 가능입니다.Overridable used to create a control site instance to host the WebBrowser control on the dialog.
CDHtmlDialog::DDX_DHtml_AxControlCDHtmlDialog::DDX_DHtml_AxControl HTML 페이지에서 ActiveX 컨트롤의 속성 값과 멤버 변수 간에 데이터를 교환 합니다.Exchanges data between a member variable and the property value of an ActiveX control on an HTML page.
CDHtmlDialog::D DX_DHtml_CheckBoxCDHtmlDialog::DDX_DHtml_CheckBox 멤버 변수와 HTML 페이지의 확인란 간에 데이터를 교환 합니다.Exchanges data between a member variable and a check box on an HTML page.
CDHtmlDialog::DDX_DHtml_ElementTextCDHtmlDialog::DDX_DHtml_ElementText HTML 페이지의 멤버 변수와 HTML 요소 속성 간에 데이터를 교환 합니다.Exchanges data between a member variable and any HTML element property on an HTML page.
CDHtmlDialog::DDX_DHtml_RadioCDHtmlDialog::DDX_DHtml_Radio 멤버 변수와 HTML 페이지의 라디오 단추 간에 데이터를 교환 합니다.Exchanges data between a member variable and a radio button on an HTML page.
CDHtmlDialog::DDX_DHtml_SelectIndexCDHtmlDialog::DDX_DHtml_SelectIndex HTML 페이지의 목록 상자 인덱스를 가져오거나 설정 합니다.Gets or sets the index of a list box on an HTML page.
CDHtmlDialog::D DX_DHtml_SelectStringCDHtmlDialog::DDX_DHtml_SelectString HTML 페이지에서 현재 인덱스를 기반으로 하는 목록 상자 항목의 표시 텍스트를 가져오거나 설정 합니다.Gets or sets the display text of a list box entry (based on the current index) on an HTML page.
CDHtmlDialog::DDX_DHtml_SelectValueCDHtmlDialog::DDX_DHtml_SelectValue HTML 페이지의 현재 인덱스를 기반으로 하는 목록 상자 항목의 값을 가져오거나 설정 합니다.Gets or sets the value of a list box entry (based on the current index) on an HTML page.
CDHtmlDialog::DestroyModelessCDHtmlDialog::DestroyModeless 모덜리스 대화 상자를 소멸 시킵니다.Destroys a modeless dialog box.
CDHtmlDialog:: EnableModelessCDHtmlDialog::EnableModeless 모덜리스 대화 상자를 사용 합니다.Enables modeless dialog boxes.
CDHtmlDialog:: FilterDataObjectCDHtmlDialog::FilterDataObject 호스팅된 브라우저에서 만든 클립보드 데이터 개체를 대화 상자에서 필터링 할 수 있습니다.Allows the dialog to filter clipboard data objects created by the hosted browser.
CDHtmlDialog::GetControlDispatchCDHtmlDialog::GetControlDispatch IDispatchHTML 문서에 포함 된 ActiveX 컨트롤에서 인터페이스를 검색 합니다.Retrieves the IDispatch interface on an ActiveX control embedded in the HTML document.
CDHtmlDialog:: GetControlPropertyCDHtmlDialog::GetControlProperty 지정 된 ActiveX 컨트롤의 요청 된 속성을 검색 합니다.Retrieves the requested property of the specified ActiveX control.
CDHtmlDialog::GetCurrentUrlCDHtmlDialog::GetCurrentUrl 현재 문서와 연결 된 URL (Uniform Resource Locator)을 검색 합니다.Retrieves the Uniform Resource Locator (URL) associated with the current document.
CDHtmlDialog::GetDHtmlDocumentCDHtmlDialog::GetDHtmlDocument 현재 로드 된 HTML 문서에서 IHTMLDocument2 인터페이스를 검색 합니다.Retrieves the IHTMLDocument2 interface on the currently loaded HTML document.
CDHtmlDialog:: GetDropTargetCDHtmlDialog::GetDropTarget 대화에서 대체 IDropTarget를 제공할 수 있도록 놓기 대상으로 사용 되는 경우 포함 된 WebBrowser 컨트롤에서 호출 됩니다.Called by the contained WebBrowser control when it is being used as a drop target to allow the dialog to supply an alternative IDropTarget.
CDHtmlDialog:: GetElementCDHtmlDialog::GetElement HTML 요소에 대 한 인터페이스를 가져옵니다.Gets an interface on an HTML element.
CDHtmlDialog::GetElementHtmlCDHtmlDialog::GetElementHtml innerHTMLHTML 요소의 속성을 검색 합니다.Retrieves the innerHTML property of an HTML element.
CDHtmlDialog:: GetElementInterfaceCDHtmlDialog::GetElementInterface HTML 요소에서 요청 된 인터페이스 포인터를 검색 합니다.Retrieves the requested interface pointer from an HTML element.
CDHtmlDialog:: GetElementPropertyCDHtmlDialog::GetElementProperty HTML 요소의 속성 값을 검색 합니다.Retrieves the value of an HTML element's property.
CDHtmlDialog:: GetElementTextCDHtmlDialog::GetElementText innerTextHTML 요소의 속성을 검색 합니다.Retrieves the innerText property of an HTML element.
CDHtmlDialog::GetEventCDHtmlDialog::GetEvent IHTMLEventObj현재 이벤트 개체에 대 한 포인터를 가져옵니다.Gets the IHTMLEventObj pointer to the current event object.
CDHtmlDialog::GetExternalCDHtmlDialog::GetExternal 호스트의 인터페이스를 가져옵니다 IDispatch .Gets the host's IDispatch interface.
CDHtmlDialog:: GetHostInfoCDHtmlDialog::GetHostInfo 호스트의 UI 기능을 검색 합니다.Retrieves the host's UI capabilities.
CDHtmlDialog:: GetOptionKeyPathCDHtmlDialog::GetOptionKeyPath 사용자 기본 설정이 저장 되는 레지스트리 키를 검색 합니다.Retrieves the registry key under which user preferences are stored.
CDHtmlDialog::HideUICDHtmlDialog::HideUI 호스트의 UI를 숨깁니다.Hides the host's UI.
CDHtmlDialog:: IsExternalDispatchSafeCDHtmlDialog::IsExternalDispatchSafe 호스트의 인터페이스를 스크립팅에 안전 하 게 사용할 수 있는지 여부를 나타냅니다 IDispatch .Indicates whether the host's IDispatch interface is safe for scripting.
CDHtmlDialog:: LoadFromResourceCDHtmlDialog::LoadFromResource 지정 된 리소스를 WebBrowser 컨트롤에 로드 합니다.Loads the specified resource into the WebBrowser control.
CDHtmlDialog:: NavigateCDHtmlDialog::Navigate 지정 된 URL로 이동 합니다.Navigates to the specified URL.
CDHtmlDialog:: OnBeforeNavigateCDHtmlDialog::OnBeforeNavigate 탐색 이벤트가 발생 하기 전에 프레임 워크에서 호출 됩니다.Called by the framework before a navigation event is fired.
CDHtmlDialog:: OnDocumentCompleteCDHtmlDialog::OnDocumentComplete 문서가 READYSTATE_COMPLETE 상태에 도달 했을 때 응용 프로그램에 알리기 위해 프레임 워크에서 호출 됩니다.Called by the framework to notify an application when a document has reached the READYSTATE_COMPLETE state.
CDHtmlDialog:: OnDocWindowActivateCDHtmlDialog::OnDocWindowActivate 문서 창이 활성화 또는 비활성화 될 때 프레임 워크에서 호출 됩니다.Called by the framework when the document window is activated or deactivated.
CDHtmlDialog:: On프레임 창 활성화CDHtmlDialog::OnFrameWindowActivate 프레임 창이 활성화 또는 비활성화 될 때 프레임 워크에서 호출 됩니다.Called by the framework when the frame window is activated or deactivated.
CDHtmlDialog:: OnInitDialogCDHtmlDialog::OnInitDialog WM_INITDIALOG 메시지에 대 한 응답으로 호출 됩니다.Called in response to the WM_INITDIALOG message.
CDHtmlDialog:: OnNavigateCompleteCDHtmlDialog::OnNavigateComplete 탐색 이벤트가 완료 된 후 프레임 워크에서 호출 됩니다.Called by the framework after a navigation event is completed.
CDHtmlDialog:: ResizeBorderCDHtmlDialog::ResizeBorder 테두리 공간 크기를 조정 해야 함을 개체에 경고 합니다.Alerts the object that it needs to resize its border space.
CDHtmlDialog:: SetControlPropertyCDHtmlDialog::SetControlProperty ActiveX 컨트롤의 속성을 새 값으로 설정 합니다.Sets the property of an ActiveX control to a new value.
CDHtmlDialog:: SetElementHtmlCDHtmlDialog::SetElementHtml innerHTMLHTML 요소의 속성을 설정 합니다.Sets the innerHTML property of an HTML element.
CDHtmlDialog:: SetElementPropertyCDHtmlDialog::SetElementProperty HTML 요소의 속성을 설정 합니다.Sets a property of an HTML element.
CDHtmlDialog:: SetElementTextCDHtmlDialog::SetElementText innerTextHTML 요소의 속성을 설정 합니다.Sets the innerText property of an HTML element.
CDHtmlDialog:: SetExternalDispatchCDHtmlDialog::SetExternalDispatch 호스트의 인터페이스를 설정 IDispatch 합니다.Sets the host's IDispatch interface.
CDHtmlDialog:: SetHostFlagsCDHtmlDialog::SetHostFlags 호스트의 UI 플래그를 설정 합니다.Sets the host's UI flags.
CDHtmlDialog:: ShowContextMenuCDHtmlDialog::ShowContextMenu 상황에 맞는 메뉴가 표시 되기 전에 호출 됩니다.Called when a context menu is about to be displayed.
CDHtmlDialog:: ShowUICDHtmlDialog::ShowUI 호스트의 UI를 표시 합니다.Shows the host's UI.
CDHtmlDialog:: TranslateAcceleratorCDHtmlDialog::TranslateAccelerator 메뉴 액셀러레이터 키 메시지를 처리 하기 위해 호출 됩니다.Called to process menu accelerator-key messages.
CDHtmlDialog:: TranslateUrlCDHtmlDialog::TranslateUrl 로드할 URL을 수정 하기 위해 호출 됩니다.Called to modify the URL to be loaded.
CDHtmlDialog:: UpdateUICDHtmlDialog::UpdateUI 명령 상태가 변경 되었음을 호스트에 알리기 위해 호출 됩니다.Called to notify the host that the command state has changed.

공용 데이터 멤버Public Data Members

NameName 설명Description
CDHtmlDialog::m_bUseHtmlTitleCDHtmlDialog::m_bUseHtmlTitle HTML 문서 제목을 대화 상자 캡션으로 사용할지 여부를 나타냅니다.Indicates whether to use the HTML document's title as the dialog caption.
CDHtmlDialog::m_nHtmlResIDCDHtmlDialog::m_nHtmlResID 표시할 HTML 리소스의 리소스 ID입니다.Resource ID of HTML resource to be displayed.
CDHtmlDialog::m_pBrowserAppCDHtmlDialog::m_pBrowserApp 웹 브라우저 응용 프로그램에 대 한 포인터입니다.A pointer to a Web browser application.
CDHtmlDialog::m_spHtmlDocCDHtmlDialog::m_spHtmlDoc HTML 문서에 대 한 포인터입니다.A pointer to an HTML document.
CDHtmlDialog:: m_strCurrentUrlCDHtmlDialog::m_strCurrentUrl 현재 URL입니다.The current URL.
CDHtmlDialog:: m_szHtmlResIDCDHtmlDialog::m_szHtmlResID HTML 리소스 ID의 문자열 버전입니다.String version of the HTML resource ID.

설명Remarks

CDHtmlDialog html 리소스 또는 URL에서 표시할 HTML을 로드할 수 있습니다.CDHtmlDialog can load the HTML to be displayed from either an HTML resource or a URL.

CDHtmlDialog 는 HTML 컨트롤을 사용 하 여 데이터 교환을 수행 하 고 단추 클릭과 같은 HTML 컨트롤의 이벤트를 처리할 수도 있습니다.CDHtmlDialog can also do data exchange with HTML controls and handle events from HTML controls, such as button clicks.

상속 계층 구조Inheritance Hierarchy

CObjectCObject

CDHtmlSinkHandlerBase2

CDHtmlSinkHandlerBase1

CCmdTargetCCmdTarget

CDHtmlSinkHandler

CWndCWnd

CDHtmlEventSink

CDialogCDialog

CDHtmlDialog

요구 사항Requirements

헤더: afxdhtmlHeader: afxdhtml.h

DDX_DHtml 도우미 매크로DDX_DHtml Helper Macros

DDX_DHtml 도우미 매크로를 사용 하면 HTML 페이지에서 일반적으로 사용 되는 컨트롤 속성에 쉽게 액세스할 수 있습니다.The DDX_DHtml helper macros allow easy access to the commonly used properties of controls on an HTML page.

데이터 교환 매크로Data Exchange Macros

NameName 설명Description
DDX_DHtml_ElementValueDDX_DHtml_ElementValue 선택한 컨트롤에서 Value 속성을 설정 하거나 검색 합니다.Sets or retrieves the Value property from the selected control.
DDX_DHtml_ElementInnerTextDDX_DHtml_ElementInnerText 현재 요소의 시작 태그와 끝 태그 사이에 있는 텍스트를 설정 하거나 검색 합니다.Sets or retrieves the text between the start and end tags of the current element.
DDX_DHtml_ElementInnerHtmlDDX_DHtml_ElementInnerHtml 현재 요소의 시작 태그와 끝 태그 사이에 HTML을 설정 하거나 검색 합니다.Sets or retrieves the HTML between the start and end tags of the current element.
DDX_DHtml_Anchor_HrefDDX_DHtml_Anchor_Href 대상 URL 또는 앵커 지점을 설정 하거나 검색 합니다.Sets or retrieves the destination URL or anchor point.
DDX_DHtml_Anchor_TargetDDX_DHtml_Anchor_Target 대상 창 또는 프레임을 설정 하거나 검색 합니다.Sets or retrieves the target window or frame.
DDX_DHtml_Img_SrcDDX_DHtml_Img_Src 문서에서 이미지 또는 비디오 클립의 이름을 설정 하거나 검색 합니다.Sets or retrieves the name of an image or a video clip in the document.
DDX_DHtml_Frame_SrcDDX_DHtml_Frame_Src 연결 된 프레임의 URL을 설정 하거나 검색 합니다.Sets or retrieves the URL of the associated frame.
DDX_DHtml_IFrame_SrcDDX_DHtml_IFrame_Src 연결 된 프레임의 URL을 설정 하거나 검색 합니다.Sets or retrieves the URL of the associated frame.

CDHtmlDialog:: CanAccessExternalCDHtmlDialog::CanAccessExternal

로드 된 페이지의 스크립팅 개체가 컨트롤 사이트의 외부 디스패치에 액세스할 수 있는지 여부를 확인 하기 위해 액세스 권한으로 호출 되는 Overridable입니다.Overridable that is called as an access check to see whether scripting objects on the loaded page can access the external dispatch of the control site. 디스패치가 스크립팅에 안전 하거나 현재 영역에서 스크립팅에 안전 하지 않은 개체를 허용 하는지 확인 합니다.Checks to make sure the dispatch is either safe for scripting or the current zone allows for objects that are not safe for scripting.

virtual BOOL CanAccessExternal();

반환 값Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.Nonzero if successful; otherwise 0.

CDHtmlDialog:: CDHtmlDialogCDHtmlDialog::CDHtmlDialog

리소스 기반 동적 HTML 대화 상자를 생성 합니다.Constructs a resource-based dynamic HTML dialog box.

CDHtmlDialog();

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

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

매개 변수Parameters

lpszTemplateNamelpszTemplateName
대화 상자 템플릿 리소스의 이름인 null로 끝나는 문자열입니다.The null-terminated string that is the name of a dialog-box template resource.

szHtmlResIDszHtmlResID
HTML 리소스의 이름인 null로 끝나는 문자열입니다.The null-terminated string that is the name of an HTML resource.

pParentWndpParentWnd
Dialog 개체가 속한 부모 또는 소유자 창 개체 ( CWnd형식)에 대 한 포인터입니다.A pointer to the parent or owner window object (of type CWnd) to which the dialog object belongs. NULL 인 경우에는 대화 상자 개체의 부모 창이 주 응용 프로그램 창으로 설정 됩니다.If it is NULL, the dialog object's parent window is set to the main application window.

nIDTemplatenIDTemplate
대화 상자 템플릿 리소스의 ID 번호를 포함 합니다.Contains the ID number of a dialog-box template resource.

nHtmlResIDnHtmlResID
HTML 리소스의 ID 번호를 포함 합니다.Contains the ID number of an HTML resource.

설명Remarks

생성자의 두 번째 형태는 템플릿 이름을 통해 대화 상자 리소스에 대 한 액세스를 제공 합니다.The second form of the constructor provides access to the dialog resource through the template name. 세 번째 형식의 생성자는 리소스 템플릿의 ID를 통해 대화 상자 리소스에 대 한 액세스를 제공 합니다.The third form of the constructor provides access to the dialog resource through the ID of the resource template. 일반적으로 ID는 IDD_ 접두사로 시작 합니다.Usually, the ID begins with the IDD_ prefix.

CDHtmlDialog:: ~ CDHtmlDialogCDHtmlDialog::~CDHtmlDialog

CDHtmlDialog 개체를 소멸 시킵니다.Destroys a CDHtmlDialog object.

virtual ~CDHtmlDialog();

설명Remarks

CWnd::D estroyWindow 멤버 함수를 사용 하 여 CDialog:: Create에서 만든 모덜리스 대화 상자를 삭제 해야 합니다.The CWnd::DestroyWindow member function must be used to destroy modeless dialog boxes that are created by CDialog::Create.

CDHtmlDialog:: CreateControlSiteCDHtmlDialog::CreateControlSite

대화 상자에서 WebBrowser 컨트롤을 호스트할 컨트롤 사이트 인스턴스를 만드는 데 사용 되는 재정의 가능입니다.Overridable used to create a control site instance to host the WebBrowser control on the dialog.

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

매개 변수Parameters

pContainerpContainer
COleControlContainer 개체에 대 한 포인터입니다.A pointer to the COleControlContainer object

ppSiteppSite
COleControlSite에 대 한 포인터에 대 한 포인터입니다.A pointer to a pointer to a COleControlSite.

반환 값Return Value

성공하면 0이 아니고, 그렇지 않으면 0입니다.Nonzero if successful; otherwise 0.

설명Remarks

이 멤버 함수를 재정의 하 여 사용자 고유의 컨트롤 사이트 클래스의 인스턴스를 반환할 수 있습니다.You can override this member function to return an instance of your own control site class.

CDHtmlDialog::D DX_DHtml_AxControlCDHtmlDialog::DDX_DHtml_AxControl

HTML 페이지에서 ActiveX 컨트롤의 속성 값과 멤버 변수 간에 데이터를 교환 합니다.Exchanges data between a member variable and the property value of an ActiveX control on an HTML page.

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

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

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object.

szIdszId
ActiveX 컨트롤의 HTML 소스에 있는 개체 태그의 ID 매개 변수 값입니다.The value of the object tag's ID parameter in the HTML source for the ActiveX control.

dispIddispId
데이터를 교환 하려는 속성의 디스패치 ID입니다.The dispatch ID of the property with which you want to exchange data.

szPropNameszPropName
속성의 이름입니다.The name of the property.

varvar
ActiveX 컨트롤 속성과 교환 되는 값을 보유 하는 VARIANT, COleVariant또는 CComVariant형식의 데이터 멤버입니다.The data member, of type VARIANT, COleVariant, or CComVariant, that holds the value exchanged with the ActiveX control property.

예제Example

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

CDHtmlDialog::D DX_DHtml_CheckBoxCDHtmlDialog::DDX_DHtml_CheckBox

멤버 변수와 HTML 페이지의 확인란 간에 데이터를 교환 합니다.Exchanges data between a member variable and a check box on an HTML page.

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

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object.

szIdszId
HTML 컨트롤의 ID 매개 변수에 대해 지정한 값입니다.The value that you specified for the HTML control's ID parameter.

valuevalue
교환 되는 값입니다.The value being exchanged.

예제Example

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

CDHtmlDialog::D DX_DHtml_ElementTextCDHtmlDialog::DDX_DHtml_ElementText

HTML 페이지의 멤버 변수와 HTML 요소 속성 간에 데이터를 교환 합니다.Exchanges data between a member variable and any HTML element property on an HTML page.

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

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object.

szIdszId
HTML 컨트롤의 ID 매개 변수에 대해 지정한 값입니다.The value that you specified for the HTML control's ID parameter.

dispIddispId
데이터를 교환 하려는 HTML 요소의 디스패치 ID입니다.The dispatch ID of the HTML element with which you want to exchange data.

valuevalue
교환 되는 값입니다.The value being exchanged.

CDHtmlDialog::D DX_DHtml_RadioCDHtmlDialog::DDX_DHtml_Radio

멤버 변수와 HTML 페이지의 라디오 단추 간에 데이터를 교환 합니다.Exchanges data between a member variable and a radio button on an HTML page.

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

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object.

szIdszId
HTML 컨트롤의 ID 매개 변수에 대해 지정한 값입니다.The value that you specified for the HTML control's ID parameter.

valuevalue
교환 되는 값입니다.The value being exchanged.

CDHtmlDialog::D DX_DHtml_SelectIndexCDHtmlDialog::DDX_DHtml_SelectIndex

HTML 페이지의 목록 상자 인덱스를 가져오거나 설정 합니다.Gets or sets the index of a list box on an HTML page.

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

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object.

szIdszId
HTML 컨트롤의 매개 변수에 대해 지정한 값입니다 id .The value that you specified for the HTML control's id parameter.

valuevalue
교환 되는 값입니다.The value being exchanged.

CDHtmlDialog::D DX_DHtml_SelectStringCDHtmlDialog::DDX_DHtml_SelectString

HTML 페이지에서 현재 인덱스를 기반으로 하는 목록 상자 항목의 표시 텍스트를 가져오거나 설정 합니다.Gets or sets the display text of a list box entry (based on the current index) on an HTML page.

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

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object.

szIdszId
HTML 컨트롤의 ID 매개 변수에 대해 지정한 값입니다.The value that you specified for the HTML control's ID parameter.

valuevalue
교환 되는 값입니다.The value being exchanged.

CDHtmlDialog::D DX_DHtml_SelectValueCDHtmlDialog::DDX_DHtml_SelectValue

HTML 페이지의 현재 인덱스를 기반으로 하는 목록 상자 항목의 값을 가져오거나 설정 합니다.Gets or sets the value of a list box entry (based on the current index) on an HTML page.

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

매개 변수Parameters

pDXpDX
CDataExchange 개체에 대 한 포인터입니다.A pointer to a CDataExchange object.

szIdszId
HTML 컨트롤의 ID 매개 변수에 대해 지정한 값입니다.The value that you specified for the HTML control's ID parameter.

valuevalue
교환 되는 값입니다.The value being exchanged.

예제Example

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

CDHtmlDialog::D estroyModelessCDHtmlDialog::DestroyModeless

개체에서 모덜리스 대화 상자를 분리 CDHtmlDialog 하 고 개체를 소멸 시킵니다.Detaches a modeless dialog box from the CDHtmlDialog object and destroys the object.

void DestroyModeless();

CDHtmlDialog:: EnableModelessCDHtmlDialog::EnableModeless

모덜리스 대화 상자를 사용 합니다.Enables modeless dialog boxes.

STDMETHOD(EnableModeless)(BOOL fEnable);

매개 변수Parameters

fEnablefEnable
Windows SDK에서 Fenable in IDocHostUIHandler:: EnableModeless 를 참조 하세요.See fEnable in IDocHostUIHandler::EnableModeless in the Windows SDK.

반환 값Return Value

E_NOTIMPL을 반환합니다.Returns E_NOTIMPL.

설명Remarks

이 멤버 함수는 Windows SDK 설명 된 대로 IDocHostUIHandler:: EnableModeless의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::EnableModeless, as described in the Windows SDK.

CDHtmlDialog:: FilterDataObjectCDHtmlDialog::FilterDataObject

호스팅된 브라우저에서 만든 클립보드 데이터 개체를 대화 상자에서 필터링 할 수 있습니다.Allows the dialog to filter clipboard data objects created by the hosted browser.

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

매개 변수Parameters

pDOpDO
Windows SDK에서 PDO :: FilterDataObjectpDO 를 참조 하세요.See pDO in IDocHostUIHandler::FilterDataObject in the Windows SDK.

ppDORetppDORet
Windows SDK에서 Ppg Oret 를 참조 하십시오 IDocHostUIHandler::FilterDataObject .See ppDORet in IDocHostUIHandler::FilterDataObject in the Windows SDK.

반환 값Return Value

S_FALSE를 반환 합니다.Returns S_FALSE.

설명Remarks

이 멤버 함수는 Windows SDK 설명 된 대로 CDHtmlDialog의 IDocHostUIHandler:: FilterDataObject구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::FilterDataObject, as described in the Windows SDK.

CDHtmlDialog:: GetControlDispatchCDHtmlDialog::GetControlDispatch

GetDHtmlDocument에서 반환하는 HTML 문서에 포함된 ActiveX 컨트롤에서 인터페이스 IDispatch를 검색합니다.Retrieves the IDispatch interface on an ActiveX control embedded in the HTML document returned by GetDHtmlDocument.

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

매개 변수Parameters

szIdszId
ActiveX 컨트롤의 HTML ID입니다.The HTML ID of an ActiveX control.

ppdispppdisp
IDispatch웹 페이지에 있는 경우 컨트롤의 인터페이스입니다.The IDispatch interface of the control if found in the Web page.

반환 값Return Value

표준 HRESULT 값입니다.A standard HRESULT value.

CDHtmlDialog:: GetControlPropertyCDHtmlDialog::GetControlProperty

지정 된 ActiveX 컨트롤의 요청 된 속성을 검색 합니다.Retrieves the requested property of the specified ActiveX control.

VARIANT GetControlProperty(
    LPCTSTR szId,
    LPCTSTR szPropName);

VARIANT GetControlProperty(
    LPCTSTR szId,
    DISPID dispId);

VARIANT GetControlProperty(
    IDispatch* pdispControl,
    DISPID dispId);

매개 변수Parameters

szIdszId
ActiveX 컨트롤의 HTML ID입니다.The HTML ID of an ActiveX control.

szPropNameszPropName
현재 사용자의 기본 로캘의 속성 이름입니다.The name of a property in the default locale of the current user.

pdispControlpdispControl
IDispatchActiveX 컨트롤의 포인터입니다.The IDispatch pointer of an ActiveX control.

dispIddispId
속성의 디스패치 ID입니다.The dispatch ID of a property.

반환 값Return Value

요청 된 속성을 포함 하는 variant 이거나, 컨트롤 또는 속성을 찾을 수 없는 경우 빈 variant입니다.A variant containing the requested property or an empty variant if the control or property could not be found.

설명Remarks

오버 로드는 최하위 수준에서 가장 효율적으로 나열 됩니다.The overloads are listed from least efficient at the top to most efficient at the bottom.

CDHtmlDialog:: GetCurrentUrlCDHtmlDialog::GetCurrentUrl

현재 문서와 연결 된 URL (Uniform Resource Locator)을 검색 합니다.Retrieves the Uniform Resource Locator (URL) associated with the current document.

void GetCurrentUrl(CString& szUrl);

매개 변수Parameters

szUrlszUrl
검색할 URL을 포함 하는 CString 개체입니다.A CString object containing the URL to retrieve.

CDHtmlDialog:: GetDHtmlDocumentCDHtmlDialog::GetDHtmlDocument

현재 로드 된 HTML 문서에서 IHTMLDocument2 인터페이스를 검색 합니다.Retrieves the IHTMLDocument2 interface on the currently loaded HTML document.

HRESULT GetDHtmlDocument(IHTMLDocument2 **pphtmlDoc);

매개 변수Parameters

HTML 문서에 대 한 포인터에 포인터를 * * * pphtmlDoc* 합니다.**pphtmlDoc A pointer to a pointer to an HTML document.

반환 값Return Value

표준 HRESULT입니다.A standard HRESULT. 성공 하면 S_OK을 반환 합니다.Returns S_OK if successful.

CDHtmlDialog:: GetDropTargetCDHtmlDialog::GetDropTarget

대화에서 대체 IDropTarget를 제공할 수 있도록 놓기 대상으로 사용 되는 경우 포함 된 WebBrowser 컨트롤에서 호출 됩니다.Called by the contained WebBrowser control when it is being used as a drop target to allow the dialog to supply an alternative IDropTarget.

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

매개 변수Parameters

pDropTargetpDropTarget
Windows SDK에서 IDocHostUIHandler:: GetDropTargetpdroptarget 을 참조 하세요.See pDropTarget in IDocHostUIHandler::GetDropTarget in the Windows SDK.

ppDropTargetppDropTarget
Windows SDK의 Ppdroptarget 을 참조 하십시오 IDocHostUIHandler::GetDropTarget .See ppDropTarget in IDocHostUIHandler::GetDropTarget in the Windows SDK.

반환 값Return Value

E_NOTIMPL을 반환합니다.Returns E_NOTIMPL.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 IDocHostUIHandler:: GetDropTarget의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::GetDropTarget, as described in the Windows SDK.

CDHtmlDialog:: GetElementCDHtmlDialog::GetElement

Szelementid로 지정 된 HTML 요소에 대 한 인터페이스를 반환 합니다.Returns an interface on the HTML element specified by szElementId.

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

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

매개 변수Parameters

szElementIdszElementId
HTML 요소의 ID입니다.The ID of an HTML element.

ppdispppdisp
IDispatch요청 된 요소 또는 요소 컬렉션에 대 한 포인터입니다.An IDispatch pointer to the requested element or collection of elements.

pbCollectionpbCollection
Ppdisp 가 나타내는 개체가 단일 요소 인지 아니면 요소의 컬렉션 인지를 나타내는 부울입니다.A BOOL indicating whether the object represented by ppdisp is a single element or a collection of elements.

pphtmlElementpphtmlElement
IHTMLElement요청 된 요소에 대 한 포인터입니다.An IHTMLElement pointer to the requested element.

반환 값Return Value

표준 HRESULT 값입니다.A standard HRESULT value.

설명Remarks

지정 된 ID를 가진 둘 이상의 요소가 있을 수 있는 조건을 처리 해야 하는 경우 첫 번째 오버 로드를 사용 합니다.Use the first overload if you need to handle conditions in which there may be more than one element with the specified ID. 마지막 매개 변수를 사용 하 여 반환 된 인터페이스 포인터가 컬렉션 또는 단일 항목에 대 한 것인지 여부를 확인할 수 있습니다.You can use the last parameter to find out whether the returned interface pointer is to a collection or a single item. 인터페이스 포인터가 컬렉션에 있는 경우를 쿼리하고 IHTMLElementCollection 해당 속성을 사용 item 하 여 서 수 위치로 요소를 참조할 수 있습니다.If the interface pointer is on a collection, you can query for the IHTMLElementCollection and use its item property to refer to the elements by ordinal position.

페이지에 동일한 ID를 가진 요소가 둘 이상 있으면 두 번째 오버 로드가 실패 합니다.The second overload will fail if there is more than one element with the same ID in the page.

CDHtmlDialog:: GetElementHtmlCDHtmlDialog::GetElementHtml

innerHTML Szelementid로 식별 되는 HTML 요소의 속성을 검색 합니다.Retrieves the innerHTML property of the HTML element identified by szElementId.

BSTR GetElementHtml(LPCTSTR szElementId);

매개 변수Parameters

szElementIdszElementId
HTML 요소의 ID입니다.The ID of an HTML element.

반환 값Return Value

innerHTML Szelementid 또는 NULL (요소를 찾을 수 없는 경우)로 식별 되는 HTML 요소의 속성입니다.The innerHTML property of the HTML element identified by szElementId or NULL if the element could not be found.

CDHtmlDialog:: GetElementInterfaceCDHtmlDialog::GetElementInterface

Szelementid로 식별 되는 HTML 요소에서 요청 된 인터페이스 포인터를 검색 합니다.Retrieves the requested interface pointer from the HTML element identified by szElementId.

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

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

매개 변수Parameters

szElementIdszElementId
HTML 요소의 ID입니다.The ID of an HTML element.

ppvObjppvObj
요소를 찾아 쿼리가 성공 하면 요청 된 인터페이스 포인터로 채워질 포인터의 주소입니다.Address of a pointer that will be filled with the requested interface pointer if the element is found and the query succeeds.

refiidrefiid
요청 된 인터페이스의 IID (인터페이스 ID)입니다.The interface ID (IID) of the requested interface.

반환 값Return Value

표준 HRESULT 값입니다.A standard HRESULT value.

예제Example

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:: GetElementPropertyCDHtmlDialog::GetElementProperty

Szelementid로 식별 되는 HTML 요소에서 dispId 로 식별 된 속성의 값을 검색 합니다.Retrieves the value of the property identified by dispId from the HTML element identified by szElementId.

VARIANT GetElementProperty(
    LPCTSTR szElementId,
    DISPID dispId);

매개 변수Parameters

szElementIdszElementId
HTML 요소의 ID입니다.The ID of an HTML element.

dispIddispId
속성의 디스패치 ID입니다.The dispatch ID of a property.

반환 값Return Value

속성 또는 요소를 찾을 수 없는 경우 속성의 값 또는 빈 variant입니다.The value of the property or an empty variant if the property or element could not be found.

CDHtmlDialog:: GetElementTextCDHtmlDialog::GetElementText

innerText Szelementid로 식별 되는 HTML 요소의 속성을 검색 합니다.Retrieves the innerText property of the HTML element identified by szElementId.

BSTR GetElementText(LPCTSTR szElementId);

매개 변수Parameters

szElementIdszElementId
HTML 요소의 ID입니다.The ID of an HTML element.

반환 값Return Value

innerText Szelementid 또는 NULL로 식별 되는 HTML 요소의 속성 이거나, 속성 또는 요소를 찾을 수 없는 경우 NULL입니다.The innerText property of the HTML element identified by szElementId or NULL if the property or element could not be found.

CDHtmlDialog:: GetEventCDHtmlDialog::GetEvent

IHTMLEventObj현재 이벤트 개체에 대 한 포인터를 반환 합니다.Returns the IHTMLEventObj pointer to the current event object.

HRESULT GetEvent(IHTMLEventObj** ppEventObj);

매개 변수Parameters

ppEventObjppEventObj
인터페이스 포인터로 채워질 포인터의 주소입니다 IHTMLEventObj .Address of a pointer that will be filled with the IHTMLEventObj interface pointer.

반환 값Return Value

표준 HRESULT 값입니다.A standard HRESULT value.

설명Remarks

이 함수는 DHTML 이벤트 처리기 내 에서만 호출 해야 합니다.This function should only be called from within a DHTML event handler.

CDHtmlDialog:: GetExternalCDHtmlDialog::GetExternal

호스트의 인터페이스를 가져옵니다 IDispatch .Gets the host's IDispatch interface.

STDMETHOD(GetExternal)(IDispatch** ppDispatch);

매개 변수Parameters

ppDispatchppDispatch
Windows SDK에서 IDocHostUIHandler:: GetExternalppdispatch 를 참조 하세요.See ppDispatch in IDocHostUIHandler::GetExternal in the Windows SDK.

반환 값Return Value

성공 시 S_OK 또는 실패 시 E_NOTIMPL을 반환 합니다.Returns S_OK on success or E_NOTIMPL on failure.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 CDHtmlDialog의 IDocHostUIHandler:: GetExternal구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::GetExternal, as described in the Windows SDK.

CDHtmlDialog:: GetHostInfoCDHtmlDialog::GetHostInfo

호스트의 UI 기능을 검색 합니다.Retrieves the host's UI capabilities.

STDMETHOD(GetHostInfo)(DOCHOSTUIINFO* pInfo);

매개 변수Parameters

pInfopInfo
Windows SDK에서 PinfoIDocHostUIHandler:: GetHostInfo 을 참조 하세요.See pInfo in IDocHostUIHandler::GetHostInfo in the Windows SDK.

반환 값Return Value

S_OK를 반환 합니다.Returns S_OK.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 IDocHostUIHandler:: GetHostInfo의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::GetHostInfo, as described in the Windows SDK.

CDHtmlDialog:: GetOptionKeyPathCDHtmlDialog::GetOptionKeyPath

사용자 기본 설정이 저장 되는 레지스트리 키를 검색 합니다.Retrieves the registry key under which user preferences are stored.

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

매개 변수Parameters

pchKeypchKey
Windows SDK에서 PchkeyIDocHostUIHandler:: GetOptionKeyPath 을 참조 하세요.See pchKey in IDocHostUIHandler::GetOptionKeyPath in the Windows SDK.

dwdw
Windows SDK에서 dw 를 참조 IDocHostUIHandler::GetOptionKeyPath 하세요.See dw in IDocHostUIHandler::GetOptionKeyPath in the Windows SDK.

반환 값Return Value

E_NOTIMPL을 반환합니다.Returns E_NOTIMPL.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 IDocHostUIHandler:: GetOptionKeyPath의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::GetOptionKeyPath, as described in the Windows SDK.

CDHtmlDialog:: HideUICDHtmlDialog::HideUI

호스트의 UI를 숨깁니다.Hides the host's UI.

STDMETHOD(HideUI)(void);

반환 값Return Value

E_NOTIMPL을 반환합니다.Returns E_NOTIMPL.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 IDocHostUIHandler:: HideUI의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::HideUI, as described in the Windows SDK.

CDHtmlDialog:: IsExternalDispatchSafeCDHtmlDialog::IsExternalDispatchSafe

호스트의 인터페이스를 스크립팅에 안전 하 게 사용할 수 있는지 여부를 나타냅니다 IDispatch .Indicates whether the host's IDispatch interface is safe for scripting.

virtual BOOL IsExternalDispatchSafe();

반환 값Return Value

FALSE를 반환 합니다.Returns FALSE.

CDHtmlDialog:: LoadFromResourceCDHtmlDialog::LoadFromResource

DHTML 대화 상자의 WebBrowser 컨트롤에 지정 된 리소스를 로드 합니다.Loads the specified resource into the WebBrowser control in the DHTML dialog.

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

매개 변수Parameters

lpszResourcelpszResource
로드할 리소스의 이름을 포함 하는 문자열에 대 한 포인터입니다.A pointer to a string containing the name of the resource to load.

nResnRes
로드할 리소스의 ID입니다.The ID of the resource to load.

반환 값Return Value

성공하면 TRUE이고, 실패하면 FALSE입니다.TRUE if successful; otherwise FALSE.

CDHtmlDialog:: m_bUseHtmlTitleCDHtmlDialog::m_bUseHtmlTitle

HTML 문서 제목을 대화 상자 캡션으로 사용할지 여부를 나타냅니다.Indicates whether to use the HTML document's title as the dialog caption.

BOOL m_bUseHtmlTitle;

설명Remarks

M_ busehtmltitle 이 TRUE 이면 대화 상자 캡션이 HTML 문서의 제목과 동일 하 게 설정 됩니다. 그렇지 않으면 대화 상자 리소스의 캡션이 사용 됩니다.If m_ bUseHtmlTitle is TRUE, the dialog caption is set equal to the title of the HTML document; otherwise, the caption in the dialog resource is used.

CDHtmlDialog:: m_nHtmlResIDCDHtmlDialog::m_nHtmlResID

표시할 HTML 리소스의 리소스 ID입니다.Resource ID of HTML resource to be displayed.

UINT m_nHtmlResID;

예제Example

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

CDHtmlDialog:: m_pBrowserAppCDHtmlDialog::m_pBrowserApp

웹 브라우저 응용 프로그램에 대 한 포인터입니다.A pointer to a Web browser application.

CComPtr <IWebBrowser2> m_pBrowserApp;

CDHtmlDialog:: m_spHtmlDocCDHtmlDialog::m_spHtmlDoc

HTML 문서에 대 한 포인터입니다.A pointer to an HTML document.

CComPtr<IHTMLDocument2> m_spHtmlDoc;

CDHtmlDialog:: m_strCurrentUrlCDHtmlDialog::m_strCurrentUrl

현재 URL입니다.The current URL.

CString m_strCurrentUrl;

CDHtmlDialog:: m_szHtmlResIDCDHtmlDialog::m_szHtmlResID

HTML 리소스 ID의 문자열 버전입니다.String version of the HTML resource ID.

LPTSTR m_szHtmlResID;

예제Example

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

CDHtmlDialog:: NavigateCDHtmlDialog::Navigate

LpszURL에 지정 된 URL로 식별 되는 리소스로 이동 합니다.Navigates to the resource identified by the URL that is specified by lpszURL.

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

매개 변수Parameters

lpszURLlpszURL
대상으로 지정할 URL을 포함 하는 문자열에 대 한 포인터입니다.A pointer to a string containing the URL to be targeted.

dwFlagsdwFlags
기록 목록에 리소스를 추가할지 여부를 지정 하는 변수의 플래그, 캐시에 대 한 읽기 또는 캐시에서 쓰기, 새 창에 리소스를 표시할지 여부를 지정 하는 변수의 플래그입니다.The flags of a variable that specifies whether to add the resource to the history list, whether to read to the cache or write from the cache, and whether to display the resource in a new window. 변수는 BrowserNavConstants 열거형에 정의 된 값의 조합일 수 있습니다.The variable can be a combination of the values defined by the BrowserNavConstants enumeration.

lpszTargetFrameNamelpszTargetFrameName
리소스를 표시할 프레임의 이름을 포함 하는 문자열에 대 한 포인터입니다.A pointer to a string that contains the name of the frame in which to display the resource.

lpszHeaderslpszHeaders
서버에 보낼 HTTP 헤더를 지정 하는 값에 대 한 포인터입니다.A pointer to a value that specifies the HTTP headers to send to the server. 이러한 헤더는 기본 Internet Explorer 헤더에 추가 됩니다.These headers are added to the default Internet Explorer headers. 헤더는 서버에 필요한 작업, 서버로 전달 되는 데이터 형식 또는 상태 코드와 같은 정보를 지정할 수 있습니다.The headers can specify such information as the action required of the server, the type of data being passed to the server, or a status code. URL이 HTTP URL이 아니면이 매개 변수는 무시 됩니다.This parameter is ignored if the URL is not an HTTP URL.

lpvPostDatalpvPostData
HTTP POST 트랜잭션과 함께 보낼 데이터에 대 한 포인터입니다.A pointer to the data to send with the HTTP POST transaction. 예를 들어 POST 트랜잭션은 HTML 폼에 의해 수집 된 데이터를 전송 하는 데 사용 됩니다.For example, the POST transaction is used to send data gathered by an HTML form. 이 매개 변수가 post 데이터를 지정 하지 않으면에서 Navigate HTTP GET 트랜잭션을 발급 합니다.If this parameter does not specify any post data, Navigate issues an HTTP GET transaction. URL이 HTTP URL이 아니면이 매개 변수는 무시 됩니다.This parameter is ignored if the URL is not an HTTP URL.

dwPostDataLendwPostDataLen
HTTP POST 트랜잭션과 함께 보낼 데이터입니다.Data to send with the HTTP POST transaction. 예를 들어 POST 트랜잭션은 HTML 폼에 의해 수집 된 데이터를 전송 하는 데 사용 됩니다.For example, the POST transaction is used to send data gathered by an HTML form. 이 매개 변수가 post 데이터를 지정 하지 않으면에서 Navigate HTTP GET 트랜잭션을 발급 합니다.If this parameter does not specify any post data, Navigate issues an HTTP GET transaction. URL이 HTTP URL이 아니면이 매개 변수는 무시 됩니다.This parameter is ignored if URL is not an HTTP URL.

CDHtmlDialog:: OnBeforeNavigateCDHtmlDialog::OnBeforeNavigate

탐색이 발생 하기 전에 이벤트를 발생 시키는 프레임 워크에서 호출 됩니다.Called by the framework to cause an event to fire before a navigation occurs.

virtual void OnBeforeNavigate(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

매개 변수Parameters

pDisppDisp
IDispatch 개체에 대한 포인터입니다.A pointer to an IDispatch object.

szUrlszUrl
탐색할 URL을 포함 하는 문자열에 대 한 포인터입니다.A pointer to a string containing the URL to navigate to.

CDHtmlDialog:: OnDocumentCompleteCDHtmlDialog::OnDocumentComplete

문서에서 READYSTATE_COMPLETE 상태를 달성 했을 때 응용 프로그램에 알리기 위해 프레임 워크에서 호출 됩니다.Called by the framework to notify an application when a document has achieved the READYSTATE_COMPLETE state.

virtual void OnDocumentComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

매개 변수Parameters

pDisppDisp
IDispatch 개체에 대한 포인터입니다.A pointer to an IDispatch object.

szUrlszUrl
탐색 한 URL을 포함 하는 문자열에 대 한 포인터입니다.A pointer to a string containing the URL that was navigated to.

CDHtmlDialog:: OnDocWindowActivateCDHtmlDialog::OnDocWindowActivate

문서 창이 활성화 또는 비활성화 될 때 프레임 워크에서 호출 됩니다.Called by the framework when the document window is activated or deactivated.

STDMETHOD(OnDocWindowActivate)(BOOL fActivate);

매개 변수Parameters

fActivatefActivate
Windows SDK에서 Factivate in IDocHostUIHandler:: ondocwindowactivate in을 참조 하세요.See fActivate in IDocHostUIHandler::OnDocWindowActivate in the Windows SDK.

반환 값Return Value

E_NOTIMPL을 반환합니다.Returns E_NOTIMPL.

설명Remarks

이 멤버 함수는 Windows SDK 설명 된 대로 IDocHostUIHandler:: OnDocWindowActivate의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::OnDocWindowActivate, as described in the Windows SDK.

CDHtmlDialog:: On프레임 창 활성화CDHtmlDialog::OnFrameWindowActivate

프레임 창이 활성화 또는 비활성화 될 때 프레임 워크에서 호출 됩니다.Called by the framework when the frame window is activated or deactivated.

STDMETHOD(OnFrameWindowActivate)(BOOL fActivate);

매개 변수Parameters

fActivatefActivate
Windows SDK에서 Factivate in IDocHostUIHandler:: onframewindowactivate in을 참조 하세요.See fActivate in IDocHostUIHandler::OnFrameWindowActivate in the Windows SDK.

반환 값Return Value

E_NOTIMPL을 반환합니다.Returns E_NOTIMPL.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 IDocHostUIHandler:: OnCDHtmlDialog Windowactivate의 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::OnFrameWindowActivate, as described in the Windows SDK.

CDHtmlDialog:: OnInitDialogCDHtmlDialog::OnInitDialog

WM_INITDIALOG 메시지에 대 한 응답으로 호출 됩니다.Called in response to the WM_INITDIALOG message.

virtual BOOL OnInitDialog();

반환 값Return Value

기본 구현에서는 TRUE를 반환 합니다.The default implementation returns TRUE.

설명Remarks

이 메시지는 Create CreateIndirect DoModal 대화 상자가 표시 되기 직전에 발생 하는, 또는 호출 중에 대화 상자에 전송 됩니다.This message is sent to the dialog box during the Create, CreateIndirect, or DoModal calls, which occur immediately before the dialog box is displayed.

대화 상자가 초기화 될 때 특수 처리를 수행 해야 하는 경우이 멤버 함수를 재정의 합니다.Override this member function if you need to perform special processing when the dialog box is initialized. 재정의 된 버전에서 먼저 기본 클래스를 호출 OnInitDialog 하지만 해당 반환 값은 무시 합니다.In the overridden version, first call the base class OnInitDialog but disregard its return value. 일반적으로 재정의 된 멤버 함수에서 TRUE를 반환 합니다.You will normally return TRUE from your overridden member function.

Windows에서는 OnInitDialog 메시지 맵을 통해서가 아니라 모든 MFC 라이브러리 대화 상자에 공통 된 표준 전역 대화 상자 프로시저를 통해 함수를 호출 하므로이 멤버 함수에 대 한 메시지 맵 항목은 필요 하지 않습니다.Windows calls the OnInitDialog function through the standard global dialog-box procedure common to all Microsoft Foundation Class Library dialog boxes, rather than through your message map, so you do not need a message-map entry for this member function.

CDHtmlDialog:: OnNavigateCompleteCDHtmlDialog::OnNavigateComplete

지정 된 URL에 대 한 탐색이 완료 된 후 프레임 워크에서 호출 됩니다.Called by the framework after navigation to the specified URL is completed.

virtual void OnNavigateComplete(
    LPDISPATCH pDisp,
    LPCTSTR szUrl);

매개 변수Parameters

pDisppDisp
IDispatch 개체에 대한 포인터입니다.A pointer to an IDispatch object.

szUrlszUrl
탐색 한 URL을 포함 하는 문자열에 대 한 포인터입니다.A pointer to a string containing the URL that was navigated to.

CDHtmlDialog:: ResizeBorderCDHtmlDialog::ResizeBorder

테두리 공간 크기를 조정 해야 함을 개체에 경고 합니다.Alerts the object that it needs to resize its border space.

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

매개 변수Parameters

prcBorderprcBorder
Windows SDK에서 Prcborder in IDocHostUIHandler:: ResizeBorder 를 참조 하세요.See prcBorder in IDocHostUIHandler::ResizeBorder in the Windows SDK.

pUIWindowpUIWindow
Windows SDK에서 pUIWindow 을 참조 IDocHostUIHandler::ResizeBorder 하세요.See pUIWindow in IDocHostUIHandler::ResizeBorder in the Windows SDK.

fFrameWindowfFrameWindow
Windows SDK의에서 Ffewindow 을 참조 하세요 IDocHostUIHandler::ResizeBorder .See fFrameWindow in IDocHostUIHandler::ResizeBorder in the Windows SDK.

반환 값Return Value

E_NOTIMPL을 반환합니다.Returns E_NOTIMPL.

CDHtmlDialog:: SetControlPropertyCDHtmlDialog::SetControlProperty

ActiveX 컨트롤의 속성을 새 값으로 설정 합니다.Sets the property of an ActiveX control to a new value.

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

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

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

매개 변수Parameters

szElementIdszElementId
ActiveX 컨트롤의 HTML ID입니다.The HTML ID of an ActiveX control.

dispIddispId
설정할 속성의 디스패치 ID입니다.The dispatch ID of the property to set.

pVarpVar
새 속성 값을 포함 하는 변형에 대 한 포인터입니다.Pointer to a VARIANT containing the new property value.

pdispControlpdispControl
ActiveX 컨트롤의 인터페이스에 대 한 포인터 IDispatch 입니다.Pointer to an ActiveX control's IDispatch interface.

szPropNameszPropName
설정할 속성의 이름을 포함 하는 문자열입니다.String containing the name of the property to set.

CDHtmlDialog:: SetElementHtmlCDHtmlDialog::SetElementHtml

innerHTMLHTML 요소의 속성을 설정 합니다.Sets the innerHTML property of an HTML element.

void SetElementHtml(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementHtml(
    IUnknown* punkElem,
    BSTR bstrText);

매개 변수Parameters

szElementIdszElementId
HTML 요소의 ID입니다.The ID of an HTML element.

bstrTextbstrText
innerHTML 속성의 새 값입니다.The new value of the innerHTML property.

punkElempunkElem
IUnknownHTML 요소의 포인터입니다.The IUnknown pointer of an HTML element.

CDHtmlDialog:: SetElementPropertyCDHtmlDialog::SetElementProperty

HTML 요소의 속성을 설정 합니다.Sets a property of an HTML element.

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

매개 변수Parameters

szElementIdszElementId
HTML 요소의 ID입니다.The ID of an HTML element.

dispIddispId
설정할 속성의 디스패치 ID입니다.The dispatch ID of the property to set.

pVarpVar
속성의 새 값입니다.The new value of the property.

CDHtmlDialog:: SetElementTextCDHtmlDialog::SetElementText

innerTextHTML 요소의 속성을 설정 합니다.Sets the innerText property of an HTML element.

void SetElementText(
    LPCTSTR szElementId,
    BSTR bstrText);

void SetElementText(
    IUnknown* punkElem,
    BSTR bstrText);

매개 변수Parameters

szElementIdszElementId
HTML 요소의 ID입니다.The ID of an HTML element.

bstrTextbstrText
innerText 속성의 새 값입니다.The new value of the innerText property.

punkElempunkElem
IUnknownHTML 요소의 포인터입니다.The IUnknown pointer of an HTML element.

CDHtmlDialog:: SetExternalDispatchCDHtmlDialog::SetExternalDispatch

호스트의 인터페이스를 설정 IDispatch 합니다.Sets the host's IDispatch interface.

void SetExternalDispatch(IDispatch* pdispExternal);

매개 변수Parameters

pdispExternalpdispExternal
IDispatch 인터페이스입니다.The new IDispatch interface.

CDHtmlDialog:: SetHostFlagsCDHtmlDialog::SetHostFlags

호스트 UI 플래그를 설정 합니다.Sets the host UI flags.

void SetHostFlags(DWORD dwFlags);

매개 변수Parameters

dwFlagsdwFlags
가능한 값은 Windows SDK에서 DOCHOSTUIFLAG 을 참조 하세요.For possible values, see DOCHOSTUIFLAG in the Windows SDK.

CDHtmlDialog:: ShowContextMenuCDHtmlDialog::ShowContextMenu

상황에 맞는 메뉴가 표시 되기 전에 호출 됩니다.Called when a context menu is about to be displayed.

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

매개 변수Parameters

dwIDdwID
Windows SDK에서 IDocHostUIHandler:: ShowContextMenuewid 를 참조 하세요.See dwID in IDocHostUIHandler::ShowContextMenu in the Windows SDK.

.pptppt
Windows SDK의 ppt 를 참조 IDocHostUIHandler::ShowContextMenu 하세요.See ppt in IDocHostUIHandler::ShowContextMenu in the Windows SDK.

pcmdtReservedpcmdtReserved
Windows SDK의 Pcmdtreserved 을 참조 하세요 IDocHostUIHandler::ShowContextMenu .See pcmdtReserved in IDocHostUIHandler::ShowContextMenu in the Windows SDK.

pdispReservedpdispReserved
Windows SDK에서 pdispReserved 을 참조 IDocHostUIHandler::ShowContextMenu 하세요.See pdispReserved in IDocHostUIHandler::ShowContextMenu in the Windows SDK.

반환 값Return Value

S_FALSE를 반환 합니다.Returns S_FALSE.

설명Remarks

이 멤버 함수는 Windows SDK 설명 된 대로 CDHtmlDialog의 IDocHostUIHandler:: ShowContextMenu구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::ShowContextMenu, as described in the Windows SDK.

CDHtmlDialog:: ShowUICDHtmlDialog::ShowUI

호스트의 UI를 표시 합니다.Shows the host's UI.

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

매개 변수Parameters

dwIDdwID
Windows SDK에서 IDocHostUIHandler:: ShowUI 의 d wid 를 참조 하세요.See dwID in IDocHostUIHandler::ShowUI in the Windows SDK.

pActiveObjectpActiveObject
Windows SDK의에서 d pActiveObject 를 참조 하십시오 IDocHostUIHandler::ShowUI .See d pActiveObject in IDocHostUIHandler::ShowUI in the Windows SDK.

pCommandTargetpCommandTarget
Windows SDK에서 Pcommandtarget 을 참조 하십시오 IDocHostUIHandler::ShowUI .See pCommandTarget in IDocHostUIHandler::ShowUI in the Windows SDK.

pFramepFrame
Windows SDK에서 Pframe 을 참조 하십시오 IDocHostUIHandler::ShowUI .See pFrame in IDocHostUIHandler::ShowUI in the Windows SDK.

pDocpDoc
Windows SDK에서 Pdoc in을 참조 IDocHostUIHandler::ShowUI 하세요.See pDoc in IDocHostUIHandler::ShowUI in the Windows SDK.

반환 값Return Value

S_FALSE를 반환 합니다.Returns S_FALSE.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 IDocHostUIHandler:: ShowUI의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::ShowUI, as described in the Windows SDK.

CDHtmlDialog:: TranslateAcceleratorCDHtmlDialog::TranslateAccelerator

메뉴 액셀러레이터 키 메시지를 처리 하기 위해 호출 됩니다.Called to process menu accelerator-key messages.

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

매개 변수Parameters

lpMsglpMsg
Windows SDK에서 Lpmsg in IDocHostUIHandler:: TranslateAccelerator 을 참조 하세요.See lpMsg in IDocHostUIHandler::TranslateAccelerator in the Windows SDK.

pguidCmdGrouppguidCmdGroup
Windows SDK에서 pguidCmdGroup 을 참조 IDocHostUIHandler::TranslateAccelerator 하세요.See pguidCmdGroup in IDocHostUIHandler::TranslateAccelerator in the Windows SDK.

nCmdIDnCmdID
Windows SDK에서 Ncmdid 를 참조 하세요 IDocHostUIHandler::TranslateAccelerator .See nCmdID in IDocHostUIHandler::TranslateAccelerator in the Windows SDK.

반환 값Return Value

S_FALSE를 반환 합니다.Returns S_FALSE.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 IDocHostUIHandler:: TranslateAccelerator의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::TranslateAccelerator, as described in the Windows SDK.

CDHtmlDialog:: TranslateUrlCDHtmlDialog::TranslateUrl

로드할 URL을 수정 하기 위해 호출 됩니다.Called to modify the URL to be loaded.

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

매개 변수Parameters

dwTranslatedwTranslate
Windows SDK에서 Dwtranslate in IDocHostUIHandler:: TranslateUrl 를 참조 하세요.See dwTranslate in IDocHostUIHandler::TranslateUrl in the Windows SDK.

pchURLInpchURLIn
Windows SDK의에서 Pchurlin 을 참조 하세요 IDocHostUIHandler::TranslateUrl .See pchURLIn in IDocHostUIHandler::TranslateUrl in the Windows SDK.

ppchURLOutppchURLOut
Windows SDK의 Ppchurlout 를 참조 IDocHostUIHandler::TranslateUrl 하세요.See ppchURLOut in IDocHostUIHandler::TranslateUrl in the Windows SDK.

반환 값Return Value

S_FALSE를 반환 합니다.Returns S_FALSE.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 IDocHostUIHandler:: TranslateUrl의 CDHtmlDialog 구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::TranslateUrl, as described in the Windows SDK.

CDHtmlDialog:: UpdateUICDHtmlDialog::UpdateUI

명령 상태가 변경 되었음을 호스트에 알리기 위해 호출 됩니다.Called to notify the host that the command state has changed.

STDMETHOD(UpdateUI)(void);

반환 값Return Value

E_NOTIMPL을 반환합니다.Returns E_NOTIMPL.

설명Remarks

이 멤버 함수는 Windows SDK에 설명 된 대로 CDHtmlDialog의 IDocHostUIHandler:: UpdateUI구현입니다.This member function is CDHtmlDialog's implementation of IDocHostUIHandler::UpdateUI, as described in the Windows SDK.

참고 항목See also

MFC 샘플MFC Sample DHtmlExplore
DDX_DHtml 도우미 매크로DDX_DHtml Helper Macros
계층 구조 차트Hierarchy Chart