GDraggableObject
   API Google Maps version 2
   Référence et Guide du développeur en Français

Attention :

L'API Google Maps Javascript Version 2 a été officiellement déclarée obsolète le 19 mai 2010 par Google.

L'API Version 2 continuera cependant à fonctionner durant encore trois ans, à compter de cette date, conformément à la politique de dépréciation de Google.

Conlusion, si vous devez développer une application aujourd'hui utilisez d'ores et déjà la version 3 de l'API Google Maps Javascript ( cela vous évitera d'avoir à tout recommencer ou à tout repayer dans 3 ans ! ) ou migrez votre application actuelle vers la version 3.

La classe GDraggableObject

Cette classe rend un élément du DOM déplaçable à l'aide de la souris.

Les méthodes statiques utilisées pour modifier l'apparence du curseur lors du glissement d'un objet, affectent tous les objets déplaçables créés par la suite, tels que la carte, curseur permettant de contrôler le niveau de zoom, etc.

Par exemple, avant de créer la carte, vous pouvez appeler GDraggableObject.setDraggableCursor('default') et GDraggableObject.setDraggingCursor('move') pour obtenir le pré-API 2.56 style.

Sinon, le constructeur de la carte peut utiliser des paramètres optionnels afin de définir le style du curseur lié à un objet déplaçable DraggableObject .

Voir la spécification CSS du W3C pour connaitre les valeurs de curseur admissibles.

Constructeur

Constructeur

Description

GDraggableObject(src:Node, opts?:GDraggableObjectOptions)

Met en place un gestionnaire d'événements de sorte que l'élément source peut être déplacé par glissement à l'aide de la souris.

Les options left et top positionnent l'élément, et l'option container sert de zone de délimitation ou conteneur.

Depuis la version 2.59

Haut de page

Méthodes statiques

Méthode

Valeur retournée

Description

GDraggableObject.setDraggableCursor(cursor:String)

Aucune

Défini l'apparence du curseur lorsqu'il survole un objet susceptible d'être déplacé par glissement à l'aide de la souris.

Depuis la version 2.59

GDraggableObject.setDraggingCursor(cursor:String)

Aucune

Défini l'apparence du curseur lorsque l'objet sélectionné est en cours de déplacement par glissement à l'aide de la souris.

Depuis la version 2.59

GDraggableObject.getDraggingCursor()

Chaîne

Retourne le curseur actuellement utilisé par la carte pour indiquer son déplacement par glissement .

S'il n'est pas défini par la méthode statique setDraggingCursor(), elle retourne le curseur utilisé par défaut pour la carte, les contrôles et les marqueurs.

Déconseillé depuis la version 2.164

GDraggableObject.getDraggableCursor()

Chaîne

Retourne le curseur actuellement utilisé par la carte pour indiquer qu'elle est déplaçable.

S'il n'est pas défini par la méthode statique setDraggableCursor(), elle retourne le curseur par défaut utilisé par la carte pour ses contrôles et ses marqueurs.

Déconseillé depuis la version 2.164

Haut de page

Méthodes

Méthode

Valeur retournée

Description

setDraggableCursor(cursor:String)

Aucune

Défini l'aspect du curseur lorsque le curseur de la souris est placé sur cet objet déplaçable.

Depuis la version 2.59

setDraggingCursor(cursor:String)

Aucune

Défini l'aspect du curseur lorsque le bouton de la souris est maintenu enfoncé, pour faire glisser cet objet déplaçable.

Depuis la version 2.59

moveTo(point:GPoint)

Aucune

Déplace l'objet déplaçable GDraggableObject vers une position absolue donnée.

La position est indiquée à l'aide des coordonnées du pixel par rapport au noeud parent.

Cette méthode utilise le système de coordonnées DOM, c'est à dire les coordonnées X augmentent en allant vers la gauche, et les coordonnées Y augmentent en allant vers le bas.

Depuis la version 2.89

moveBy(size:GSize)

Aucune

Déplace l'objet déplaçable GDraggableObject en le décalant à l'aide d'un objet GSize.

Cette méthode utilise le système de coordonnées DOM, à savoir la largeur croit vers la gauche, et la hauteur croit depui le bas.

Depuis la version 2.89

Haut de page

Évènements

Évènements

Description

mousedown()

Cet événement est déclenché en réponse à l'événement DOM mousedown.

La gestion de cet événement permettra d'éviter l'action par défaut de l'événement DOM mousedown.

Depuis la version 2.84

mouseup()

Cet événement est déclenché en réponse à l'événement DOM mouseup sur un objet déplaçable.

La gestion de cet événement permettra d'éviter l'action par défaut de l'événement DOM mouseup.

Depuis la version 2.84

click()

Cet événement est déclenché lorsqu' un objet déplaçable est cliqué.

Depuis la version 2.84

dragstart()

Cet événement est déclenché au début de l'événement glisser d'un objet déplaçable (lorsque l'utilisateur lance un déplacement par glissement en cliquant sur un objet déplaçable puis en le faisant glisser).

Depuis la version 2.84

drag()

Cet événement est déclenché à plusieurs reprises tant que l'utilisateur fait glisser l'objet déplaçable.

Depuis la version 2.84

dragend()

Cet événement est déclenché à la fin de l'événement glisser un objet déplaçable (lorsque l'utilisateur termine le déplacement par glissement de l'objet en relachant le bouton de sa souris).

Depuis la version 2.84

Haut de page


Ceci est une traduction non officielle de "Google Maps API Reference version 2".

La version originale, en Anglais, se situe ici : Google Maps API Reference version 2 #GDraggableObject.

| | © 2010 | Référence Google Maps API Version 2 en Français |