Runtime v2.81 · อัปเดต 30 ก.ย. 2569

OverlayText

วาดข้อความที่ด้านบนของหน้าจอด้วยการติดตามการโต้ตอบที่เป็นตัวเลือก (กด/ย้าย/กดค้างไว้) ชื่อตัวตั้งค่าเช่นข้อความ/พื้นหลังเป็นวิธีการ อ่านค่าปัจจุบันผ่าน state()

รูปแบบคำสั่ง

OverlayText(text="", position=(0, 0), color="#FFFFFFFF", size=16, background=None)

พารามิเตอร์สำหรับสร้างออบเจ็กต์

ชื่อคำอธิบาย
textString
Initial text content.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: ""
positionPoint | tuple[Number, Number]
Initial position as Point or tuple/list (x, y). Point carries scale/anchor metadata.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: (0, 0)
colorColor | String | Number
Initial text color.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: white
sizeNumber
Initial text size (sp).
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 16
backgroundColor | String | Number | None
Initial background color. None means transparent/no background.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

OverlayText

พฤติกรรม / ผลข้างเคียง

วาดข้อความที่ด้านบนของหน้าจอด้วยการติดตามการโต้ตอบที่เป็นตัวเลือก (กด/ย้าย/กดค้างไว้) ชื่อตัวตั้งค่าเช่นข้อความ/พื้นหลังเป็นวิธีการ อ่านค่าปัจจุบันผ่าน state()

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

badge = OverlayText("Running...", Point(320, 160, scale="width", anchor="top"), background=None)
badge.color("#FF00E676").background("#66000000").size(18).track(press=True, move=True, hold=True, hold_ms=700)
badge.show()

state = badge.state()
if state["status"] == 2:
    MacroPanel.notify("Badge is moving")

p = badge.get_point()
r = badge.get_region()
if r is not None:
    r.highlight("yellow", auto_hide_ms=600)

badge.hide()   # ซ่อนอย่างรวดเร็ว
badge.show()   # แสดงอีกครั้งอย่างรวดเร็ว
badge.off()    # ปล่อยทั้งหมด

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

ฟิลด์

ชื่อคำอธิบาย
xNumber
Top-left X position in pixels. Writable before show().
ค่าเริ่มต้น: 0
yNumber
Top-left Y position in pixels. Writable before show().
ค่าเริ่มต้น: 0
scaleString
Coordinate scale copied from Point positions.
ค่าเริ่มต้น: fixed
anchorString
Coordinate anchor copied from Point positions.
ค่าเริ่มต้น: none
argbColor
Text color. Assign with Color/string/number values. Use overlay.color(value) for method chaining.
ค่าเริ่มต้น: white
size_spNumber
Text size in sp. Use overlay.size(sp) for method chaining.
ค่าเริ่มต้น: 16
ตัวอย่างการสร้างออบเจ็กต์
badge = OverlayText("Ready", Point(420, 220, scale="width", anchor="top"), background=None)

เมธอด

13 เมธอด

OverlayText.off_all

ปิดและคืนทรัพยากรข้อความซ้อนทับทั้งหมดที่โฟลว์ปัจจุบันสร้าง โดยไม่กระทบโฟลว์ที่ทำงานขนานกัน

รูปแบบคำสั่ง

OverlayText.off_all()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

None — ไม่มีค่าส่งคืน

พฤติกรรม / ผลข้างเคียง

ปิดและคืนทรัพยากรข้อความซ้อนทับทั้งหมดที่โฟลว์ปัจจุบันสร้าง โดยไม่กระทบโฟลว์ที่ทำงานขนานกัน

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ปล่อยโอเวอร์เลย์ที่เป็นของโฟลว์นี้
a = OverlayText("Running", (24, 120))
a.show()
OverlayText.off_all()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.text

อัปเดตเนื้อหาข้อความที่แสดง

รูปแบบคำสั่ง

overlay.text(value)

พารามิเตอร์

ชื่อคำอธิบาย
valueString
Text content.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

OverlayText — ส่งคืนเครื่องมือสร้างข้อความซ้อนทับเดียวกัน

พฤติกรรม / ผลข้างเคียง

อัปเดตเนื้อหาข้อความที่แสดง

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.text("Running")
badge.show()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.color

อัปเดตสีข้อความ

รูปแบบคำสั่ง

overlay.color(value)

