Bezeichnung
  pango.Attribute -- Erstellt ein Pango-Attribut
Übersicht

      attr = pango.Attribute(type$[, ...])

Beschreibung
  Erstellt ein neues Pango-Attribut des angegebenen `type$`. Die anderen Parameter, die an diese Funktion übergeben werden müssen, hängen vom angegebenen Typ ab.

  Die folgenden Typen werden derzeit unterstützt:

  `AllowBreaks`
    Erstellt ein neues Attribut "Pausen zulassen". Sie müssen ein zusätzliches boolesches Argument übergeben, das angibt, ob Pausen zulässig sind. Bei deaktivierten Pausen wird die Reichweite soweit wie möglich in einem einzigen Lauf gehalten.

  `Background`
    Erstellt ein neues Hintergrundfarbattribut. Sie müssen die drei zusätzlichen Argumente übergeben, die die roten, grünen und blauen Komponenten der Hintergrundfarbe angeben und jeweils zwischen 0 und 65535 liegen müssen.

  `BackgroundAlpha`
    Erstellt ein neues Alpha-Hintergrund-Attribut. Sie müssen das zusätzliche Argument `alpha` übergeben, das den Alpha-Hintergrundwert angibt und zwischen 0 und 65535 liegen muss.

  `Fallback`
    Erstellt ein neues Schriftarten-Fallback-Attribut. Sie müssen ein zusätzliches boolesches Argument übergeben, das angibt, ob Fallback aktiviert oder deaktiviert werden soll. Wenn das Fallback deaktiviert ist, werden nur Zeichen aus der am besten passenden Schriftart im System verwendet. Es wird kein Fallback auf andere Schriftarten im System durchgeführt, die möglicherweise die Zeichen im Text enthalten.

  `Family`
    Erstellt ein neues Schriftfamilienattribut. Sie müssen eine Zeichenkette übergeben, die den Familiennamen oder eine durch Kommas getrennte Liste von Familien enthält.

  `FontDesc`
    Erstellt ein neues Schriftbeschreibungsattribut. Als zusätzliches Argument benötigen Sie ein Pango-Schriftbeschreibungsobjekt. Dieses Attribut ermöglicht das gleichzeitige Setzen der Attribute `Family`, `Style`, `Weight`, `Variant`, `Stretch` und `Size`.

  `Foreground`
    Erstellt ein neues Vordergrundfarbattribut. Sie müssen die drei zusätzlichen Argumente übergeben, die die roten, grünen und blauen Komponenten der Vordergrundfarbe angeben und jeweils zwischen 0 und 65535 liegen müssen.

  `ForegroundAlpha`
    Erstellt ein neues Alpha-Vordergrund-Attribut. Sie müssen einen zusätzlichen Wert übergeben, der den Alpha-Vordergrundwert angibt und zwischen 0 und 65535 liegen muss.

  `Gravity`
    Erstellt ein neues Ausrichtungsattribut. Sie müssen ein zusätzliches Argument übergeben, das die Ausrichtung angibt. Eine Liste der Ausrichtungskonstanten finden Sie unter pcontext:SetBaseGravity().

  `GravityHint`
    Erstellt ein neues Ausrichtungshinweis-Attribut. Sie müssen ein zusätzliches Argument übergeben, das den Ausrichtungshinweis angibt. Eine Liste mit Hinweisen zur Ausrichtung finden Sie unter pcontext:SetGravityHint().

  `InsertHyphens`
    Erstellt ein neues Attribut "Bindestriche einfügen". Pango fügt Bindestriche ein, wenn Zeilen in der Mitte eines Wortes umgebrochen werden. Setzen Sie dieses Attribut auf `False`, um den Bindestrich zu unterdrücken.

  `Language`
    Erstellt ein neues Sprach-Tag-Attribut. Sie müssen ein zusätzliches Argument übergeben, das ein Pango-Sprachobjekt enthält.

  `LetterSpacing`
    Erstellt ein neues Attribut für den Buchstabenabstand. Sie müssen ein zusätzliches Argument übergeben, das den zusätzlichen Abstand angibt, der zwischen den Graphem des Textes hinzugefügt werden soll (in Pango-Einheiten).

  `Rise`
    Erstellt ein neues Attribut für die Grundlinienverschiebung. Sie müssen ein zusätzliches Argument übergeben, das den Betrag angibt, um den der Text vertikal verschoben werden soll, in Pango-Einheiten. Positive Werte verschieben den Text nach oben.

  `Scale`
    Erstellt ein neues Skalierungsattribut für die Schriftgröße. Die Größe der Basisschriftart für den betroffenen Text wird mit dem Skalierungsfaktor multipliziert, der als zusätzliches Argument an dieses Attribut übergeben wird.

  `Shape`
    Erstellt ein neues Formattribut. Eine Form wird verwendet, um dem Ergebnis der Formung einer bestimmten Glyphe eine bestimmte Einfärbung und ein logisches Rechteck aufzuerlegen. Dies kann beispielsweise zum Einbetten eines Bildes oder eines Widgets in ein Pango-Layout verwendet werden. Sie müssen zwei zusätzliche Tabellenargumente übergeben: Das erste ist das Einfärberechteck, das jedem Zeichen zugewiesen wird, das zweite ist das logische Rechteck, das jedem Zeichen zugewiesen wird. Beide Argumente müssen Tabellen mit den initialisierten Feldern `x`, `y`, `width` und `height` sein. Darüber hinaus können Sie ein optionales drittes Argument übergeben, das als Benutzerdaten gilt und einen beliebigen Typ haben kann.

  `Show`
    Erstellt ein neues Attribut, das beeinflusst, wie unsichtbare Zeichen dargestellt werden. Sie müssen ein zusätzliches Argument übergeben, das auf eines der folgenden Flags gesetzt werden kann:

    `#PANGO_SHOW_NONE`
      Keine Sonderbehandlung für unsichtbare Zeichen.
    `#PANGO_SHOW_SPACES`
      Macht Leerzeichen, Tabulatoren und Zeilenumbrüche sichtbar.
    `#PANGO_SHOW_LINE_BREAKS`
      Macht Zeilenumbrüche sichtbar.
    `#PANGO_SHOW_IGNORABLES`
      Macht standardmäßig ignorierbare Unicode-Zeichen sichtbar.

  `Size`
    Erstellt ein neues Schriftgrößenattribut in Bruchteilen. Sie müssen ein zusätzliches Argument übergeben, das die Schriftgröße in #PANGO_SCALE-teln eines Punktes angibt.

  `SizeAbsolute`
    Erstellt ein neues Schriftgrößenattribut in Gerätepunkten. Sie müssen ein zusätzliches Argument übergeben, das die Schriftgröße in #PANGO_SCALE-teln einer Geräteeinheit angibt.

  `Stretch`
    Erstellt ein neues Attribut zur Dehnung der Schriftart. Sie müssen ein zusätzliches Argument übergeben, das den Schriftart-Dehnungsmodus angibt. Eine Liste der Pango-Dehnungsmodi finden Sie unter pfontdesc:SetStretch().

  `Strikethrough`
    Erstellt ein neues Durchgestrichen-Attribut. Sie müssen ein zusätzliches boolesches Argument übergeben, das angibt, ob der Text durchgestrichen werden soll.

  `StrikethroughColor`
    Erstellt ein neues durchgestrichenes Farbattribut. Sie müssen die drei zusätzlichen Argumente `red`, `green`, `blue` übergeben, die die durchgestrichene Farbe angeben und für jeden Wert zwischen 0 und 65535 liegen müssen.

  `Style`
    Erstellt ein neues Stilattribut für die Schriftartschräge. Sie müssen ein zusätzliches Argument übergeben, das den Schriftschnittstil angibt. Eine Liste der Pango-Stile finden Sie unter pfontdesc:SetStyle().

  `Underline`
    Erstellt ein neues Attribut im Unterstreichungsstil. Sie müssen ein zusätzliches Argument übergeben, das den Unterstreichungsstil angibt. Die folgenden Unterstreichungsstile werden derzeit unterstützt:

    `#PANGO_UNDERLINE_NONE`
      Es sollte keine Unterstreichung gezeichnet werden.
    `#PANGO_UNDERLINE_SINGLE`
      Es sollte eine einzelne Unterstreichung gezeichnet werden.
    `#PANGO_UNDERLINE_DOUBLE`
      Es sollte eine doppelte Unterstreichung gezeichnet werden.
    `#PANGO_UNDERLINE_LOW`
      Eine einzelne Unterstreichung sollte an einer Position unterhalb der Freihandbereiche des zu unterstreichenden Textes gezeichnet werden. Dies sollte nur zum Unterstreichen einzelner Zeichen verwendet werden, beispielsweise für Tastaturkürzel. `#PANGO_UNDERLINE_SINGLE` sollte für längere Textteile verwendet werden.
    `#PANGO_UNDERLINE_ERROR`
      Unten sollte ein Unterstrich gezeichnet werden, der auf einen Fehler hinweist. Der genaue Darstellungsstil hängt vom verwendeten PangoRenderer ab, typische Stile umfassen jedoch wellenförmige oder gepunktete Linien. Diese Unterstreichung wird normalerweise verwendet, um auf einen Fehler wie etwa einen möglichen Schreibfehler hinzuweisen. In einigen Fällen kann automatisch eine Kontrastfarbe verwendet werden.
    `#PANGO_UNDERLINE_SINGLE_LINE`
      Wie PANGO_UNDERLINE_SINGLE, jedoch kontinuierlich über mehrere Läufe hinweg gezeichnet.
    `#PANGO_UNDERLINE_DOUBLE_LINE`
      Wie PANGO_UNDERLINE_DOUBLE, jedoch kontinuierlich über mehrere Läufe hinweg gezeichnet.
    `#PANGO_UNDERLINE_ERROR_LINE`
      Wie PANGO_UNDERLINE_ERROR, aber kontinuierlich über mehrere Läufe hinweg gezeichnet.

  `UnderlineColor`
    Erstellt ein neues Unterstreichungsfarbattribut. Sie müssen die drei zusätzlichen Argumente `red`, `green`, `blue` übergeben, die die Unterstreichungsfarbe angeben und für jeden Wert zwischen 0 und 65535 liegen müssen.

  `Variant`
    Erstellt ein neues Schriftartvariantenattribut. Sie müssen ein zusätzliches Argument übergeben, das den Stil der Schriftartvariante angibt. Eine Liste der Pango-Varianten finden Sie unter pfontdesc:SetVariant().

  `Weight`
    Erstellt ein neues Attribut für die Schriftstärke. Sie müssen ein zusätzliches Argument übergeben, das die Schriftstärke angibt. Dies kann eine Zahl oder eine der vordefinierten Schriftstärken sein. Eine Liste der Pango-Schriftstärken finden Sie unter pfontdesc:SetWeight().

  Diese Funktion gibt das neu zugewiesene Pango-Attribut zurück, das mit pattribute:Free() gelöscht werden sollte.

Eingaben
  Keine

Rückgabewerte
  attr
    das neu zugewiesene Pango-Attribut

Navigation zeigen