DragObject PDF Drukuj

Atrybuty

  • lockX - blokuje przesuwanie elementu w osi X
  • lockY - blokuje przesuwanie elementu w osi Y
  • threshold - próg przesunięcia (patrz Uwagi) (wartość domyślna: 0)
  • dragClass - klasa elementu ustawiana podczas przeciągania
  • hoverClass - klasa ustawiana po najechaniu kursorem na element
  • resize - rozszerzanie elementu zamiast przeciągania (wartość domyślna: false)
  • resizeCtrl - rozszerzanie elementu połączone z przeciąganiem; element rozszerzany jest w przypadku przyciśnięcia klawisza CTRL (wartość domyślna: false)
  • lockWidth - blokuje zmianę szerokości rozszerzanego elementu (wartość domyślna: false)
  • lockHeight - blokuje zmianę wysokości rozszerzanego elementu (wartość domyślna: false)
  • minWidth - minimalna szerokość rozszerzanego elementu (wartość domyślna: null)
  • maxWidth - maksymalna szerokość rozszerzanego elementu (wartość domyślna: null)
  • minHeight - minimalna wysokość rozszerzanego elementu (wartość domyślna: null)
  • maxHeight - maksymalna wysokość rozszerzanego elementu (wartość domyślna: null)
  • moveOnTop - przesuwa element na szczyt stosu (wartość domyślna: true)
  • stopPropagation - zatrzymuje przekazywanie zdarzeń elementom podrzędnym (wartość domyślna: false)
  • OnDrag(obj) - funkcja wywoływana podczas przeciągania elementu
    • obj - przeciągany element
  • OnDragStart(obj) - funkcja wywoływana podczas rozpoczęcia przeciągania elementu
    • obj - przeciągany element
  • OnDragStop(obj) - funkcja wywoływana podczas upuszczenia elementu
    • obj - przeciągany element
  • OnResize(obj) - funkcja wywoływana podczcas rozszerzania elementu
    • obj - rozszerzany element

Metody

  • SetBBox(obj) - ustawia pole ograniczające dla przeciąganego elementu
    • obj - identyfikator elementu lub element, ustawiany jako pole ograniczające; pominięcie tego parametru powoduje ustawienie elementu nadrzędnego jako pole ograniczające
  • RemoveBBox() - usuwa pole ograniczające
  • AddGrip(grip, [only]) - dodaje uchwyt za który można przeciągać element (uchwyt musi być elementem podrzędnym)
    • grip - identyfikator elementu lub element uchwytu
    • only - wartość true oznacza, że element przeciągany będzie tylko za pomocą uchwytu (wartość domyślna: false)
  • RemoveGrip(grip) - usuwa podany uchwyt
    • grip - identyfikator elementu lub element uchwytu

Uwagi

  • Domyślnie przeciąganie elementu rozpoczyna się od razu po kliknięciu, jeśli chcemy aby przeciąganie zostało rozpoczęte dopiero gdy kursor myszki znajdzie się w pewnej odległości od kliknięcia, ustawiamy tą odległość ("próg przesunięcia") jako wartość atrybutu threshold.
  • W przypadku wykorzystania efektu przesuwania na elemencie zarejestrowanym jako przeciągalny, należy zablokować przesuwanie danego elementu ustawiając wartość atrybutów lockX oraz lockY na true. Inaczej element będzie można chwycić podczas animacji przesuwania, co spowoduje że element po zakończeniu wykonywania animacji znajdzie się w innym miejscu niż tego oczekiwaliśmy.
  • Wartość null w atrybutach określajacych minimalną/maksymalną szerokość/wysokość rozszerzalnego elementu oznacza brak ograniczeń
 
« poprzedni artykuł   następny artykuł »