C++Builder Programming Forum
C++Builder  |  Delphi  |  FireMonkey  |  C/C++  |  Free Pascal  |  Firebird
볼랜드포럼 BorlandForum
 경고! 게시물 작성자의 사전 허락없는 메일주소 추출행위 절대 금지
C++빌더 포럼
Q & A
FAQ
팁&트릭
강좌/문서
자료실
컴포넌트/라이브러리
메신저 프로젝트
볼랜드포럼 홈
헤드라인 뉴스
IT 뉴스
공지사항
자유게시판
해피 브레이크
공동 프로젝트
구인/구직
회원 장터
건의사항
운영진 게시판
회원 메뉴
북마크
볼랜드포럼 광고 모집
C++빌더 Q&A
 C++Builder Programming Q&A
[7960] Re:(질문)MS DHTMLEdit를 활용한자료???
방태윤 [nabty] 2767 읽음    2001-06-04 21:23
msdn.microsoft.com/workshop/author/dhtml/edit/ref/axcom.asp
간단하게 에디터정도는 될겁니다.도움이 되실라나...
아래는 갭춰한 내용입니다.끝.

General Editing Commands

DECMD_COPY, DECMD_CUT, DECMD_DELETE, DECMD_FINDTEXT, DECMD_PASTE, DECMD_PROPERTIES, DECMD_REDO, DECMD_SELECTALL, DECMD_UNDO

Formatting Commands

DECMD_BOLD, DECMD_FONT, DECMD_GETBACKCOLOR, DECMD_GETBLOCKFMT, DECMD_GETBLOCKFMTNAMES, DECMD_GETFONTNAME, DECMD_GETFONTSIZE, DECMD_GETFORECOLOR, DECMD_INDENT, DECMD_ITALIC, DECMD_JUSTIFYCENTER, DECMD_JUSTIFYLEFT, DECMD_JUSTIFYRIGHT, DECMD_ORDERLIST, DECMD_OUTDENT, DECMD_REMOVEFORMAT, DECMD_SETBACKCOLOR, DECMD_SETBLOCKFMT, DECMD_SETFONTNAME, DECMD_SETFONTSIZE, DECMD_SETFORECOLOR, DECMD_UNDERLINE, DECMD_UNORDERLIST

Hyperlink/Image Commands

DECMD_HYPERLINK, DECMD_IMAGE, DECMD_UNLIN

Table Commands

DECMD_DELETECELLS, DECMD_DELETECOLS, DECMD_DELETEROWS, DECMD_INSERTCELL, DECMD_INSERTCOL, DECMD_INSERTROW, DECMD_INSERTTABLE, DECMD_MERGECELLS, DECMD_SPLITCELL

Absolute Positioning Commands

DECMD_BRING_ABOVE_TEXT, DECMD_BRING_FORWARD, DECMD_BRING_TO_FRONT, DECMD_LOCK_ELEMENT, DECMD_MAKE_ABSOLUTE, DECMD_SEND_BACKWARD, DECMD_SEND_BELOW_TEXT, DECMD_SEND_TO_BACK

Note For details about absolute positioning, see Working with Absolutely Positioned Elements.

--------------------------------------------------------------------------------

DECMD_BOLD

Description

Toggles the bold state of the selected text.
Syntax

retVal = object. QueryStatus( DECMD_BOLD )
object. ExecCommand DECMD_BOLD

Part Description
object The DHTML Editing control

Return value

One of the following values is returned when you use this command ID with the QueryStatus method:
Setting Description
DECMDF_DISABLED (1) The selection is an element (such as a control or table) that does not support bold formatting. If you call the ExecCommand method in this state, an error occurs.
DECMDF_ENABLED (3) The selection is not bold, or includes both bold and non-bold elements.
DECMDF_LATCHED (7) The selection is already bold.

Remarks

