package

この記事の内容
  1. 詳細
  2. selector()
  3. image_selector()
  4. resources
  5. メソッド
  6. get_text()
  7. get_bytes()
  8. copy_to()
  9. add_to_clipboard()

以下のURL、ページタイトル、ウィンドウ名、要素名は説明用の例です。実際に操作する環境の値に置き換えてください。要素ライブラリに登録する名前も、コード内の指定と一致させてください。

packageモジュールは、各種要素(Webページ要素、ソフトウェア要素、画像要素)の取得や、リソースファイルの読み書きなどの操作に使用します。

詳細

packageモジュールの内部は、要素セレクター(selector)、画像セレクター(image_selector)、リソースファイルオブジェクト(resources)の3種類のオブジェクトで構成されています。

selector()

要素名に基づいて要素セレクターオブジェクトを返します。要素セレクターとは、要素ライブラリにキャプチャしたWebページ要素またはソフトウェア要素を指します。def selector(name)メソッドで指定した要素を取得できます。

def selector(name)

入力パラメータ

name:セレクター名です。要素ライブラリ内の要素の名称を指定します。

戻り値

Selector:要素セレクターオブジェクトです。要素名で指定した要素を返します。

例1

from .package import *
def main(args):
    # ここで「検索ボタン」は、要素ライブラリ内の「検索ボタン」という名前のWebページ要素を指します。
    selector = package.selector('検索ボタン')
    print(selector)

この例の実行ロジック: 「検索ボタン」という名前のWebページ要素を取得します--> その要素オブジェクトを出力します。

image_selector()

画像ライブラリ内の画像要素の名称に基づいて画像セレクターオブジェクトを返します。

def image_selector(name)

パラメータ

name:画像セレクター名です。画像ライブラリ内の画像要素の名称を指定します。

戻り値

ImageSelector:画像セレクターオブジェクトです。画像要素名で指定した要素を返します。

例1

from .package import *
def main(args):
    selector = package.image_selector('图像1') #ここで「图像1」は、画像ライブラリ内の「图像1」という名前の画像要素を指します。

この例の実行ロジック: 「图像1」という名前の画像要素を取得します--> その画像要素を出力します。

resources

リソースファイルオブジェクトです。package.resourcesを呼び出してリソースファイルオブジェクトを取得し、リソースファイルの読み書きを行います。

メソッド

get_text()

リソースファイルのテキスト内容を取得します。

def get_text(self, filename, encoding='utf-8')

入力パラメータ

filename:リソースファイル名です。

encoding:ファイルを読み込む際のエンコーディング形式です。指定しない場合は、デフォルトで utf-8 形式で読み込みます。

戻り値

str:リソースファイルのテキスト内容を返します。

例1

リソースファイル 123.txt のテキスト内容を、utf-8 のエンコーディング形式で読み込みます。

from . import package
def main(args):
    text = package.resources.get_text('123.txt')
    print(text)

この例の実行ロジック: "123.txt" という名前のリソースファイルの内容を読み込みます--> その内容を出力します。

get_bytes()

リソースファイルのバイナリ情報を取得します。

get_bytes(self, filename)

入力パラメータ

filename:リソースファイル名です。

戻り値

byte:リソースファイルのバイナリ情報を返します。

例1

from . import package
def main(args):
    value = package.resources.get_bytes('123.txt') #出力結果はバイナリ形式で返されます。
    print(value)

この例の実行ロジック: "123.txt" という名前のリソースファイルの内容をバイナリ形式で読み込みます--> そのバイナリ内容を出力します。

copy_to()

リソースファイルの内容をコピー先のファイルにコピーします。

copy_to(self, filename, dest_filename)

入力パラメータ

filename:リソースファイル名です。

dest_filename:リソースファイル内容の最終的なコピー先です(ファイルの絶対パスを指定します。例:"D:\123.txt")。

戻り値

なし

例1

from . import package
def main(args):
    package.resources.copy_to('123.txt', 'D:\\aaa.txt')

この例の実行ロジック: "123.txt" という名前のリソースファイルをローカルのDドライブにコピーし、"aaa.txt" に名前を変更します。

add_to_clipboard()

リソースをクリップボードに追加します。

add_to_clipboard(self, filenames)

入力パラメータ

filenames:リソースファイル名のリストです(必ず注意してください!)。例:['123.txt', '234.xml']

戻り値

なし

例1

from . import package
def main(args):
    package.resources.add_to_clipboard(['123.txt', '234.xml'])

この例の実行ロジック: "123.txt"、"234.xml" という名前のリソースファイルをクリップボードにコピーします。

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