Interface ITextRow (tom.h)

A interface ITextRow fornece métodos para inserir uma ou mais linhas de tabela idênticas e recuperar e alterar as propriedades da linha da tabela. Para inserir linhas não periódicas, chame ITextRow::Insert para cada configuração de linha diferente.

Herança

A interface ITextRow herda da interface IDispatch . ITextRow também tem esses tipos de membros:

Métodos

A interface ITextRow tem esses métodos.

ITextRow::Apply Aplica os atributos de formatação desse objeto de linha de texto às linhas especificadas no ITextRange2 associado.
ITextRow::CanChange Determina se alterações podem ser feitas nessa linha.
ITextRow::GetAlignment Obtém o alinhamento horizontal de uma linha.
ITextRow::GetCellAlignment Obtém o alinhamento vertical da célula ativa.
ITextRow::GetCellBorderColors Obtém as cores da borda da célula ativa.
ITextRow::GetCellBorderWidths Obtém as larguras da borda da célula ativa.
ITextRow::GetCellColorBack Obtém a cor da tela de fundo da célula ativa.
ITextRow::GetCellColorFore Obtém a cor de primeiro plano da célula ativa.
ITextRow::GetCellCount Obtém a contagem de células nesta linha.
ITextRow::GetCellCountCache Obtém a contagem de células armazenadas em cache para essa linha.
ITextRow::GetCellIndex Obtém o índice da célula ativa para a qual obter ou definir parâmetros.
ITextRow::GetCellMargin Obtém a margem de célula dessa linha.
ITextRow::GetCellMergeFlags Obtém os sinalizadores de mesclagem da célula ativa.
ITextRow::GetCellShading Obtém o sombreamento da célula ativa.
ITextRow::GetCellVerticalText Obtém a configuração de texto vertical da célula ativa.
ITextRow::GetCellWidth Obtém a largura da célula ativa.
ITextRow::GetHeight Obtém a altura da linha.
ITextRow::GetIndent Obtém o recuo dessa linha.
ITextRow::GetKeepTogether Obtém se essa linha tem permissão para ser quebrada entre páginas.
ITextRow::GetKeepWithNext Obtém se essa linha deve aparecer na mesma página que a linha que a segue.
ITextRow::GetNestLevel Obtém o nível de aninhamento de uma tabela.
ITextRow::GetProperty Obtém o valor da propriedade especificada. (ITextRow.GetProperty)
ITextRow::GetRTL Obtém se essa linha tem orientação da direita para a esquerda.
ITextRow::Insert Insere uma linha ou linhas no local identificado pelo objeto ITextRange2 associado.
ITextRow::IsEqual Compara duas linhas de tabela para determinar se elas têm as mesmas propriedades.
ITextRow::Reset Redefine uma linha.
ITextRow::SetAlignment Define o alinhamento horizontal de uma linha.
ITextRow::SetCellAlignment Define o alinhamento vertical da célula ativa.
ITextRow::SetCellBorderColors Define as cores da borda da célula ativa.
ITextRow::SetCellBorderWidths Define as larguras da borda da célula ativa.
ITextRow::SetCellColorBack Define a cor da tela de fundo da célula ativa.
ITextRow::SetCellColorFore Define a cor do primeiro plano da célula ativa.
ITextRow::SetCellCount Define a contagem de células em uma linha.
ITextRow::SetCellCountCache Define a contagem de células armazenadas em cache para uma linha.
ITextRow::SetCellIndex Define o índice da célula ativa.
ITextRow::SetCellMargin Define a margem de célula de uma linha.
ITextRow::SetCellMergeFlags Define os sinalizadores de mesclagem da célula ativa.
ITextRow::SetCellShading Define o sombreamento da célula ativa.
ITextRow::SetCellVerticalText Define a configuração de texto vertical da célula ativa.
ITextRow::SetCellWidth Define a largura da célula ativa em twips.
ITextRow::SetHeight Define a altura de uma linha.
ITextRow::SetIndent Define o recuo de uma linha.
ITextRow::SetKeepTogether Define se essa linha tem permissão para ser quebrada entre páginas.
ITextRow::SetKeepWithNext Define se uma linha deve aparecer na mesma página que a linha que a segue.
ITextRow::SetProperty Define o valor da propriedade especificada. (ITextRow.SetProperty)
ITextRow::SetRTL Define se essa linha tem orientação da direita para a esquerda.

Comentários

Para selecionar uma tabela, uma linha ou uma célula, use ITextRange::Expand, com o parâmetro Unit definido como tomTable, tomRow ou tomCell, respectivamente. Essas unidades também podem ser usadas com os métodos ITextRange::Move para navegar e selecionar várias linhas ou células.

Algumas das propriedades ITextRow se aplicam a toda a linha, como o alinhamento da linha. Além disso, há várias propriedades, como alinhamento de célula, que se aplicam a uma célula com o índice definido por meio do método ITextRow::SetCellIndex . Essa célula é conhecida como a célula ativa.

ITextRow funciona de forma semelhante a ITextPara2, mas não modifica o documento até que os métodos ITextRow::Apply ou ITextRow::Insert sejam chamados. Além disso, os parâmetros de linha e célula estão sempre ativos, ou seja, eles não podem ter o valor tomDefault.

Na inicialização, o objeto ITextRow adquire as propriedades da linha da tabela, se houver, no final ativo do ITextRange2 associado. O método ITextRow::Reset pode ser usado para atualizar essas propriedades para os valores atuais do objeto ITextRange2 .

Uma tabela de controle de edição avançada consiste em uma sequência de linhas de tabela, que, por sua vez, consistem em sequências de parágrafos. Uma linha de tabela começa com o parágrafo especial do delimitador de dois caracteres U+FFF9 U+000D e termina com o parágrafo delimitador de dois caracteres U+FFFB U+000D. Cada célula é encerrada pela marca de célula U+0007, que é tratada como uma marca de fim de parágrafo rígido, assim como U+000D (CR) é. Os parâmetros de linha e célula da tabela são tratados como formatação de parágrafo especial dos delimitadores de linha de tabela. Os parâmetros de célula são armazenados em uma versão expandida da matriz de guias. Esse formato permite que as tabelas sejam aninhadas em outras tabelas e tem permissão para acessar quinze níveis de profundidade.

A arquitetura é bastante flexível, pois cada linha de tabela pode ter parâmetros de linha de tabela válidos, independentemente dos parâmetros para outras linhas (exceto para sinalizadores de mesclagem verticais). Por exemplo, o número de células e os recuos iniciais das linhas da tabela podem ser diferentes, ao contrário do HTML que tem formato retangular n×m com todas as linhas começando no mesmo recuo.

Por outro lado, nenhuma descrição formal da tabela é armazenada em qualquer lugar. Informações como o número de linhas devem ser calculadas navegando pela tabela. Por exemplo, a contagem de linhas em uma tabela pode ser obtida chamando ITextRange::StartOf (tomTable, tomFalse, NULL) para mover para o início da tabela atual e, em seguida, chamando ITextRange::Move (tomRow, tomForward, &dcRow). A quantidade &dcRow + 1 contém a contagem de linhas na tabela, pois mover por incrementos tomRow não ultrapassa a última linha da tabela.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tom.h