Use the QueryStatus method to determine whether the selection or insertion point location can accept this command.
If nothing is selected but the insertion point is within a word, this command treats the current word as the selection.
When passed with the ExecCommand method, this command places and tags around the selection or at the insertion point. If the selection is already formatted bold, the and tags are removed. If the selection is within a larger string of bold text, the command inserts </STRONG> and tags around the selection, effectively turning bold off for the selection. Tip To allow users to select character formatting attributes for the selection, display the Font dialog box using the DECMD_FONT command. Back to top -------------------------------------------------------------------------------- DECMD_BRING_ABOVE_TEXT Description Moves an absolutely positioned element in front of the 1-D HTML stream by giving it a positive z-index. Syntax retVal = object. QueryStatus( DECMD_BRING_ABOVE_TEXT ) object. ExecCommand DECMD_BRING_ABOVE_TEXT Part Description object The DHTML Editing control Return Value One of the following values is returned when you use this command ID by the QueryStatus method: Setting Description DECMDF_DISABLED (1) The element is not absolutely positioned. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selected element can be repositioned. Remarks This command is supported for absolutely positioned elements (those that have been positioned using DECMD_MAKE_ABSOLUTE). Use the QueryStatus method to determine whether the selected element can be moved in z-order. When passed with the ExecCommand method, this command makes the element's Z-ORDER style attribute positive, moving it above the 1-D stream. Note For details about absolute positioning, see Working with Absolutely Positioned Elements. Back to top -------------------------------------------------------------------------------- DECMD_BRING_FORWARD Description Moves an absolutely positioned element one z-order layer toward the front of the document or container, adjusting the z-order of other elements in the same container. Syntax retVal = object. QueryStatus( DECMD_BRING_FORWARD ) object. ExecCommand DECMD_BRING_FORWARD Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The element is not absolutely positioned. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selected element can be repositioned. Remarks This command is supported for absolutely positioned elements (those that have been positioned using DECMD_MAKE_ABSOLUTE). Use the QueryStatus method to determine whether the selected element can be moved in z-order. When passed with the ExecCommand method, this command increments the element's Z-ORDER style attribute by one, readjusting the Z-ORDER style attribute of other elements in the same container as necessary. Note For details about absolute positioning, see Working with Absolutely Positioned Elements. Back to top -------------------------------------------------------------------------------- DECMD_BRING_TO_FRONT Description Moves an absolutely positioned element to the front of the document or container. Syntax retVal = object. QueryStatus( DECMD_BRING_TO_FRONT ) object. ExecCommand DECMD_BRING_TO_FRONT Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The element is not absolutely positioned. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selected element can be repositioned. Remarks This command is supported for absolutely positioned elements (those that have been positioned using DECMD_MAKE_ABSOLUTE). Use the QueryStatus method to determine whether the selected element can be moved in z-order. When passed with the ExecCommand method, this command sets the element's Z-ORDER style attribute to the highest of all the absolutely positioned elements on the page or in its container, readjusting the Z-ORDER style attribute of other elements as necessary. Note For details about absolute positioning, see Working with Absolutely Positioned Elements. Back to top -------------------------------------------------------------------------------- DECMD_COPY Description Copies the selection to the Windows Clipboard. Syntax retVal = object. QueryStatus( DECMD_COPY ) object. ExecCommand DECMD_COPY Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) There is no selection or the selection consists of text in a password control. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection can be copied. Remarks When passed with the ExecCommand method, this command places two forms of the selected text on the Windows Clipboard. One form (CF_HTML) includes all HTML formatting instructions. The other (CF_TEXT) contains only the plain text, with all HTML tags removed. Back to top -------------------------------------------------------------------------------- DECMD_CUT Description Copies the selection to the Windows Clipboard, then deletes it from the document. Syntax retVal = object. QueryStatus( DECMD_CUT ) object. ExecCommand DECMD_CUT Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Settingt Description DECMDF_DISABLED (1) There is no selection or the selection consists of text in a password control. DECMDF_ENABLED (3) The selection can be cut. Remarks When passed with the ExecCommand method, this command places two forms of the selected text on the Windows Clipboard. One form (CF_HTML) includes all HTML formatting instructions. The other (CF_TEXT) contains only the plain text, with all HTML tags removed. Back to top -------------------------------------------------------------------------------- DECMD_DELETE Description Deletes the selection without placing it on the Windows Clipboard. Syntax retVal = object. QueryStatus( DECMD_DELETE ) object. ExecCommand DECMD_DELETE Part Description object The DHTML Editing control Return value When you use this command ID with the QueryStatus method, it always returns DECMDF_ENABLED (3). Remarks If no element is selected, passing this command with the ExecCommand method deletes the element or character immediately to the right of the insertion point. Back to top -------------------------------------------------------------------------------- DECMD_DELETECELLS Description Deletes the selected cells from a table. Syntax retVal = object. QueryStatus( DECMD_DELETECELLS ) object.ExecCommand DECMD_DELETECELLS Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection or insertion point is not inside a table, or the selection includes elements in more than one row. This value is also returned if the insertion point is within the table caption or if the entire table is selected. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection or insertion point is within cells in a table. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to remove a cell. The selection or insertion point must be within one or more cells in a table. If nothing is selected, the current cell is the one in which the insertion point appears, and the one that will be deleted. If the selection includes more than one cell, all cells containing any portion of a selection will be deleted -- it is not necessary that the entire contents of a cell be selected. The overall table width is not altered when deleting a cell. Instead, the cell widths are adjusted to accommodate the deleted cell. Back to top -------------------------------------------------------------------------------- DECMD_DELETECOLS Description Deletes all the columns in a table containing selected text. Syntax retVal = object. QueryStatus( DECMD_DELETECOLS ) object.ExecCommand DECMD_DELETECOLS Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Part Description DECMDF_DISABLED (1) The selection or insertion point is not inside a table. This value is also returned if the insertion point is within the table caption, if the entire table is selected, or if the selection spans more than one row. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection or insertion point is within a column in a table. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to remove a column. The selection or insertion point must be within one or more columns in a table. If nothing is selected, the current column is the one in which the insertion point appears, and the one that will be deleted. If the selection includes more than one column, all columns containing any portion of a selection will be deleted -- it is not necessary that the entire contents of a column be selected. The overall table width is not altered when deleting a column. Instead, the column widths are adjusted to accommodate the deleted column. Back to top -------------------------------------------------------------------------------- DECMD_DELETEROWS Description Deletes all rows containing selected elements. Syntax retVal = object. QueryStatus( DECMD_DELETEROWS ) object.ExecCommand DECMD_DELETEROWS Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection or insertion point is not inside a table. This value is returned if the insertion point is within the table caption or if the entire table is selected. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection or insertion point is within a row in a table. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to remove a row. The selection or insertion point must be within one or more cells in a table, but within a single row. If nothing is selected, the current row is the one in which the insertion point appears. If the selection includes more than one row, all rows containing any portion of a selection will be deleted -- it is not necessary that the entire contents of a row be selected. When the row is deleted, the overall table height is reduced by the height of the deleted row. Back to top -------------------------------------------------------------------------------- DECMD_FINDTEXT Description Displays the Find dialog box to allow users to specify text to search for in the current document. Syntax retVal = object. QueryStatus( DECMD_FINDTEXT ) object.ExecCommand DECMD_FINDTEXT Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection or insertion point is in a control or other element that does not support searching. This value is also returned if the current document is an HTML dialog box. DECMDF_ENABLED (3) The Find dialog box can be displayed. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command always displays the Find dialog; there is no option not to display a user interface. The command searches the DHTML text of the entire current document, even if some text is selected. It ignores textual elements of controls, such as captions, labels, or parameter values. Back to top -------------------------------------------------------------------------------- DECMD_FONT Description Displays the Font dialog box and applies the user's choices to the selection. Syntax retVal = object. QueryStatus( DECMD_FONT ) object.ExecCommand DECMD_FONT Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection includes an element, such as a table, that does not support the element. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection supports the element. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command always displays the Font dialog; there is no option not to display a user interface. Executing this command adds a element around the selection if one is not already there. Within the element, the command sets the COLOR, FACE, and SIZE attributes with information taken from the dialog box. The command will also add , , or tags around the selection as appropriate. Note Although the Font dialog box displays font sizes in points, the command translates these into HTML font sizes (in the range 1 to 7). If nothing is selected but the insertion point is within a word, this command treats the current word as the selection. To set font attributes without displaying a dialog box, use the following commands: DECMD_BOLD DECMD_ITALIC DECMD_SETFONTNAME DECMD_SETFONTSIZE DECMD_SETFORECOLOR DECMD_UNDERLINE To get the current font attributes for the selection, execute the following commands: DECMD_GETFONTNAME DECMD_GETFONTSIZE DECMD_GETFORECOLOR Back to top -------------------------------------------------------------------------------- DECMD_GETBACKCOLOR Description Gets the background color of the text in the selection. Syntax retVal = object. QueryStatus( DECMD_GETBACKCOLOR ) retVal = object. ExecCommand DECMD_GETBACKCOLOR Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Stting Description DECMDF_DISABLED (1) The selection is an element that does not support a BACKCOLOR attribute. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection contains text. DECMDF_NINCHED (11) There is no selection, or the selection does not have a BACKCOLOR attribute set. When you use this command ID with the ExecCommand method, the return value is a background color. This string is an RGB color value such as #FF0000 for red. If the selection includes a mixture of text with a BACKCOLOR attribute and any other type of element -- for example, a control or text without a BACKCOLOR attribute -- the method returns the empty string ("") as the return value. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to return the current background color. Back to top -------------------------------------------------------------------------------- DECMD_GETBLOCKFMT Description Returns the HTML paragraph format of the selection. Syntax retVal = object. QueryStatus( DECMD_GETBLOCKFMT ) retVal = object. ExecCommand DECMD_GETBLOCKFMT Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection includes an element, such as a table or control, that does not support HTML formats. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection supports formats. When you use this command ID with the ExecCommand method, the return value is a string containing the name of an HTML paragraph format, such as "Normal" or "Heading 1". If the text has not been formatted with a block format, the command returns "Normal" If the command cannot return a single format (for example, if the selection contains text from paragraphs with different formats), the command returns the empty string (""). Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to return the current format. This command is only supported if the selection contains text. The command returns the format information for the paragraph in which the insertion point appears; it is not necessary to select the entire paragraph. Note To get a list of valid HTML paragraph format names, execute the DECMD_GETBLOCKFMTNAMES command. Back to top -------------------------------------------------------------------------------- DECMD_GETBLOCKFMTNAMES Description Gets a list of valid paragraph format names for use with the DECMD_SETBLOCKFMT command. Syntax retVal = object. QueryStatus( DECMD_GETBLOCKFMTNAMES) object. ExecCommand DECMD_GETBLOCKFMTNAMES, OLECMDEXECOPT_DODEFAULT, blockFmtParam Part Description object The DHTML Editing control OLECMDEXECOPT_DODEFAULT A constant value specifying that the command should perform its default user interface behavior (in this case, do not display a dialog box.) This parameter is passed primarily as a placeholder so the blockFmtParam parameter is interpreted correctly. blockFmtParam A DEGetBlockFmtNamesParam object created before this command is executed. The command loads the object's Names property with an array of strings containing the list of currently supported, localized paragraph format names. This parameter is not optional; you must pass an object of this type to the DECMD_GETBLOCKFMTNAMES command. For more information, see "Remarks" below. Return value QueryStatus always returns DECMDF_DISABLED (1) for this command. However, this command is valid at any time. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to return a list of formats. The blockFmtParam parameter requires an object that must be created before being passed to the DECMD_GETBLOCKFMTNAMES command. The object's progID is: DEGetBlockFmtNamesParam.DEGetBlockFmtNamesParam Its classID is: 8d91090e-b955-11d1-adc5-006008a5848c For example, the following Visual Basic® code creates a DEGetBlockFmtNamesParam object, passes it to a DECMD_GETBLOCKFMTNAMES command, and populates a combo box called cmbBlockFmt with the results returned by the command in the object. ' The following appears in the Declarations. Optional, but provides ' statement completion for the object. Dim f as DEGetBlockFmtNamesParam ' [...] Private Sub DisplayFormats() If cmbBlockFmt.ListCount < 1 Then Set f=CreateObject("DEGetBlockFmtNamesParam.DEGetBlockFmtNamesParam ") DEdit1.ExecCommand(DECMD_GETBLOCKFMTNAMES, _ OLECMDEXECOPT_DODEFAULT,f) For Each fmtName in f.Names cmbBlockFmt.AddItem(fmtName) Next End If End Sub If you are working in a scripting language, you can create a DEGetBlockFmtNamesParam object in code using the CreateObject function. Alternatively, you can use an element, which gives the object global scope. If you use an element, you must pass the parameter object's Class ID. Typically, you would hide the object. The following example shows how you can create a GetBlockFmtNamesParam using an element and how you can then call the DECMD_GETBLOCKFMTNAMES command from Visual Basic Scripting Edition (VBScript) to display a list of formats in a message box: Note For details about getting the DHTMLEd.vbs file, see Requirements. Back to top -------------------------------------------------------------------------------- DECMD_GETFONTNAME Description Returns the font face of the selected text. Syntax retVal = object. QueryStatus( DECMD_GETFONTNAME) retVal = object. ExecCommand DECMD_GETFONTNAME Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection is an element that does not support font information, such as a table, control, or image. In some instances, such as when the selection is a control, QueryStatus returns this value even though the command can be executed. In other cases, such as if a table is selected, calling the ExecCommand method in this state results in an error. DECMDF_ENABLED (3) The selection contains text. This value is also returned if the selection contains a mix of elements that do and do not support the element. DECMDF_NINCHED (11) There is no selection or if the selection does not have a COLOR attribute set. When you use this command ID with the ExecCommand method, the return value is the font face name returned by the command. If the command cannot return a single font face name (for example, if the selection contains text with different font faces), the command returns the empty string (""). Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to return the current font name. This command is only supported if the selection contains text. It returns the font face for the selection as established by a element or by the FONT-FAMILY style attribute. If the text has not been formatted with a specific font face, the command returns the default font face name for the selected element. Tip The font face can be set with the DECMD_SETFONTNAME or DECMD_FONT commands. Back to top -------------------------------------------------------------------------------- DECMD_GETFONTSIZE Description Returns the HTML font size of the selected text. Syntax retVal = object. QueryStatus( DECMD_GETFONTSIZE) retVal = object. ExecCommand DECMD_GETFONTSIZE Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection is an element that does not support font information, such as a table, control, or image. In some instances, such as when the selection is a control, QueryStatus returns this value even though the command can be executed. In other cases, such as if a table is selected, calling the ExecCommand method in this state results in an error. DECMDF_ENABLED (3) The selection contains text. DECMDF_NINCHED (11) The selection contains text formatting with more than one font size. When you use this command ID with the ExecCommand method, it returns an HTML font size, 1-7. If the command cannot return a single font size (for example, if the selection contains text with different font sizes), the command returns the empty string (""). Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to return the current font size. This command is only supported if the selection contains text. It returns the font size for the selection as established by the SIZE attribute of the element. (It does not return an absolute point size.) If the text has not been formatted with a specific HTML font size, the command returns the default font size for the selected element. Tip The font size can be set with the DECMD_SETFONTSIZE or DECMD_FONT commands. Back to top -------------------------------------------------------------------------------- DECMD_GETFORECOLOR Description Gets the foreground color of the text in the selection. Syntax retVal = object. QueryStatus( DECMD_GETFORECOLOR) retval = object. ExecCommand DECMD_GETFORECOLOR Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection is an element that does not support a COLOR attribute. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection contains text. DECMDF_NINCHED (11) There is no selection, or the selection does not have a COLOR attribute set. When you use this command ID with the ExecCommand method, the value returned is a foreground color. This string is an RGB color value such as #FF0000 for red. If the selection includes a mixture of text with a COLOR attribute and any other type of element--for example, a control or text without a COLOR attribute--the command returns the empty string ("") as the return value. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to return the current color. This command returns the value of the COLOR attribute in the element that applies to the selection. If no element applies, the command returns the default color for the selection. Tip The font color can be set with the DECMD_SETFORECOLOR or DECMD_FONT commands. Back to top -------------------------------------------------------------------------------- DECMD_HYPERLINK Description Creates a link by inserting and tags around the selection or at the insertion point. Syntax retVal = object. QueryStatus( DECMD_HYPERLINK) object. ExecCommand DECMD_HYPERLINK [, cmdExecOpt] [, url] Part Description object The DHTML Editing control cmdExecOpt Optional parameter determines if the command will display a user interface. Possible values are: OLECMDEXECOPT_DODEFAULT or OLECMDEXECOPT_PROMPTUSER Specifies that the Hyperlink dialog box should be displayed to prompt the user for a target document and protocol. OLECMDEXECOPT_DONTPROMPTUSER Specifies that no dialog box should be displayed. The name of the target URL must be passed in the url parameter. If no url parameter is passed, an error occurs. The default is OLECMDEXECOPT_PROMPTUSER. url If cmdExecOpt contains OLECMDEXECOPT_DONTPROMPTUSER, contains the target URL for the link. Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection spans more than one cell in a table, includes a mixture of elements inside and outside a table, or includes a design-time control. If you call the ExecCommand method in this state, an error can occur. Note The value DECMDF_DISABLED is also returned if no text is selected but the insertion point is in a paragraph. This is not an error condition; in that state, the user can insert an tag to create a bookmark. DECMDF_ENABLED (3) A link can be inserted at the current location or around the selected elements. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command inserts an tag around the selection. Unless executed with the OLECMDEXECOPT_DONTPROMPTUSER option, the DECMD_HYPERLINK command displays the Hyperlink dialog box, which prompts the user for the name of the target file and for the protocol. If text or an image is selected, the command converts it into a link. If the selection is within an existing tag when this command is executed, the Hyperlink dialog box is displayed to allow the user to modify the HREF attribute. If no text is selected, the command inserts an tag at the current insertion point, which is useful for creating bookmarks. For bookmarks, the protocol selected in the Hyperlink dialog box should be "(other)". Back to top -------------------------------------------------------------------------------- DECMD_IMAGE Description Inserts a graphic at the current insertion point. Syntax retVal = object. QueryStatus( DECMD_IMAGE) object. ExecCommand DECMD_IMAGE [, cmdExecOpt] [, url] Part Description object The DHTML Editing control cmdExecOpt Optional parameter determines if the command will display a user interface. Possible values are: OLECMDEXECOPT_DODEFAULT or OLECMDEXECOPT_PROMPTUSER Specifies that the Picture dialog box should be displayed to prompt the user for a target document and protocol. OLECMDEXECOPT_DONTPROMPTUSER Specifies that no dialog box should be displayed. The name of the image file should be passed in the url parameter. If no url parameter is passed, the SRC attribute is omitted when the tag is inserted into the document. The default is OLECMDEXECOPT_PROMPTUSER. url Path and file name of graphics file to insert as HREF attribute of image. This parameter is used only if cmdExecOpt is set to OLECMDEXECOPT_DONTPROMPTUSER. Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection spans more than one cell in a table, includes a mixture of elements inside and outside a table, or includes a design-time control. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) An image can be inserted at the current location. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command inserts an tag at the current location in the document. If text is selected, the tag replaces the text. Unless executed with the OLECMDEXECOPT_DONTPROMPTUSER option, the DECMD_IMAGE command displays the Picture dialog box, which prompts the user for the name of the graphics file and for attributes such as alternate text, borders, alignment, and spacing. If you want to avoid displaying the Picture dialog box, specify the OLECMDEXECOPT_DONTPROMPTUSER option. In the url parameter, pass the path and file name of the image. You cannot specify additional attributes this way. Back to top -------------------------------------------------------------------------------- DECMD_INDENT Description Indents the selected paragraph. Syntax retVal = object. QueryStatus( DECMD_INDENT) object. ExecCommand DECMD_INDENT Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element that cannot be indented, such as a control, image, or table. You can indent the contents of individual table cells. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection can be indented. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command affects the entire container containing the insertion point or selection, such as a

