Interfaz ITextRow (tom.h)

La interfaz ITextRow proporciona métodos para insertar una o varias filas de tabla idénticas y para recuperar y cambiar las propiedades de fila de tabla. Para insertar filas no identidades, llame a ITextRow::Insert para cada configuración de fila diferente.

Herencia

La interfaz ITextRow hereda de la interfaz IDispatch . ITextRow también tiene estos tipos de miembros:

Métodos

La interfaz ITextRow tiene estos métodos.

ITextRow::Apply Aplica los atributos de formato de este objeto de fila de texto a las filas especificadas en el ITextRange2 asociado.
ITextRow::CanChange Determina si se pueden realizar cambios en esta fila.
ITextRow::GetAlignment Obtiene la alineación horizontal de una fila.
ITextRow::GetCellAlignment Obtiene la alineación vertical de la celda activa.
ITextRow::GetCellBorderColors Obtiene los colores de borde de la celda activa.
ITextRow::GetCellBorderWidths Obtiene los anchos de borde de la celda activa.
ITextRow::GetCellColorBack Obtiene el color de fondo de la celda activa.
ITextRow::GetCellColorFore Obtiene el color de primer plano de la celda activa.
ITextRow::GetCellCount Obtiene el recuento de celdas de esta fila.
ITextRow::GetCellCountCache Obtiene el recuento de celdas almacenadas en caché para esta fila.
ITextRow::GetCellIndex Obtiene el índice de la celda activa para la que se van a obtener o establecer parámetros.
ITextRow::GetCellMargin Obtiene el margen de celda de esta fila.
ITextRow::GetCellMergeFlags Obtiene las marcas de combinación de la celda activa.
ITextRow::GetCellShading Obtiene el sombreado de la celda activa.
ITextRow::GetCellVerticalText Obtiene la configuración de texto vertical de la celda activa.
ITextRow::GetCellWidth Obtiene el ancho de la celda activa.
ITextRow::GetHeight Obtiene el alto de la fila.
ITextRow::GetIndent Obtiene la sangría de esta fila.
ITextRow::GetKeepTogether Obtiene si esta fila puede dividirse entre páginas.
ITextRow::GetKeepWithNext Obtiene si esta fila debe aparecer en la misma página que la fila que la sigue.
ITextRow::GetNestLevel Obtiene el nivel de anidamiento de una tabla.
ITextRow::GetProperty Obtiene el valor de la propiedad especificada. (ITextRow.GetProperty)
ITextRow::GetRTL Obtiene si esta fila tiene orientación de derecha a izquierda.
ITextRow::Insert Inserta una fila o filas en la ubicación identificada por el objeto ITextRange2 asociado.
ITextRow::IsEqual Compara dos filas de tabla para determinar si tienen las mismas propiedades.
ITextRow::Reset Restablece una fila.
ITextRow::SetAlignment Establece la alineación horizontal de una fila.
ITextRow::SetCellAlignment Establece la alineación vertical de la celda activa.
ITextRow::SetCellBorderColors Establece los colores de borde de la celda activa.
ITextRow::SetCellBorderWidths Establece los anchos de borde de la celda activa.
ITextRow::SetCellColorBack Establece el color de fondo de la celda activa.
ITextRow::SetCellColorFore Establece el color de primer plano de la celda activa.
ITextRow::SetCellCount Establece el recuento de celdas de una fila.
ITextRow::SetCellCountCache Establece el recuento de celdas almacenadas en caché para una fila.
ITextRow::SetCellIndex Establece el índice de la celda activa.
ITextRow::SetCellMargin Establece el margen de celda de una fila.
ITextRow::SetCellMergeFlags Establece las marcas de combinación de la celda activa.
ITextRow::SetCellShading Establece el sombreado de la celda activa.
ITextRow::SetCellVerticalText Establece el valor de texto vertical de la celda activa.
ITextRow::SetCellWidth Establece el ancho de celda activo en twips.
ITextRow::SetHeight Establece el alto de una fila.
ITextRow::SetIndent Establece la sangría de una fila.
ITextRow::SetKeepTogether Establece si esta fila puede dividirse entre páginas.
ITextRow::SetKeepWithNext Establece si una fila debe aparecer en la misma página que la fila que la sigue.
ITextRow::SetProperty Establece el valor de la propiedad especificada. (ITextRow.SetProperty)
ITextRow::SetRTL Establece si esta fila tiene orientación de derecha a izquierda.

Comentarios

Para seleccionar una tabla, una fila o una celda, use ITextRange::Expand, con el parámetro Unit establecido en tomTable, tomRow o tomCell, respectivamente. Estas unidades también se pueden usar con los métodos ITextRange::Move para navegar y seleccionar varias filas o celdas.

Algunas de las propiedades ITextRow se aplican a toda la fila, como la alineación de filas. Además, hay varias propiedades, como la alineación de celdas, que se aplican a una celda con el índice establecido a través del método ITextRow::SetCellIndex . Esta celda se conoce como celda activa.

ITextRow funciona de forma similar a ITextPara2, pero no modifica el documento hasta que se llama a los métodos ITextRow::Apply o ITextRow::Insert . Además, los parámetros de fila y celda siempre están activos, es decir, no pueden tener el valor tomDefault.

Al inicializar, el objeto ITextRow adquiere las propiedades de fila de tabla, si las hay, en el extremo activo del ITextRange2 asociado. El método ITextRow::Reset se puede usar para actualizar estas propiedades a los valores actuales del objeto ITextRange2 .

Una tabla de control de edición enriquecida consta de una secuencia de filas de tabla, que, a su vez, consta de secuencias de párrafos. Una fila de tabla comienza con el párrafo delimitador de dos caracteres especial U+FFF9 U+000D y termina con el párrafo delimitador de dos caracteres U+FFFB U+000D. Cada celda finaliza con la marca de celda U+0007, que se trata como una marca de extremo de párrafo duro igual que U+000D (CR). Los parámetros de celda y fila de tabla se tratan como formato de párrafo especial de los delimitadores de fila de tabla. Los parámetros de celda se almacenan en una versión expandida de la matriz de pestañas. Este formato permite anidar las tablas dentro de otras tablas y puede pasar quince niveles de profundidad.

La arquitectura es bastante flexible en que cada fila de tabla puede tener cualquier parámetro válido de fila de tabla, independientemente de los parámetros de otras filas (excepto las marcas de combinación verticales). Por ejemplo, el número de celdas y las sangrías iniciales de las filas de tabla pueden diferir, a diferencia de en HTML que tiene formato rectangular n×m con todas las filas que comienzan en la misma sangría.

Por otro lado, no se almacena ninguna descripción formal de la tabla en ningún lugar. La información como el número de filas debe averiguarse navegando por la tabla. Por ejemplo, el recuento de filas de una tabla se puede obtener llamando a ITextRange::StartOf (tomTable, tomFalse, NULL) para pasar al inicio de la tabla actual y, a continuación, llamar a ITextRange::Move (tomRow, tomForward, &dcRow). La cantidad &dcRow + 1 contiene el recuento de filas de la tabla, ya que mover por incrementos tomRow no se mueve más allá de la última fila de la tabla.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tom.h