※この翻訳ドキュメントはスクリプトによって出力・同期されています。内容が怪しそうな場合はGitHubにissueを追加したり英語の原文の確認をお願いします。

text_align_last 属性

このページではテキスト関係のtext_align_last属性について説明します。

属性の概要

text_align_last属性では最終行の行揃えの設定の更新もしくは取得を行えます。

基本的な使い方

getterとsetterの各インターフェイスの型はap.CssTextAlignLastのenumの値となります。

指定できるenumの値は以下の通りです:

  • CssTextAlignLast.AUTO (デフォルト)

  • CssTextAlignLast.LEFT

  • CssTextAlignLast.CENTER

  • CssTextAlignLast.RIGHT

  • CssTextAlignLast.JUSTIFY

CssTextAlignLast.AUTOの例

特記事項: この設定はデフォルトの設定です。

CssTextAlignLast.AUTO設定(挙動)はtext_alignの設定を継承します。

例えば、もしtext_align設定がCssTextAlign.CENTERの場合にはtext_align_last属性も中央寄せとして振る舞います。

import apysc as ap

stage: ap.Stage = ap.Stage(
    background_color=ap.Color("#333"),
    stage_width=350,
    stage_height=170,
    stage_elem_id="stage",
)
multi_line_text: ap.MultiLineText = ap.MultiLineText(
    text="Lorem ipsum dolor sit amet, consectetur adipiscing elit, "
    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
    "Ut enim ad minim veniam",
    width=300,
    font_size=16,
    fill_color=ap.Color("#00aaff"),
    x=25,
    y=25,
)
multi_line_text.text_align = ap.CssTextAlign.CENTER
multi_line_text.text_align_last = ap.CssTextAlignLast.AUTO

ap.save_overall_html(dest_dir_path="./css_text_align_last_auto/")

CssTextAlignLast.LEFTの例

import apysc as ap

stage: ap.Stage = ap.Stage(
    background_color=ap.Color("#333"),
    stage_width=350,
    stage_height=170,
    stage_elem_id="stage",
)
multi_line_text: ap.MultiLineText = ap.MultiLineText(
    text="Lorem ipsum dolor sit amet, consectetur adipiscing elit, "
    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
    "Ut enim ad minim veniam",
    width=300,
    font_size=16,
    fill_color=ap.Color("#00aaff"),
    x=25,
    y=25,
)
multi_line_text.text_align = ap.CssTextAlign.JUSTIFY
multi_line_text.text_align_last = ap.CssTextAlignLast.LEFT

ap.save_overall_html(dest_dir_path="./css_text_align_last_left/")

CssTextAlignLast.CENTERの例

import apysc as ap

stage: ap.Stage = ap.Stage(
    background_color=ap.Color("#333"),
    stage_width=350,
    stage_height=170,
    stage_elem_id="stage",
)
multi_line_text: ap.MultiLineText = ap.MultiLineText(
    text="Lorem ipsum dolor sit amet, consectetur adipiscing elit, "
    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
    "Ut enim ad minim veniam",
    width=300,
    font_size=16,
    fill_color=ap.Color("#00aaff"),
    x=25,
    y=25,
)
multi_line_text.text_align = ap.CssTextAlign.JUSTIFY
multi_line_text.text_align_last = ap.CssTextAlignLast.CENTER

ap.save_overall_html(dest_dir_path="./css_text_align_last_center/")

CssTextAlignLast.RIGHTの例

import apysc as ap

stage: ap.Stage = ap.Stage(
    background_color=ap.Color("#333"),
    stage_width=350,
    stage_height=170,
    stage_elem_id="stage",
)
multi_line_text: ap.MultiLineText = ap.MultiLineText(
    text="Lorem ipsum dolor sit amet, consectetur adipiscing elit, "
    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
    "Ut enim ad minim veniam",
    width=300,
    font_size=16,
    fill_color=ap.Color("#00aaff"),
    x=25,
    y=25,
)
multi_line_text.text_align = ap.CssTextAlign.JUSTIFY
multi_line_text.text_align_last = ap.CssTextAlignLast.RIGHT

ap.save_overall_html(dest_dir_path="./css_text_align_last_right/")

CssTextAlignLast.JUSTIFYの例

特記事項: このenumの設定は最終行のテキストを均等に行揃えします。

import apysc as ap

stage: ap.Stage = ap.Stage(
    background_color=ap.Color("#333"),
    stage_width=350,
    stage_height=170,
    stage_elem_id="stage",
)
multi_line_text: ap.MultiLineText = ap.MultiLineText(
    text="Lorem ipsum dolor sit amet, consectetur adipiscing elit, "
    "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
    "Ut enim ad minim veniam",
    width=300,
    font_size=16,
    fill_color=ap.Color("#00aaff"),
    x=25,
    y=25,
)
multi_line_text.text_align = ap.CssTextAlign.JUSTIFY
multi_line_text.text_align_last = ap.CssTextAlignLast.JUSTIFY

ap.save_overall_html(dest_dir_path="./css_text_align_last_justify/")

text_align_last 属性のAPI

特記事項: このAPIドキュメントはドキュメントビルド用のスクリプトによって自動で生成・同期されています。そのためもしかしたらこの節の内容は前節までの内容と重複している場合があります。

[インターフェイス概要]

text-align-last属性の値を取得します。


[返却値]

  • text_align_last: CssTextAlignLast

    • text-align-last属性の値。


[コードサンプル]

>>> import apysc as ap
>>> stage: ap.Stage = ap.Stage(
...     background_color=ap.Color("#333"),
...     stage_width=350,
...     stage_height=170,
...     stage_elem_id="stage",
... )
>>> multi_line_text: ap.MultiLineText = ap.MultiLineText(
...     text="Lorem ipsum dolor sit amet, consectetur adipiscing elit, "
...     "sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. "
...     "Ut enim ad minim veniam",
...     width=300,
...     font_size=16,
...     fill_color=ap.Color("#00aaff"),
...     x=25,
...     y=25,
... )
>>> multi_line_text.text_align = ap.CssTextAlign.JUSTIFY
>>> multi_line_text.text_align_last = ap.CssTextAlignLast.RIGHT
>>> assert multi_line_text.text_align_last == ap.CssTextAlignLast.RIGHT