พารามิเตอร์

ชื่อคำอธิบาย
valueColor | String | Number
Color value.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

OverlayText — ส่งคืนเครื่องมือสร้างข้อความซ้อนทับเดียวกัน

พฤติกรรม / ผลข้างเคียง

อัปเดตสีข้อความ

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.color("#FF00E676")
badge.show()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.background

อัพเดตสีพื้นหลัง การผ่านไม่มีจะลบพื้นหลัง

รูปแบบคำสั่ง

overlay.background(value=None)

พารามิเตอร์

ชื่อคำอธิบาย
valueColor | String | Number | None
Background color, or None for transparent/no background.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

OverlayText — ส่งคืนเครื่องมือสร้างข้อความซ้อนทับเดียวกัน

พฤติกรรม / ผลข้างเคียง

อัพเดตสีพื้นหลัง การผ่านไม่มีจะลบพื้นหลัง

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.background("#66000000")
badge.show()
badge.background(None)

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.size

อัปเดตขนาดตัวอักษร (sp)

รูปแบบคำสั่ง

overlay.size(sp)

พารามิเตอร์

ชื่อคำอธิบาย
spNumber
Text size in sp.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

OverlayText — ส่งคืนเครื่องมือสร้างข้อความซ้อนทับเดียวกัน

พฤติกรรม / ผลข้างเคียง

อัปเดตขนาดตัวอักษร (sp)

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.size(20)
badge.show()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.position

อัปเดตตำแหน่งการวาดด้วย Point หรือ tuple/list (x, y) จุดมีข้อมูลเมตามาตราส่วน/จุดยึด

รูปแบบคำสั่ง

overlay.position(position)

พารามิเตอร์

ชื่อคำอธิบาย
positionPoint | tuple[Number, Number]
New position.
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น

ค่าที่ส่งกลับ

OverlayText — ส่งคืนเครื่องมือสร้างข้อความซ้อนทับเดียวกัน

พฤติกรรม / ผลข้างเคียง

อัปเดตตำแหน่งการวาดด้วย Point หรือ tuple/list (x, y) จุดมีข้อมูลเมตามาตราส่วน/จุดยึด

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.position((80, 160))
badge.show()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.track

กำหนดค่าการติดตามการโต้ตอบ หากธงทั้งหมดเป็นเท็จ ข้อความจะคงอยู่ที่ตำแหน่งที่ประกาศไว้

รูปแบบคำสั่ง

overlay.track(press=False, move=False, hold=False, hold_ms=600)

พารามิเตอร์

ชื่อคำอธิบาย
pressBoolean
Track press/release state.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: False
moveBoolean
Allow user drag to move text.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: False
holdBoolean
Track hold state.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: False
hold_msNumber
Hold threshold to treat interaction as holding, measured in milliseconds.
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 600

ค่าที่ส่งกลับ

OverlayText — ส่งคืนเครื่องมือสร้างข้อความซ้อนทับเดียวกัน

พฤติกรรม / ผลข้างเคียง

กำหนดค่าการติดตามการโต้ตอบ หากธงทั้งหมดเป็นเท็จ ข้อความจะคงอยู่ที่ตำแหน่งที่ประกาศไว้

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.track(press=True, move=True, hold=True, hold_ms=700)
badge.show()
print(badge.state())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.get_point

รับจุดซ้ายบนปัจจุบันของข้อความซ้อนทับนี้ ตำแหน่งนี้ได้รับการอัปเดตหลังจากการลากย้าย

รูปแบบคำสั่ง

overlay.get_point()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Point — ตำแหน่งการซ้อนทับปัจจุบันในพิกเซลของหน้าจอ

พฤติกรรม / ผลข้างเคียง

รับจุดซ้ายบนปัจจุบันของข้อความซ้อนทับนี้ ตำแหน่งนี้ได้รับการอัปเดตหลังจากการลากย้าย

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.show()
point = badge.get_point()
print(point.x, point.y)

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.get_region

รับขอบเขตที่ล้อมรอบขอบเขตข้อความซ้อนทับปัจจุบัน คืนค่า "ไม่มี" เมื่อมองไม่เห็นการซ้อนทับหรือยังไม่ได้วัด

รูปแบบคำสั่ง

overlay.get_region()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