or

element. This command adds a
element around the container for the selection. The command affects the entire container in which the insertion point or selection occurs, even if a subset of the text is selected. To reverse the effect of indenting a paragraph, execute the DECMD_OUTDENT command. Back to top -------------------------------------------------------------------------------- DECMD_INSERTCELL Description Inserts a single cell to the left of the current cell in a table. Syntax retVal = object. QueryStatus( DECMD_INSERTCELL) object. ExecCommand DECMD_INSERTCELL Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection or insertion point is not inside a table. This value is returned if the insertion point is within the table caption or if the entire table is selected. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection or insertion point is within one or more cells in a table. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to insert a cell. The selection or insertion point must be within a cell in a table. If nothing is selected, the current cell is the one in which the insertion point appears. If the selection spans more than one cell, the current cell is defined as the one that is leftmost and topmost in the selection. The overall table width is not altered when inserting a cell. Instead, the cell widths are adjusted to accommodate the new cell. When the new cell is inserted, individual cell attributes are copied from the current cell to the new one. Back to top -------------------------------------------------------------------------------- DECMD_INSERTCOL Description Inserts a new column to the left of the current column in a table. Syntax retVal = object. QueryStatus( DECMD_INSERTCOL) object.ExecCommand DECMD_INSERTCOL Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection or insertion point is not inside a column in a table. This value is returned if the insertion point is within the table caption or if the entire table is selected. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection or insertion point is within one or more cells in table. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to insert a column. The selection or insertion point must be within a column in a table. If nothing is selected, the current column is the one in which the insertion point appears. The overall table width is not altered when inserting a column. Instead, the cell widths are adjusted to accommodate the new column. The new column will contain the same number of cells as the current column. The individual cell attributes are copied cell for cell from the current column to the new one. Back to top -------------------------------------------------------------------------------- DECMD_INSERTROW Description Inserts a new row above the current row in a table. Syntax retVal = object. QueryStatus( DECMD_INSERTROW) object.ExecCommand DECMD_INSERTROW Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection or insertion point is not inside a row in a table. This value is returned if the insertion point is within the table caption or if the entire table is selected. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection or insertion point is within one or more cells in a table Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to insert a row. The selection or insertion point must be within a row in a table. If nothing is selected, the current row is the one in which the insertion point appears. The new row will contain the same number of cells as the previous row, with the same COLSPAN attributes, cell attributes, and styles. Back to top -------------------------------------------------------------------------------- DECMD_INSERTTABLE Description Inserts a table. Syntax retVal = object. QueryStatus( DECMD_INSERTTABLE) object.ExecCommand DECMD_INSERTTABLE, OLECMDEXECOPT_DODEFAULT, insertTableParam Part Description object The DHTML Editing control OLECMDEXECOPT_DODEFAULT A constant value specifying that the command should perform its default user interface behavior (in this case, do not display a dialog box.) This parameter is passed primarily as a placeholder so the insertTableParam parameter is interpreted correctly. insertTableParam A tableParam object created before this command is executed. The object supports the following properties that determine attributes of the new table at the time it is created: NumRows A numeric value specifying the number of rows in the new table. The default is 3. NumCols A numeric value specifying the number of columns in the new table. The default is 3. TableAttrs A string specifying the attributes to assign to the element. The default is "border=1 cellPadding=1 cellSpacing=1 width=75%". Note If you specify an TableAttrs property, your string of attributes completely replaces the default values. For example, if you specify an attribute string consisting of "WIDTH=50%", the newly-created table will have no border, cellpadding, or cellspacing attributes. CellAttrs A string specifying the attributes to assign to each
element in the table. The default is the empty string (""). Caption A string specifying the caption for the table. The default is the emtpy string (""). This parameter is not optional; you must pass an object of this type to the DECMD_INSERTTABLE command. However, all the properties are optional, so you can pass a blank object. The command uses default values for any properties not specified. For more information, see "Remarks" below. Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element that cannot be replaced with a table, including another table, a control, an image, and so on. DECMDF_ENABLED (3) A table can be inserted at the current insertion point. This value is returned even if there is a selection, and even if the selection includes a control, image, or table, including the whole document. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command inserts a element with the specified number of and
elements at the insertion point. If text is selected, the new table replaces the text. Tables can be inserted inside existing tables. The insertTableParam requires an object that must be created and populated before being passed to the command. The object's progID is: DEInsertTableParam.DEInsertTableParam Its classID is: 47B0DFC7-B7A3-11D1-ADC5-006008A5848c For example, in Visual Basic you can create the object and execute the command using code such as the following: ' The following appears in the Declarations. Optional, but provides ' statement completion for the object. Private tParam As DEInsertTableParam ' [...] Private Sub InsertTable() Set tParam = CreateObject("DEInsertTableParam.DEInsertTableParam") tParam.NumRows = 2 tParam.NumCols = 3 tParam.TableAttrs = "50%" tParam.CellAttrs = "" tParam.Caption = "New Table" DEdit1.ExecCommand(DECMD_INSERTTABLE, OLECMDEXECOPT_DODEFAULT, tParam) End Sub If you are working in a scripting language, you can create table parameter object in code using the CreateObject function. Alternatively, you can use an element, which gives the object global scope. If you use an element, you must pass the parameter object's Class ID instead. Typically, you would hide the object. The following example shows how you can create a table parameter object using an element and how you can then call the DECMD_INSERTTABLE command from VBScript: Note Set the parameter values for the table parameter object at run time. Values set at design time using tags will be ignored at run time. Note For details about getting the DHTMLEd.vbs file, see Requir ements. Back to top -------------------------------------------------------------------------------- DECMD_ITALIC Description Toggles the italic state of the selected text. Syntax retVal = object. QueryStatus( DECMD_ITALIC) object.ExecCommand DECMD_ITALIC Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element (such as a control or table) that does not support italics. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection is not italic, or includes both italics and non-italic elements. DECMDF_LATCHED (7) The selection is already italic. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. If nothing is selected but the insertion point is within a word, this command treats the current word as the selection. When passed with the ExecCommand method, this command places and tags around the selection or at the insertion point. If the selection is already formatted italic, the and tags are removed. If the selection is within a larger string of italic text, the command inserts and tags around the selection, effectively turning italics off for the selection. Tip To allow users to select character formatting attributes for the selection, display the Font dialog box using the DECMD_FONT command. Back to top -------------------------------------------------------------------------------- DECMD_JUSTIFYCENTER Description Centers the selected paragraph. Syntax retVal = object. QueryStatus( DECMD_JUSTIFYCENTER ) object.ExecCommand DECMD_JUSTIFYCENTER Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element that cannot support an ALIGN attribute (such as an HTML or ActiveX® control). DECMDF_ENABLED (3) The selection can be centered. DECMDF_LATCHED (7) The selection or insertion point is in a paragraph is already centered. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command adds an ALIGN attribute to the container (

