Struct

PangoLogAttr

Description [src]

struct PangoLogAttr {
  guint is_line_break : 1;
  guint is_mandatory_break : 1;
  guint is_char_break : 1;
  guint is_white : 1;
  guint is_cursor_position : 1;
  guint is_word_start : 1;
  guint is_word_end : 1;
  guint is_sentence_boundary : 1;
  guint is_sentence_start : 1;
  guint is_sentence_end : 1;
  guint backspace_deletes_character : 1;
  guint is_expandable_space : 1;
  guint is_word_boundary : 1;
  guint break_inserts_hyphen : 1;
  guint break_removes_preceding : 1;
  guint reserved : 17;
}

The PangoLogAttr structure stores information about the attributes of a single character.

Structure members

is_line_break: If set, can break line in front of character.
is_mandatory_break: If set, must break line in front of character.
is_char_break: If set, can break here when doing character wrapping.
is_white: Is whitespace character.
is_cursor_position: If set, cursor can appear in front of character. i.e. this is a grapheme boundary, or the first character in the text. This flag implements Unicode’s Grapheme Cluster Boundaries semantics.
is_word_start: Is first character in a word.
is_word_end: Is first non-word char after a word Note that in degenerate cases, you could have both is_word_start and is_word_end set for some character.
is_sentence_boundary: Is a sentence boundary. There are two ways to divide sentences. The first assigns all inter-sentence whitespace/control/format chars to some sentence, so all chars are in some sentence; is_sentence_boundary denotes the boundaries there. The second way doesn’t assign between-sentence spaces, etc. to any sentence, so is_sentence_start/is_sentence_end mark the boundaries of those sentences.
is_sentence_start: Is first character in a sentence.
is_sentence_end: Is first char after a sentence. Note that in degenerate cases, you could have both is_sentence_start and is_sentence_end set for some character. (e.g. no space after a period, so the next sentence starts right away)
backspace_deletes_character: If set, backspace deletes one character rather than the entire grapheme cluster. This field is only meaningful on grapheme boundaries (where is_cursor_position is set). In some languages, the full grapheme (e.g. letter + diacritics) is considered a unit, while in others, each decomposed character in the grapheme is a unit. In the default implementation of pango_break(), this bit is set on all grapheme boundaries except those following Latin, Cyrillic or Greek base characters.
is_expandable_space: Is a whitespace character that can possibly be expanded for justification purposes. (Since: 1.18)
is_word_boundary: Is a word boundary, as defined by UAX#29. More specifically, means that this is not a position in the middle of a word. For example, both sides of a punctuation mark are considered word boundaries. This flag is particularly useful when selecting text word-by-word. This flag implements Unicode’s Word Boundaries semantics. (Since: 1.22)
break_inserts_hyphen: When breaking lines before this char, insert a hyphen. Since: 1.50
break_removes_preceding: When breaking lines before this char, remove the preceding char. Since 1.50
reserved: No description available.