Class Comment

Namespace: Aspose.Cells
Assembly: Aspose.Cells.dll (25.2.0)

Encapsula o objeto que representa um comentário de célula.

public class Comment

Herança

object ← Comment

Membros Herdados

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Exemplos

Workbook workbook = new Workbook();
CommentCollection comments = workbook.Worksheets[0].Comments;

//Adicionar comentário à célula A1
int commentIndex1 = comments.Add(0, 0);
Comment comment1 = comments[commentIndex1];
comment1.Note = "Primeira nota.";
comment1.Font.Name = "Times New Roman";

//Adicionar comentário à célula B2
comments.Add("B2");
Comment comment2 = comments["B2"];
comment2.Note = "Segunda nota.";

//faça seu trabalho

//Salvar o arquivo excel.
workbook.Save("exmaple.xlsx");

Dim workbook as Workbook = new Workbook()
Dim comments as CommentCollection = workbook.Worksheets(0).Comments

'Adicionar comentário à célula A1
Dim commentIndex1 as Integer = comments.Add(0, 0)
Dim comment1 as Comment = comments(commentIndex1)
comment1.Note = "Primeira nota."
comment1.Font.Name = "Times New Roman"

'Adicionar comentário à célula B2
comments.Add("B2")
Dim comment2 As Comment = comments("B2")
comment2.Note = "Segunda nota."

Propriedades

Autor

Obtém e define o nome do autor original do comentário.

public string Author { get; set; }

Valor da Propriedade

string

Exemplos

comment1.Author = "Carl.Yang";

TamanhoAutomático

Indica se o tamanho do comentário é ajustado automaticamente de acordo com seu conteúdo.

public bool AutoSize { get; set; }

Valor da Propriedade

bool

Exemplos

if(!comment1.AutoSize)
{
    //O tamanho do comentário varia com o conteúdo
    comment1.AutoSize = true;
}

Coluna

Obtém o índice da coluna do comentário.

public int Column { get; }

Valor da Propriedade

int

Exemplos

int column = comment1.Column;

FormaDoComentário

Obtém um objeto Shape que representa a forma anexada ao comentário especificado.

public CommentShape CommentShape { get; }

Valor da Propriedade

CommentShape

Exemplos

CommentShape shape = comment1.CommentShape;
int w = shape.Width;
int h = shape.Height;

Fonte

Obtém a fonte do comentário.

public Font Font { get; }

Valor da Propriedade

Font

Exemplos

Aspose.Cells.Font font = comment1.Font;
font.Size = 12;

Altura

Representa a altura do comentário, em unidade de pixels.

public int Height { get; set; }

Valor da Propriedade

int

Exemplos

comment1.Height = 10;

AlturaCM

Representa a altura do comentário, em unidade de centímetros.

public double HeightCM { get; set; }

Valor da Propriedade

double

Exemplos

comment1.HeightCM = 1.0;

AlturaPolegada

Representa a altura do comentário, em unidade de polegadas.

public double HeightInch { get; set; }

Valor da Propriedade

double

Exemplos

comment1.HeightInch = 1.0;

HtmlNota

Obtém e define a string html que contém dados e alguns formatos neste comentário.

public string HtmlNote { get; set; }

Valor da Propriedade

string

Exemplos

comment1.HtmlNote = "&lt;Font Style='FONT-FAMILY: Calibri;FONT-SIZE: 11pt;COLOR: #0000ff;TEXT-ALIGN: left;'&gt;Isto é um &lt;b&gt;teste&lt;/b&gt;.&lt;/Font&gt;";

Observações

Se este for um comentário encadeado, a nota não pode ser alterada, caso contrário, o MS Excel não poderá processá-lo como um comentário encadeado.

ÉComentárioEncadeado

Indica se este comentário é um comentário encadeado.

public bool IsThreadedComment { get; }

Valor da Propriedade

bool

Exemplos

if(comment1.IsThreadedComment)
{
    //Este comentário é um comentário encadeado.
}

