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