IHTMLTableCell

IHTMLTableCell


This interface specifies a cell in a table.

This element is a block element.

IHTMLTableCell Methods
put_rowSpan   get_rowSpan   put_colSpan  
get_colSpan   put_align   get_align  
put_vAlign   get_vAlign   put_bgColor  
get_bgColor   put_noWrap   get_noWrap  
put_background   get_background   put_borderColor  
get_borderColor   put_borderColorLight   get_borderColorLight  
put_borderColorDark   get_borderColorDark   put_width  
get_width   put_height   get_height  
get_cellIndex  

IHTMLTableCell::get_align

HRESULT get_align( 
    BSTR *p 
);

Displays the element left flush, right flush, or centered relative to the display or table.

p
Address of a string variable that receives one of these values:
center Aligns to the center.
left Aligns to the left edge.
right Aligns to the right edge.

See also put_align

IHTMLTableCell::get_background

HRESULT get_background(
    BSTR *p 
);

Retrieves a background picture for the cell. The picture is tiled behind the text and graphics in the table cell.

p
Address of a string variable that receives the URL of the background picture.

See also put_background

IHTMLTableCell::get_bgColor

HRESULT get_bgColor(
    VARIANT *p 
);

Retrieves the background color behind the element.

p
Address of a VARIANT structure that receives the color. The color can be one of the color names or values given in the Color Table reference documentation.

See also put_bgColor

IHTMLTableCell::get_borderColor

HRESULT get_borderColor(
    VARIANT *p 
);

Retrieves the border color and must be used with the border property.

p
Address of a VARIANT structure that receives the color. The color can be one of the color names or values given in the Color Table reference documentation.

See also put_borderColor

IHTMLTableCell::get_borderColorDark

HRESULT get_borderColorDark(
    VARIANT *p 
);

Retrieves independent border color control over one of the two colors used to draw a 3-D border, opposite of borderColorLight, and must be used with the border property.

p
Address of a VARIANT structure that receives the color. The color can be one of the color names or values given in the Color Table reference documentation.

See also put_borderColorDark

IHTMLTableCell::get_borderColorLight

HRESULT get_borderColorLight(
    VARIANT *p 
);

Retrieves independent border color control over one of the two colors used to draw a 3-D border, opposite of borderColorDark, and must be used with the border property.

p
Address of a VARIANT structure that receives the color. The color can be one of the color names or values given in the Color Table reference documentation.

See also put_borderColorLight

IHTMLTableCell::get_cellIndex

HRESULT get_cellIndex(
    long *p 
);

Retrieves the cell index value.

p
Address of a long integer that receives the cell index value.

IHTMLTableCell::get_colSpan

HRESULT get_colSpan( 
    long *p 
);

Retrieves how many columns in the TABLE this cell spans.

p
Address of a long integer receiving the number of columns spanned.

See also put_colSpan

IHTMLTableCell::get_height

HRESULT get_height(
    VARIANT *p 
);

Retrieves the calculated height of the element, in pixels.

p
Address of a VARIANT structure that receives the height.

If the value of the corresponding HTML attribute was set using a percentage, this property specifies the height in pixels represented by that percentage.

See also put_height

IHTMLTableCell::get_noWrap

HRESULT get_noWrap(
    VARIANT_BOOL *p 
);

Determines whether automatic word wrapping is enabled or disabled for the element.

p
Address of a variable that receives TRUE if automatic word-wrapping is enabled for the element, or FALSE otherwise. The default value for this property is FALSE.

See also put_noWrap

IHTMLTableCell::get_rowSpan

HRESULT get_rowSpan(
    long *p 
);

Retrieves how many rows in a TABLE this cell spans.

p
Address of a long integer receiving the number of rows spanned.

See also put_rowSpan

IHTMLTableCell::get_vAlign

HRESULT get_vAlign( 
    BSTR *p 
);

Retrieves how the text and other content of an element is vertically aligned within the element.

p
Address of a string variable that receives one of these strings:
baseline Aligns the baseline of the first line of text with the baselines in adjacent elements.
bottom Aligns the text at the bottom of the element.
middle Aligns the text in the middle of the element. This is the default value for this property.
top Aligns the text at the top of the element.