ÉVisível

Representa se o comentário é visível ou não.

public bool IsVisible { get; set; }

Valor da Propriedade

bool

Exemplos

if(comment1.IsVisible)
{
    //O comentário é visível
}

Nota

Representa o conteúdo do comentário.

public string Note { get; set; }

Valor da Propriedade

string

Exemplos

comment1.Note = "Primeira nota.";

Observações

Se este for um comentário encadeado, a nota não pode ser alterada, caso contrário, o MS Excel não poderá processá-lo como um comentário encadeado.

Linha

Obtém o índice da linha do comentário.

public int Row { get; }

Valor da Propriedade

int

Exemplos

int row = comment1.Row;

AlinhamentoHorizontalDoTexto

Obtém e define o tipo de alinhamento horizontal do texto do comentário.

public TextAlignmentType TextHorizontalAlignment { get; set; }

Valor da Propriedade

TextAlignmentType

Exemplos

if (comment1.TextHorizontalAlignment ==  TextAlignmentType.Fill)
{
    comment1.TextHorizontalAlignment = TextAlignmentType.Center;
}

TipoDeOrientaçãoDoTexto

Obtém e define o tipo de orientação do texto do comentário.

public TextOrientationType TextOrientationType { get; set; }

Valor da Propriedade

TextOrientationType

Exemplos

if(comment1.TextOrientationType == TextOrientationType.NoRotation)
{
    comment1.TextOrientationType = TextOrientationType.TopToBottom;
}

AlinhamentoVerticalDoTexto

Obtém e define o tipo de alinhamento vertical do texto do comentário.

public TextAlignmentType TextVerticalAlignment { get; set; }

Valor da Propriedade

TextAlignmentType

Exemplos

if (comment1.TextVerticalAlignment ==  TextAlignmentType.Fill)
{
    comment1.TextVerticalAlignment = TextAlignmentType.Center;
}

ComentáriosEncadeados

Obtém a lista de comentários encadeados;

public ThreadedCommentCollection ThreadedComments { get; }

Valor da Propriedade

ThreadedCommentCollection

Exemplos

ThreadedCommentCollection threadedComments = comment1.ThreadedComments;
for (int i = 0; i &lt; threadedComments.Count; ++i)
{
    ThreadedComment tc = threadedComments[i];
    string note = tc.Notes;
}

Largura

Representa a largura do comentário, em unidade de pixels.

public int Width { get; set; }

Valor da Propriedade

int

Exemplos

comment1.Width = 10;

LarguraCM

Representa a largura do comentário, em unidade de centímetros.

public double WidthCM { get; set; }

Valor da Propriedade

double

Exemplos

comment1.WidthCM = 1.0;

LarguraPolegada

Representa a largura do comentário, em unidade de polegadas.

public double WidthInch { get; set; }

Valor da Propriedade

double

Exemplos

comment1.WidthInch = 1.0;

Métodos

Caracteres(int, int)

Retorna um objeto Characters que representa um intervalo de caracteres dentro do texto do comentário.

public FontSetting Characters(int startIndex, int length)

Parâmetros

startIndex int

O índice do início do caractere.

length int

O número de caracteres.

Retorna

FontSetting

Objeto Characters.

Exemplos

Aspose.Cells.FontSetting fontSetting = comment1.Characters(0, 4);

FormatarCaracteres(int, int, Font, StyleFlag)

Formata alguns caracteres com a configuração da fonte.

public void FormatCharacters(int startIndex, int length, Font font, StyleFlag flag)

Parâmetros

startIndex int

O índice inicial.

length int

O comprimento.

font Font

A configuração da fonte.

flag StyleFlag

A flag da configuração da fonte.

ObterFormatosRicos()

Retorna todos os objetos Characters que representam um intervalo de caracteres dentro do texto do comentário.

public FontSetting[] GetRichFormattings()

Retorna

FontSetting[]

Todos os objetos Characters.

Exemplos

FontSetting[] list = comment1.GetRichFormattings();