拖拽行为¶

: DragBehavior mixin 类提供了拖拽行为。当与一个部件结合使用时，在由 drag_rectangle 定义的矩形区域内进行拖拽将移动该部件。

示例¶

以下示例创建了一个可拖动的标签：

from kivy.uix.label import Label
from kivy.app import App
from kivy.uix.behaviors import DragBehavior
from kivy.lang import Builder

# You could also put the following in your kv file...
kv = '''
<DragLabel>:
    # Define the properties for the DragLabel
    drag_rectangle: self.x, self.y, self.width, self.height
    drag_timeout: 10000000
    drag_distance: 0

FloatLayout:
    # Define the root widget
    DragLabel:
        size_hint: 0.25, 0.2
        text: 'Drag me'
'''


class DragLabel(DragBehavior, Label):
    pass


class TestApp(App):
    def build(self):
        return Builder.load_string(kv)

TestApp().run()

class kivy.uix.behaviors.drag.DragBehavior(**kwargs)[源代码]¶

基类：object

DragBehavior mixin 提供了拖拽行为。当与一个部件结合时，在由 drag_rectangle 定义的矩形内进行拖拽将移动该部件。更多信息请参阅 拖拽行为模块 的文档。

在 1.8.0 版本加入.

drag_distance¶

拖动 DragBehavior 之前需要移动的距离，单位为像素。一旦达到该距离，DragBehavior 将开始拖动，并且不会向子组件派发触摸事件。建议您根据目标设备屏幕的 dpi 来设定此值。

drag_distance 是一个 NumericProperty，默认值等于用户 Config 中定义的 `scroll_distance`（默认为 20 像素）。

drag_rect_height¶

允许拖拽的轴对齐边界矩形的高度。

drag_rect_height 是一个 NumericProperty，默认值为 100。

drag_rect_width¶

允许拖拽的轴对齐边界矩形的宽度。

drag_rect_width 是一个 NumericProperty，默认值为 100。

drag_rect_x¶

允许拖动的轴对齐边界矩形的X位置（以窗口坐标表示）。

drag_rect_x 是一个 NumericProperty，默认值为 0。

drag_rect_y¶

允许拖动的轴对齐边界矩形的Y坐标位置（以窗口坐标表示）。

drag_rect_Y 是一个 NumericProperty，默认值为 0。

drag_rectangle¶

允许拖动的轴对齐边界矩形的位置和大小。

drag_rectangle 是一个 ReferenceListProperty，由 (drag_rect_x, drag_rect_y, drag_rect_width, drag_rect_height) 属性组成。

drag_timeout¶

允许触发 drag_distance 的超时时间，单位为毫秒。如果用户在此超时时间内未移动 drag_distance，则拖拽将被禁用，触摸事件将分发给子组件。

drag_timeout 是一个 NumericProperty，默认值为用户 Config 中定义的 `scroll_timeout`（默认55毫秒）。

« 覆盖行为

Emacs 行为 »

Version

Quick search

目录

拖拽行为¶

示例¶