IHTMLTableRow

IHTMLTableRow


This interface specifies a row in a table.

Within a row, the following tags are valid:

This element is a block element.

IHTMLTableRow Methods
put_align   get_align   put_vAlign  
get_vAlign   put_bgColor   get_bgColor  
put_borderColor   get_borderColor   put_borderColorLight  
get_borderColorLight   put_borderColorDark   get_borderColorDark  
get_rowIndex   get_sectionRowIndex   get_cells  
insertCell   deleteCell  

IHTMLTableRow::deleteCell

HRESULT deleteCell(
    long index 
);

Removes a cell and all its contents from the row.

index
Long integer value specifying the row position index to be deleted.

See also insertCell

IHTMLTableRow::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

IHTMLTableRow::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

IHTMLTableRow::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

IHTMLTableRow::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

IHTMLTableRow::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

IHTMLTableRow::get_cells

HRESULT get_cells(
    IHTMLElementCollection **p 
);

Retrieves a collection of all cells in the row of a table. This is a collection of TH and TD elements.

p
Address of a variable that receives an interface pointer to the collection.

IHTMLTableRow::get_rowIndex

HRESULT get_rowIndex( 
   long *p 
);

Returns the zero-based position index of this row relative to the table.

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

IHTMLTableRow::get_sectionRowIndex

HRESULT get_sectionRowIndex( 
    long *p 
);

Returns the zero-based index of this row with respect to the section that this is in (that is, the rowIndex of the first row in this section).

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

IHTMLTableRow::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 get_vAlign

IHTMLTableRow::insertCell

HRESULT insertCell(
    long index 
);

Inserts an empty cell into this row. The cell is inserted at the zero-based index passed into the table. If -1, or the size of the cells collection for this row is passed in, the cell is appended and a pointer to the cell created is returned.

index
Long integer specifying the index value for the table cell.

See also deleteCell

IHTMLTableRow::put_align

HRESULT put_align(
    BSTR v 
);

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

v
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

IHTMLTableRow::put_bgColor

HRESULT put_bgColor(
    VARIANT v 
);

Sets the background color behind the element.

v
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

IHTMLTableRow::put_borderColor

HRESULT put_borderColor(
    VARIANT v 
);

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

v
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

IHTMLTableRow::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 containing the string specifying the color value. The color can be one of the color names or values given in the Color Table reference documentation.

See also get_borderColorDark

IHTMLTableRow::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 containing the string specifying the color value. The color can be one of the color names or values given in the Color Table reference documentation.

See also get_borderColorLight

IHTMLTableRow::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

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