DDX_DHtml Helper Macros
The DDX_DHtml helper macros allow easy access to the commonly used properties of controls on an HTML page.
Data Exchange Macros
| Name | Description |
|---|---|
| DDX_DHtml_ElementValue | Sets or retrieves the Value property from the selected control. |
| DDX_DHtml_ElementInnerText | Sets or retrieves the text between the start and end tags of the current element. |
| DDX_DHtml_ElementInnerHtml | Sets or retrieves the HTML between the start and end tags of the current element. |
| DDX_DHtml_Anchor_Href | Sets or retrieves the destination URL or anchor point. |
| DDX_DHtml_Anchor_Target | Sets or retrieves the target window or frame. |
| DDX_DHtml_Img_Src | Sets or retrieves the name of an image or a video clip in the document. |
| DDX_DHtml_Frame_Src | Sets or retrieves the URL of the associated frame. |
| DDX_DHtml_IFrame_Src | Sets or retrieves the URL of the associated frame. |
Requirements
Header: afxdhtml.h
DDX_DHtml_Anchor_Href
Sets or retrieves the destination URL or anchor point.
DDX_DHtml_Anchor_Href(
CDataExchange* dx,
LPCTSTR name,
CString& var)
Parameters
dx
A pointer to a CDataExchange object.
name
The value that you specified for the HTML control's ID parameter.
var
The value being exchanged.
Remarks
This macro calls the CDHtmlDialog::DDX_DHtml_ElementText function using the DISPID_IHTMLANCHORELEMENT_HREF dispatch ID.
DDX_DHtml_Anchor_Target
Sets or retrieves the target window or frame.
DDX_DHtml_Anchor_Target(
CDataExchange* dx,
LPCTSTR name,
CString& var)
Parameters
dx
A pointer to a CDataExchange object.
name
The value that you specified for the HTML control's ID parameter.
var
The value being exchanged.
Remarks
This macro calls the CDHtmlDialog::DDX_DHtml_ElementText function using the DISPID_IHTMLANCHORELEMENT_TARGET dispatch ID.
DDX_DHtml_ElementInnerHtml
Sets or retrieves the HTML between the start and end tags of the current element.
DDX_DHtml_ElementInnerHtml(
CDataExchange* dx,
LPCTSTR name,
CString& var)
Parameters
dx
A pointer to a CDataExchange object.
name
The value that you specified for the HTML control's ID parameter.
var
The value being exchanged.
Remarks
This macro calls the CDHtmlDialog::DDX_DHtml_ElementText function using the DISPID_IHTMLELEMENT_INNERHTML dispatch ID.
DDX_DHtml_ElementInnerText
Sets or retrieves the text between the start and end tags of the current element.
DDX_DHtml_ElementInnerText(
CDataExchange* dx,
LPCTSTR name,
CString& var)
Parameters
dx
A pointer to a CDataExchange object.
name
The value that you specified for the HTML control's ID parameter.
var
The value being exchanged.
Remarks
This macro calls the CDHtmlDialog::DDX_DHtml_ElementText function using the DISPID_IHTMLELEMENT_INNERTEXT dispatch ID.
DDX_DHtml_ElementValue
Sets or retrieves the Value property from the selected control.
DDX_DHtml_ElementValue(
CDataExchange* dx,
LPCTSTR name,
var)
Parameters
dx
A pointer to a CDataExchange object.
name
The value that you specified for the HTML control's ID parameter.
var
The value being exchanged. See value in CDHtmlDialog::DDX_DHtml_ElementText.
Remarks
This macro will only succeed when run on controls that have a Value property. Controls that have a Value property include edit boxes, list boxes, and combo boxes.
This macro calls the CDHtmlDialog::DDX_DHtml_ElementText function using the DISPID_A_VALUE dispatch ID.
DDX_DHtml_Frame_Src
Sets or retrieves the URL of the associated frame.
DDX_DHtml_Frame_Src(
CDataExchange* dx,
LPCTSTR name,
CString& var)
Parameters
dx
A pointer to a CDataExchange object.
name
The value that you specified for the HTML control's ID parameter.
var
The value being exchanged.
Remarks
This macro calls the CDHtmlDialog::DDX_DHtml_ElementText function using the DISPID_IHTMLFRAMEBASE_SRC dispatch ID.
DDX_DHtml_IFrame_Src
Sets or retrieves the URL of the associated frame.
DDX_DHtml_IFrame_Src(
CDataExchange* dx,
LPCTSTR name,
CString& var)
Parameters
dx
A pointer to a CDataExchange object.
name
The value that you specified for the HTML control's ID parameter.
var
The value being exchanged.
Remarks
This macro calls the CDHtmlDialog::DDX_DHtml_ElementText function using the DISPID_IHTMLFRAMEBASE_SRC dispatch ID.
DDX_DHtml_Img_Src
Gets or retrieves the name of an image or a video clip in the document.
DDX_DHtml_Img_Src(
CDataExchange* dx,
LPCTSTR name,
CString& var)
Parameters
dx
A pointer to a CDataExchange object.
name
The value that you specified for the HTML control's ID parameter.
var
The value being exchanged.
Remarks
When using the DDX_DHtml_Img_Src macro to retrieve the src property for an IMAGE element, the Internet Explorer image object will return the fully escaped URL for the image source. For example, if you use the DDX_DHtml_Img_Src macro to set the src property of an IMAGE element to the string "some interesting picture," when you retrieve that property, Internet Explorer will return the string "res://d:\myapplication\myapp.exe/some%20interesting%20picture."
This macro calls the CDHtmlDialog::DDX_DHtml_ElementText function using the DISPID_IHTMLIMGELEMENT_SRC dispatch ID.