See also put_vAlign

IHTMLTableCell::get_width

HRESULT get_width(
    VARIANT *p 
);

Retrieves the calculated width of the element, in pixels.

p
Address of a VARIANT structure that receives the width.

This property is an integer value. Although an HTML author can specify the width as a percentage, this property always specifies the width in pixels.

See also put_width

IHTMLTableCell::put_align

HRESULT put_align(
    BSTR v 
);

Displays the element left flush, right flush, or centered relative to the display or table.

v
VARIANT structure that contains the string specifying the alignment. Can be one of these values:
center Aligns to the center.
left Aligns to the left edge.
right Aligns to the right edge.

See also get_align

IHTMLTableCell::put_background

HRESULT put_background(
    BSTR v 
);

Sets a background picture for the cell. The picture is tiled behind the text and graphics in the table cell.

v
VARIANT structure that contains the string specifying the URL of the background picture.

See also get_background

IHTMLTableCell::put_bgColor

HRESULT put_bgColor(
    VARIANT v 
);

Sets the background color behind the element.

v
VARIANT structure that contains the string or value specifying the color. The color can be one of the color names or values given in the Color Table reference documentation.

See also get_bgColor

IHTMLTableCell::put_borderColor

HRESULT put_borderColor(
    VARIANT v 
);

Sets the border color and must be used with the border property.

v
VARIANT structure that contains the string or value specifying the color. The color can be one of the color names or values given in the Color Table reference documentation.

See also get_borderColor

IHTMLTableCell::put_borderColorDark

HRESULT put_borderColorDark( 
    VARIANT v 
);

Sets independent border color control over one of the two colors used to draw a 3-D border, opposite of borderColorLight, and must be used with the border property.

v
VARIANT structure that contains the string or value specifying the color for borderColorDark. The color can be one of the color names or values given in the Color Table reference documentation.

See also get_borderColorDark

IHTMLTableCell::put_borderColorLight

HRESULT put_borderColorLight(
    VARIANT v 
);

Sets independent border color control over one of the two colors used to draw a 3-D border, opposite of borderColorDark, and must be used with the border property.

v
VARIANT structure that contains the string or value specifying the color for borderColorLight. The color can be one of the color names or values given in the Color Table reference documentation.

See also get_borderColorLight

IHTMLTableCell::put_colSpan

HRESULT put_colSpan( 
    long v 
);

Sets how many columns in the TABLE this cell should span.

v
Long integer value specifying the number of columns to span.

See also get_colSpan

IHTMLTableCell::put_height

HRESULT put_height(
    VARIANT v 
);

Sets the calculated height of the element, in pixels.

v
VARIANT structure that contains the value specifying the height.

If the value of the corresponding HTML attribute was set using a percentage, this property specifies the height in pixels represented by that percentage.

See also get_height

IHTMLTableCell::put_noWrap

HRESULT put_noWrap(
    VARIANT_BOOL v 
);

Enables or disables automatic word wrapping for the element.

v
Word-wrap flag. If TRUE, the browser performs automatic word wrapping on the element. If FALSE, it doesn't. The default value for this property is FALSE.

See also get_noWrap

IHTMLTableCell::put_rowSpan

HRESULT put_rowSpan(
    long v 
);

Sets how many rows in a TABLE this cell should span.

v
Long integer value specifying the number of rows to span.

See also get_rowSpan

IHTMLTableCell::put_vAlign

HRESULT put_vAlign( 
    BSTR v 
);

Sets how the text and other content of an element is vertically aligned within the element.

v
String specifying the vertical alignment. Can be one of these strings:
baseline Aligns the baseline of the first line of text with the baselines in adjacent elements.
bottom Aligns the text at the bottom of the element.
middle Aligns the text in the middle of the element. This is the default value for this property.
top Aligns the text at the top of the element.

See also get_vAlign

IHTMLTableCell::put_width

HRESULT put_width(
    VARIANT v 
);

Sets the calculated width of the element, in pixels.

v
VARIANT structure that contains the value specifying the width.

This property is an integer value. Although an HTML author can specify the width as a percentage, this property always specifies the width in pixels.

See also get_width

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.