Region? — ขอบเขตขอบเขตสำหรับข้อความซ้อนทับ หรือไม่มี ตรวจสอบไม่มีทุกครั้งก่อนใช้ภูมิภาค

พฤติกรรม / ผลข้างเคียง

รับขอบเขตที่ล้อมรอบขอบเขตข้อความซ้อนทับปัจจุบัน คืนค่า "ไม่มี" เมื่อมองไม่เห็นการซ้อนทับหรือยังไม่ได้วัด

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.show()
bounds = badge.get_region()
if bounds is not None:
    print(bounds.width, bounds.height)

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.show

แสดงการซ้อนทับข้อความ (หรือแสดงอีกครั้งหลังจากซ่อน ())

รูปแบบคำสั่ง

overlay.show()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

dict — พจนานุกรมสถานะซ้อนทับปัจจุบัน

พฤติกรรม / ผลข้างเคียง

แสดงการซ้อนทับข้อความ (หรือแสดงอีกครั้งหลังจากซ่อน ())

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
print(badge.show())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.hide

ซ่อนข้อความซ้อนทับ แต่เก็บมุมมองแคชไว้เพื่อให้แสดงได้เร็วขึ้น ()

รูปแบบคำสั่ง

overlay.hide()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

dict — พจนานุกรมสถานะซ้อนทับปัจจุบัน

พฤติกรรม / ผลข้างเคียง

ซ่อนข้อความซ้อนทับ แต่เก็บมุมมองแคชไว้เพื่อให้แสดงได้เร็วขึ้น ()

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.show()
badge.hide()
badge.show()

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.off

ปิดข้อความซ้อนทับและเผยแพร่ทรัพยากร

รูปแบบคำสั่ง

overlay.off()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

dict — พจนานุกรมสถานะซ้อนทับปัจจุบัน

พฤติกรรม / ผลข้างเคียง

ปิดข้อความซ้อนทับและเผยแพร่ทรัพยากร

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.show()
print(badge.off())

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง

OverlayText.state

คืนสถานะการโต้ตอบปัจจุบัน แผนที่สถานะ: 0=IDLE, 1=PRESSED, 2=MOVING, 3=HOLDING, 4=RELEASED, 5=HIDDEN, 6=OFF.

รูปแบบคำสั่ง

overlay.state()

พารามิเตอร์

ไม่มี

ค่าที่ส่งกลับ

dict — พจนานุกรมระบุสถานะพร้อม status/status_label ธงการติดตาม และความกว้าง/ความสูงของการซ้อนทับเสริมเป็นพิกเซล

พฤติกรรม / ผลข้างเคียง

คืนสถานะการโต้ตอบปัจจุบัน แผนที่สถานะ: 0=IDLE, 1=PRESSED, 2=MOVING, 3=HOLDING, 4=RELEASED, 5=HIDDEN, 6=OFF. การอ่าน state() รีเซ็ตอัตโนมัติ PRESSED และ RELEASED กลับไปที่ IDLE สำหรับการสำรวจครั้งถัดไป การย้ายและการถือครองไม่ได้รีเซ็ตอัตโนมัติ

การทำงาน

  • รอให้เสร็จ: ขึ้นอยู่กับเงื่อนไข
  • ความปลอดภัยเมื่อทำงานพร้อมกัน: ใช้วัตถุแยกสำหรับแต่ละโฟลว์
  • การทำงานแบบขนาน: ขึ้นอยู่กับเงื่อนไข

แต่ละโฟลว์เป็นเจ้าของ id โอเวอร์เลย์ของตน off_all() ปล่อยเฉพาะโอเวอร์เลย์ของโฟลว์นั้น งาน UI ส่งไปที่ Android Main และอาจพักผู้เรียก เก็บบิลเดอร์โอเวอร์เลย์ที่เปลี่ยนค่าได้ในโฟลว์เจ้าของ

ตัวอย่าง

# ตั้งค่าหรือตรวจสอบโอเวอร์เลย์ของโฟลว์นี้
badge = OverlayText("Ready", (24, 120))
badge.track(press=True, move=True)
badge.show()
state = badge.state()
print(state["status_label"])

ข้อผิดพลาด / ข้อจำกัด

ไม่มีข้อจำกัดเพิ่มเติมที่ระบุไว้ ให้ปฏิบัติตามพารามิเตอร์และพฤติกรรมข้างต้น

API ที่เกี่ยวข้อง