package
以下の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" という名前のリソースファイルをクリップボードにコピーします。