xbot.win32.screensaver

この記事の内容
  1. メソッド
  2. open_screen_saver()
  3. append_screen_saver_text()
  4. clear()
  5. close()

主に画面保護を操作します。画面保護は、画面を覆ったり、画面上にカスタムテキストを表示したりするために使用できます。Dr.Roboの画面保護の開始と終了、画面保護に表示するテキストの設定とクリアなどの操作が含まれます。

メソッド

open_screen_saver()

画面保護を開始

open_screen_saver( settings = None, default_text = None )

パラメータ

settings:画面保護をカスタマイズするための設定JSONです(ビジュアル編集の「画面保護を開始」コマンドの編集画面から直接コピーできます)。JSONには、画面保護と画面保護にデフォルトで表示するテキストの設定が含まれます。JSONの構造は次のとおりです。

{
            "bounding":{
                "left":0,
                "top":0,
                "width":0,
                "height":0
            },
            "background":{
                "color":16777215,
                "opacity":0.1
            },
            "blur":true,
            "font":{
                "family":"微软雅黑",
                "size":48,
                "style":"normal",
                "weight":450,
                "foreground":59850237
            }
        }
  • "bounding":画面保護の領域設定です。"left"(位置の横座標)、"top"(位置の縦座標)、"width"(領域の幅(px))、"height"(領域の高さ(px))を設定できます。
  • "background":画面保護の背景設定です。設定できるパラメータは、"color"(背景色)と"opacity"(背景色の透明度)です。
  • "blur":すりガラス効果を使用するかどうかを指定します。
  • "font":画面保護にデフォルトで表示するテキストのスタイル設定です。family(フォント)、size(フォントサイズ)、style(書体)、weight(太さ)、foreground(文字色)を設定できます。

default_text:Dr.Roboの画面保護を開始したときに表示するデフォルトのテキストです。デフォルト値はNoneです。

戻り値

なし

例1

from xbot import win32,sleep


def main(args):
    win32.screensaver.open_screen_saver()
    sleep(3)

この例の実行ロジック: Dr.Roboの画面保護をデフォルト設定で開始します。画面保護はモニターに3s表示された後、消えます。

例2

from xbot import win32,sleep


def main(args):
    win32.screensaver.open_screen_saver(default_text="Dr.Roboが作業を進めています マウスを少し休ませましょう...")
    sleep(3)

この例の実行ロジック: 画面保護をデフォルト設定で開始し、画面保護にデフォルトで表示するカスタムテキストを「Dr.Roboが作業を進めています マウスを少し休ませましょう...」に設定します。画面保護はモニターに 3s 表示された後、消えます。

例3

from xbot import win32


def main(args):
    win32.screensaver.open_screen_saver(
        settings={
                    "bounding": {
                        "left": 256.0,
                        "top": 0.0,
                        "width": 1024.0,
                        "height": 172.0
                    },
                    "background": {
                        "color": 16777215,
                        "opacity": 0.1
                    },
                    "blur": True,
                    "font": {
                        "family": "微软雅黑",
                        "size": 48.0,
                        "style": "normal",
                        "weight": 450,
                        "foreground": 5985023
                    }
                },
        default_text="Dr.Roboが作業を進めています マウスを少し休ませましょう...")


    sleep(3)

この例の実行ロジック: 画面保護を開始し、画面保護とデフォルトで表示するテキストのスタイルをカスタマイズします。画面保護はモニターに3s表示された後、消えます。

append_screen_saver_text()

画面保護にテキストを追加

append_screen_saver_text(text, , settings = None)

入力パラメータ

text:Dr.Roboの画面保護に表示するテキストを設定します。

settings:画面保護のテキストの表示設定をカスタマイズするためのJSON文字列です(ビジュアル編集の「画面保護にテキストを追加」コマンドの編集画面から直接コピーできます)。JSONの構造は次のとおりです。

{
            "family":"微软雅黑",
            "size":48,
            "style":"normal",
            "weight":450,
            "foreground":5985023
        }

settingsのJSONの説明

パラメータ 説明
family フォント
size フォントサイズ
style 書体
weight 太さ
foreground 文字色

settingsのJSONの説明

パラメータ 説明
family フォント
size フォントサイズ
style 書体
weight 太さ
foreground 文字色

戻り値

なし

例1

from xbot import win32,sleep


def main(args):
    win32.screensaver.open_screen_saver()
    win32.screensaver.append_screen_saver_text("繰り返しの作業を終わらせ 創造力を解き放ちましょう")
    sleep(3)

この例の実行ロジック: デフォルトの画面保護を開始し、画面保護に「繰り返しの作業を終わらせ 創造力を解き放ちましょう」というテキストを追加します。画面保護はモニターに3s表示された後、消えます。

例2

from xbot import win32,sleep


def main(args):
    win32.screensaver.open_screen_saver(default_text="Dr.Roboが作業を進めています マウスを少し休ませましょう...")
    win32.screensaver.append_screen_saver_text("繰り返しの作業を終わらせ 創造力を解き放ちましょう",
        settings={
                    "family": "Dubai Medium",
                    "size": 33,
                    "style": "normal",
                    "weight": 761,
                    "foreground": 255
                    })
    sleep(3)

この例の実行ロジック: デフォルトの画面保護を開始し、画面保護に「繰り返しの作業を終わらせ 創造力を解き放ちましょう」というテキストを追加し、新しく追加したテキストのスタイルをsettingsで指定します。画面保護はモニターに 3s 表示された後、消えます。

clear()

画面保護のテキストをクリア

clear()

入力パラメータ

なし

戻り値

なし

例

from xbot import win32,sleep


def main(args):
    win32.screensaver.open_screen_saver()
    win32.screensaver.append_screen_saver_text("繰り返しの作業を終わらせ 創造力を解き放ちましょう")
    sleep(2)
    win32.screensaver.clear()
    sleep(3)

この例の実行ロジック: デフォルトの画面保護を開始し、画面保護に「繰り返しの作業を終わらせ 創造力を解き放ちましょう」というテキストを続けて2回追加します。2s 表示した後、画面保護のすべてのテキストをクリアします。その後、画面保護はモニターに 3s 表示された後、消えます。

close()

画面保護を終了

close()

入力パラメータ

なし

戻り値

なし

例

from xbot import win32,sleep


def main(args):
    win32.screensaver.open_screen_saver()
    sleep(2)
    win32.screensaver.close()

この例の実行ロジック: デフォルトの画面保護を開始し、2s 表示した後、Dr.Roboの画面保護を終了します。

APIリファレンスの記事一覧ページの先頭へ ↑