or

) for the current text. It cannot be applied to text in a container that does not support the ALIGN attribute, such as text in an HTML control or to an ActiveX control. If necessary (such as for text in a table cell), the command adds a
element to create a container. Note Justification can be applied to cells within a table, but not to a table as a whole. The command affects the entire container in which the insertion point or selection occurs, even if a subset of the text is selected. To return to default alignment after executing the DECMD_JUSTIFYCENTER command, execute the DECMD_JUSTIFYLEFT command. Back to top -------------------------------------------------------------------------------- DECMD_JUSTIFYLEFT Description Left justifies the selected paragraph. Syntax retVal = object. QueryStatus( DECMD_JUSTIFYLEFT) object.ExecCommand DECMD_JUSTIFYLEFT Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element that cannot support an ALIGN attribute (such as an HTML or ActiveX control). DECMDF_ENABLED (3) The selection can be left-justified. DECMDF_LATCHED (7) The selection or insertion point is in a paragraph that is already left-justified (has no ALIGN attribute). Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command removes the ALIGN attribute inserted earlier with a DECMD_JUSTIFYRIGHT or DECMD_JUSTIFYCENTER command. It affects the entire container in which the insertion point or selection occurs, even if a subset of the text is selected. Note Justification can be applied to cells within a table, but not to a table as a whole. Back to top -------------------------------------------------------------------------------- DECMD_JUSTIFYRIGHT Description Right justifies the selected paragraph. Syntax retVal = object. QueryStatus( DECMD_JUSTIFYRIGHT) object.ExecCommand DECMD_JUSTIFYRIGHT Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element that cannot support an ALIGN attribute (such as an HTML or ActiveX control). DECMDF_ENABLED (3) The selection can be right-justified. DECMDF_LATCHED (7) The selection or insertion point is in a paragraph that is already right-justified Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command adds an ALIGN attribute to the container (

or

) for the current text. It cannot be applied to text in a container that does not support the ALIGN attribute, such as text in an HTML control or to an ActiveX control. If necessary (such as for text in a table cell), the command adds a
element to create a container. Note Justification can be applied to cells within a table, but not to a table as a whole. The command affects the entire container in which the insertion point or selection occurs, even if a subset of the text is selected. To return to default alignment after executing the DECMD_JUSTIFYRIGHT command, execute the DECMD_JUSTIFYLEFT command. Back to top -------------------------------------------------------------------------------- DECMD_LOCK_ELEMENT Description Toggles the lock state of an absolutely positioned element, which prevents the element from being moved or resized at design time. Syntax retVal = object. QueryStatus( DECMD_LOCK_ELEMENT ) object.ExecCommand DECMD_LOCK_ELEMENT Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The element is not absolutely positioned. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selected element can be repositioned. DECMDF_LATCHED (7) The selected element is already locked. Remarks Use the QueryStatus method to determine whether the selected element can be moved in z-order. When passed with the ExecCommand method, this command adds the DESIGN_TIME_LOCK style attribute to the element and sets it to True. Note For details about absolute positioning, see Working with Absolutely Positioned Elements. Back to top -------------------------------------------------------------------------------- DECMD_MAKE_ABSOLUTE Description Toggles the selected element between static positioning and absolute positioning. Syntax retVal = object. QueryStatus( DECMD_MAKE_ABSOLUTE ) object.ExecCommand DECMD_MAKE_ABSOLUTE Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) A portion of the selection includes an element, such as text outside a division, that cannot be absolutely positioned. This value is also returned if the selection includes only part of an element (such as a element) that can be positioned absolutely. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection completely contains an element that can be absolutely positioned. DECMDF_LATCHED (7) The selection is already absolutely positioned. Remarks This command is supported only for elements that can support a setting of "absolute" for the POSITION style attribute. In general, this includes containers such as
, , , and elements as well as images, HTML controls (buttons, text areas), objects, applets, and horizontal rules. Text outside of container elements cannot be positioned absolutely. Design-time controls (DTCs) cannot be positioned absolutely. Note For details about absolute positioning, see Working with Absolutely Positioned Elements. Use the QueryStatus method to determine whether the selected element can be positioned absolutely. When passed with the ExecCommand method, this command acts on the selection. The command adds a STYLE attribute to the selected element and sets the following style attributes: POSITION (which is set to "absolute"), TOP, and Z-INDEX. If the selection is already part of an ordered list, POSITION and Z-INDEX attributes are removed. Back to top -------------------------------------------------------------------------------- DECMD_MERGECELLS Description Merges two or more table cells into a single cell. Syntax retVal = object. QueryStatus( DECMD_MERGECELLS ) object.ExecCommand DECMD_MERGECELLS Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection includes elements outside a table or does not include at least two table cells. If you call the ExecCommand method in this state, an error occurs. Note This value is returned if only one cell is selected. In that case, executing the command does not accomplish anything, but no error occurs. DECMDF_ENABLED (3) The selection includes two or more table cells and no text outside the table. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to merge cells. The selection must include two or more table cells. All cells containing any portion of a selection will be merged--it is not necessary that the entire contents of a cell be selected. When cells are merged, their contents are concatenated together in the remaining cell. The merged cells assume the attributes of the cell that was leftmost and topmost in the selection. The overall table width is not altered when cells are merged. Instead, the cell widths are adjusted. Back to top -------------------------------------------------------------------------------- DECMD_ORDERLIST Description Turns the selection into a numbered (ordered) list or removes selected list items from a numbered list. Syntax retVal = object. QueryStatus( DECMD_ORDERLIST ) object.ExecCommand DECMD_ORDERLIST Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Description DECMDF_DISABLED (1) The selection includes an element, such as a table, that cannot be put into a list. (The contents of individual cells can be put into a list.) If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection can be turned into a list. DECMDF_LATCHED (7) The selection is already part of a list. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command acts on the selection, or if nothing is selected, on the current paragraph only. The command surrounds the affected paragraphs with
    and
tags, and places
  • and
    • around individual paragraphs. If the selection is already part of an ordered list, the tags are removed and surrounding text is fixed up appropriately. Back to top -------------------------------------------------------------------------------- DECMD_OUTDENT Description Decreases the indentation of the selected paragraph. Syntax retVal = object. QueryStatus( DECMD_OUTDENT ) object.ExecCommand DECMD_OUTDENT Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element that does not support a
    element, such as a control, image, or table. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection can be outdented. This value is returned for a selection that supports
    even if it is not indented. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command undoes the effect of the DECMD_INDENT command by removing the
    element from around the current paragraph or division. The command affects the entire container in which the insertion point or selection occurs, even if a subset of the text is selected. Back to top -------------------------------------------------------------------------------- DECMD_PASTE Description Pastes the contents of the Windows Clipboard at the insertion point or over the selection. Syntax retVal = object. QueryStatus( DECMD_PASTE ) object.ExecCommand DECMD_PASTE Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) There is no text on the Windows Clipboard, the selection spans more than one cell in a table, or a design-time control is selected. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The contents of the Clipboard can be pasted at the current location. Remarks When passed with the ExecCommand method, this command copies text from the Windows Clipboard to the current location. HTML text can be on the Clipboard in two forms. One form (CF_HTML) includes all HTML formatting instructions. The other (CF_TEXT) contains only the plain text, with all HTML tags removed. When you paste from the Clipboard into the DHTML Editing control, the control attempts to paste the version of the text that includes HTML formatting. Back to top -------------------------------------------------------------------------------- DECMD_PROPERTIES Description Displays a Properties window for the selected element if supported by the host application. Syntax retVal = object. QueryStatus( DECMD_PROPERTIES ) object.ExecCommand DECMD_PROPERTIES Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selected element does not support a property page or if more than one element is selected. This value is also returned if the host application does not allow property pages to be displayed. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selected element supports a property page. Remarks Certain elements that can appear on a document--such as ActiveX controls--include support for displaying and editing properties in a Properties window. If so, passing this command with the ExecCommand method displays the Properties window for that element. Back to top -------------------------------------------------------------------------------- DECMD_REDO Description Re-executes the command most recently reversed with the DECMD_UNDO command. Syntax retVal = object. QueryStatus( DECMD_REDO ) object.ExecCommand DECMD_REDO Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) There is no edit command to redo. DECMDF_ENABLED (3) A command is available to be redone. Remarks Use the QueryStatus method to determine whether there are commands that can be redone. Use the ExecCommand method to redo a command. This command can be called as many times as there are commands to be undone. Commands can only be re-executed in the order they were undone--you cannot selectively redo a specific command. After a command has been redone, it is removed from the list of commands (the redo buffer) that can be redone. Back to top -------------------------------------------------------------------------------- DECMD_REMOVEFORMAT Description Removes all formatting tags from the selection. Syntax retVal = object. QueryStatus( DECMD_REMOVEFORMAT ) object.ExecCommand DECMD_REMOVEFORMAT Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selected element does not support elements that can be removed (such as controls). DECMDF_ENABLED (3) The selection supports removable elements. QueryStatus returns this value even if there are no tags to remove. Remarks When passed with the ExecCommand method, this command will remove any of the following elements contained in the selection: ACRONYM B BDO BIG BLINK BLOCKQUOTE CITE CODE DEL DFN EM FONT I INS KBD NOBR Q S SAMP SMALL STRIKE STRONG SUB SUP TT U VAR Back to top -------------------------------------------------------------------------------- DECMD_SELECTALL Description Selects everything in the body of the document. Syntax retVal = object. QueryStatus( DECMD_SELECTALL ) object.ExecCommand DECMD_SELECTALL Part Description object The DHTML Editing control Return values QueryStatus always returns DECMDF_ENABLED (3) for this command. See Also ExecCommand method Back to top -------------------------------------------------------------------------------- DECMD_SEND_BACKWARD Description Moves an absolutely positioned element one z-order layer toward the back of the document or container, adjusting the z-order of other elements in the same container. Syntax retVal = object. QueryStatus( DECMD_SEND_BACKWARD ) object.ExecCommand DECMD_SEND_BACKWARD Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The element is not absolutely positioned. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selected element can be repositioned. Remarks This command is supported for absolutely positioned elements (those that have been positioned using DECMD_MAKE_ABSOLUTE). Use the QueryStatus method to determine whether the selected element can be moved in z-order. When passed with the ExecCommand method, this command decrements the element's Z-ORDER style attribute by one, readjusting the Z-ORDER attribute of other elements in the same container as necessary. Note For details about absolute positioning, see Working with Absolutely Positioned Elements. Back to top -------------------------------------------------------------------------------- DECMD_SEND_BELOW_TEXT Description Moves an absolutely positioned element behind the 1-D HTML stream by giving it a negative z-index. Syntax retVal = object. QueryStatus( DECMD_SEND_BELOW_TEXT ) object.ExecCommand DECMD_SEND_BELOW_TEXT Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The element is not absolutely positioned. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selected element can be repositioned. Remarks This command is supported for absolutely positioned elements (those that have been positioned using DECMD_MAKE_ABSOLUTE). Use the QueryStatus method to determine whether the selected element can be moved in z-order. When passed with the ExecCommand method, this command assigns a negative value to the element's Z-ORDER style attribute, readjusting the Z-ORDER style attribute of other elements as necessary. Because the 1-D HTML stream is considered to have a z-order value of 0, giving an element a negative z-order value places it behind the 1-D stream. Note For details about absolute positioning, see Working with Absolutely Positioned Elements. Back to top -------------------------------------------------------------------------------- DECMD_SEND_TO_BACK Description Moves an absolutely positioned element to the back of the document or container. Syntax retVal = object. QueryStatus( DECMD_SEND_TO_BACK ) object.ExecCommand DECMD_SEND_TO_BACK Part Description object The DHTML Editing control Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The element is not absolutely positioned. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selected element can be repositioned. Remarks This command is supported for absolutely positioned elements (those that have been positioned using DECMD_MAKE_ABSOLUTE). Use the QueryStatus method to determine whether the selected element can be moved in z-order. The z-index of a new object on a page is initially set to be higher than all other objects in its container, and therefore on top of previous items in the container. When passed with the ExecCommand method, this command sets the element's Z-ORDER style attribute to the lowest of all the absolutely positioned elements on its side of the 1-D stream. (Elements with a positive Z-ORDER style attribute value are in front of the 1-D stream; elements with a negative Z-ORDER style attribute value are behind it.) The command adjusts the Z-ORDER style attribute of other elements as necessary. If the element is already at the back, executing this command makes no change. Note For details about absolute positioning, see Working with Absolutely Positioned Elements. Back to top -------------------------------------------------------------------------------- DECMD_SETBACKCOLOR Description Sets the background color of the text in the selection. Syntax retVal = object. QueryStatus( DECMD_SETBACKCOLOR ) object.ExecCommand DECMD_SETBACKCOLOR, OLECMDEXECOPT_DODEFAULT, backColor Part Description object The DHTML Editing control OLECMDEXECOPT_DODEFAULT A constant value specifying that the command should perform its default user interface behavior (in this case, not displaying a dialog box). This parameter is passed primarily as a placeholder so the backColor parameter is interpreted correctly. backColor String containing either a color name (such as "red," "white," "black," and so on) from the Internet Explorer color table, or a six-digit numeric RGB color value (such as "FF0066"), with or without the leading "#" character. Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element that does not support a background color. Only text does. DECMDF_ENABLED (3) The selection includes only text. DECMDF_NINCHED (11) The selection includes some elements or text whose back color is not already set. Remarks This command is only supported if the selection contains text. When passed with the ExecCommand method, this command adds a tag around the selection if one is not already there. Within the element, this command adds or changes the style attribute BACKGROUND-COLOR plus the number or name of the color. See Also DECMD_GETBACKCOLOR, DECMD_SETFORECOLOR Back to top -------------------------------------------------------------------------------- DECMD_SETBLOCKFMT Description Sets the paragraph formatting of the selected text. Syntax retVal = object. QueryStatus( DECMD_SETBLOCKFMT ) object.ExecCommand DECMD_SETBLOCKFMT, OLECMDEXECOPT_DODEFAULT, formatName Part Description object The DHTML Editing control OLECMDEXECOPT_DODEFAULT A constant value specifying that the command should perform its default user interface behavior (in this case, not displaying a dialog box). This parameter is passed primarily as a placeholder so the formatSize parameter is interpreted correctly. formatName A string containing the name of an HTML paragraph format, such as "Normal" or "Heading 1". You can get a list of supported block format names by executing the DECMD_GETBLOCKFMTNAMES command. Passing an invalid format name results in an error. Note The valid names you can pass with this command are not the names of the corresponding HTML tags. For example, to enclose a paragraph in an

    element, you must pass the format value "Heading 2." Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection includes an element, such as an image, table, or control, that ordinarily does not support paragraph formatting. If you call the ExecCommand method in this state, an error can occur. DECMDF_ENABLED (3) The selection supports paragraph formatting. Remarks Use the QueryStatus method to determine whether a paragraph format can be applies to the selection. When passed with the ExecCommand method, this command adds an appropriate element around the selection. For example, if you pass the value "Heading 2" to the command, the selection is enclosed in

    and

    tags. If nothing is selected, the current paragraph is the one in which the insertion point appears. To remove a specific format, apply the Normal format, which places

    and

    tags around the current paragraph. Back to top -------------------------------------------------------------------------------- DECMD_SETFONTNAME Description Applies a font face to the selected text. Syntax retVal = object. QueryStatus( DECMD_SETFONTNAME ) object.ExecCommand DECMD_SETFONTNAME, OLECMDEXECOPT_DODEFAULT, fontName Part Description object The DHTML Editing control OLECMDEXECOPT_DODEFAULT A constant value specifying that the command should perform its default user interface behavior (in this case, not displaying a dialog box.) This parameter is passed primarily as a placeholder so the fontName parameter is interpreted correctly. fontName A string containing the name of the font face. Note The command does not validate that you are passing a valid font face. Return values One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection includes an element, such as a table, that does not support the element. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection supports the element. This value is also returned if the selection contains a mix of elements that do and do not support the element. Remarks This command is only supported if the selection contains text. When passed with the ExecCommand method, this command adds a tag around the selection if one is not already there. Within the element, this command adds or changes the FACE attribute. If nothing is selected but the insertion point is within a word, this command treats the current word as the selection. This command does not display a user interface; you must pass a font face name with the command. To allow the user to choose a font face, display the Font dialog box using the DECMD_FONT command. If you need to be able to reset the font name to its previous value, you should execute the DECMD_GETFONTNAME command and save off the current font before executing the DECMD_SETFONTNAME command. If you want to remove the FONT attribute altogether, you must update the HTML text of the document directly (using the DOM property). Back to top -------------------------------------------------------------------------------- DECMD_SETFONTSIZE Description Sets the HTML font size of the selected text. Syntax retVal = object. QueryStatus( DECMD_SETFONTSIZE ) object.ExecCommand DECMD_SETFONTSIZE, OLECMDEXECOPT_DODEFAULT, fontSize Part Description object The DHTML Editing control OLECMDEXECOPT_DODEFAULT A constant value specifying that the command should perform its default user interface behavior (in this case, not displaying a dialog box.) This parameter is passed primarily as a placeholder so the formatSize parameter is interpreted correctly. fontSize A numeric value indicating the HTML font size to apply in the range 1 to 7. Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection includes an element, such as a table, that does not support the element. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection supports the element. This value is also returned if the selection contains a mix of elements that do and do not support the element. Remarks This command is only supported if the selection contains text. When passed with the ExecCommand method, this command adds a element around the selection if one is not already there. Within the element, this command adds or changes the SIZE attribute. If nothing is selected but the insertion point is within a word, this command treats the current word as the selection. This command does not display a user interface; you must pass a font size with the command. To allow the user to choose a font size, display the Font dialog box using the DECMD_FONT command. If you need to be able to reset the font size to its previous value, you should execute the DECMD_GETFONTSIZE command and save off the current size before executing the DECMD_SETFONTSIZE command. If you want to remove the SIZE attribute altogether, you must update the HTML text of the document directly (using the DOM property). Tip To allow users to select character formatting attributes for the selection, display the Font dialog box using the DECMD_FONT command. Back to top -------------------------------------------------------------------------------- DECMD_SETFORECOLOR Description Sets the foreground color of the text in the selection. Syntax retVal = object. QueryStatus( DECMD_SETFORECOLOR ) object.ExecCommand DECMD_SETFORECOLOR, OLECMDEXECOPT_DODEFAULT, foreColor Part Description object The DHTML Editing control OLECMDEXECOPT_DODEFAULT A constant value specifying that the command should perform its default user interface behavior (in this case, do not display a dialog box.) This parameter is passed primarily as a placeholder so the foreColor parameter is interpreted correctly. foreColor String containing either a color name (such as "red," "white," "black," and so on) from the Internet Explorer color table, or a six digit numeric RGB color value (such as "FF0066"), with or without the leading "#" character. Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element that does not support a background color. Only text does. DECMDF_ENABLED (3) The selection includes only text. DECMDF_NINCHED (11) The selection includes a mix of text with a foreground color and text without. Remarks This command is only supported if the selection contains text. When passed with the ExecCommand method, this command adds a element around the selection if one is not already there. Within the element, this command adds or changes the COLOR attribute plus the number or name of the color. Tip To allow users to select character formatting attributes for the selection, display the Font dialog box using the DECMD_FONT command. If you need to be able to reset the color to its previous value, you should execute the DECMD_GETFORECOLOR command and save off the current color before executing the DECMD_SETFORECOLOR command. If you want to remove the COLOR attribute altogether, you must update the HTML text of the document directly (using the DOM property). Back to top -------------------------------------------------------------------------------- DECMD_SPLITCELL Description Splits one or more table cells. Syntax retVal = object. QueryStatus( DECMD_SPLITCELL ) object.ExecCommand DECMD_SPLITCELL Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection or insertion point is not inside a table. This value is also returned if the insertion point is within the table caption or if the entire table is selected. If you call the ExecCommand method in this state, an error occurs. Note This value is returned if more than one cell is selected. However, it is possible to split multiple cells in one operation. In that case, no error occurs when you execute the command. DECMDF_ENABLED (3) The selection or insertion point is within cells in a table. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. Use the ExecCommand method to split a cell. The selection or insertion point must be within one or more cells in a table. If nothing is selected, the current cell is the one in which the insertion point appears, and the one that is split. If the selection includes more than one cell, all cells containing any portion of a selection will be split--it is not necessary that the entire contents of a cell be selected. Each selected cell is split horizontally--an empty cell is added to the right of the selected cell. The overall table width is not altered when splitting a cell. Instead, the cell widths are adjusted to accommodate the deleted cell. Back to top -------------------------------------------------------------------------------- DECMD_UNDERLINE Description Toggles the underline state of the selected text. Syntax retVal = object. QueryStatus( DECMD_UNDERLINE ) object.ExecCommand DECMD_UNDERLINE Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection is an element (such as a control or table) that does not support underlining. If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection is not underlined, or includes both underlined and non-underlined elements. DECMDF_LATCHED (7) The selection is already underlined. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. If nothing is selected but the insertion point is within a word, this command treats the current word as the selection. When passed with the ExecCommand method, this command places and tags around the selection or at the insertion point. If the selection is already underlined, the selection is and tags are removed. If the selection is within a larger string of underlined text, the command inserts and tags around the selection, effectively removing underlining for the selection. Tip To allow users to select character formatting attributes for the selection, display the Font dialog box using the DECMD_FONT command. Back to top -------------------------------------------------------------------------------- DECMD_UNDO Description Reverses the effect of the last editing operation. Syntax retVal = object. QueryStatus( DECMD_UNDO ) object.ExecCommand DECMD_UNDO Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) There is no edit command to undo. DECMDF_ENABLED (3) A command is available to be undone. Remarks Use the QueryStatus method to determine whether there are commands that can be undone. Use the ExecCommand method to undo the command. As a general rule, the DECMD_UNDO command can only undo the effects of commands made in Edit mode (commands executed with the ExecCommand method). For example, it cannot undo the effect of setting a property value or calling a method. You can undo an unlimited number of previously made edits, but they are undone in the reverse order --you cannot selectively undo specific commands. Back to top -------------------------------------------------------------------------------- DECMD_UNLINK Description Removes and tags from the selection. Syntax retVal = object. QueryStatus( DECMD_UNLINK ) object.ExecCommand DECMD_UNLINK Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection or insertion point is not in a link. DECMDF_ENABLED (3) The selection or insertion point is in a link. Remarks Use the QueryStatus method to determine whether the selection or insertion point location can accept this command. When passed with the ExecCommand method, this command affects the entire container in which the insertion point or selection occurs, even if a subset of the text is selected. Back to top -------------------------------------------------------------------------------- DECMD_UNORDERLIST Description Turns the selection into a bulleted (unordered) list or removes selected list items from a bulleted list. Syntax retVal = object. QueryStatus( DECMD_UNORDERLIST ) object.ExecCommand DECMD_UNORDERLIST Part Description object The DHTML Editing control Return value One of the following values is returned when you use this command ID with the QueryStatus method: Setting Value DECMDF_DISABLED (1) The selection includes an element, such as a table, that cannot be put into a list. (The contents of individual cells can be put into a list.) If you call the ExecCommand method in this state, an error occurs. DECMDF_ENABLED (3) The selection can be turned into a list. DECMDF_LATCHED (7) The selection is already part of a list.
    Trackback : http://cbuilder.borlandforum.com/impboard/impboard.dll/trackback?sn=14910

    + -

    관련 글 리스트
    7960 Re:(질문)MS DHTMLEdit를 활용한자료??? 방태윤 2767 2001/06/04
    Google
    Copyright © 1999-2015, borlandforum.com. All right reserved.