U-X > XMLSocket.onConnect

XMLSocket.onConnect

Disponibilité

Flash Player 5.

Usage

monSocketXML.onConnect(succès)

Paramètres

succès Une valeur booléenne indiquant si une connexion socket a été établie avec succès (true ou false).

Renvoie

Rien.

Description

Méthode ; une fonction de rappel invoquée par Flash Player lorsqu'une requête de connexion initiée par la méthode XMLSocket.connect a réussi ou échoué. Si la connexion a réussi, le paramètre succès est true ; sinon, le paramètre succès est false.

L'implémentation par défaut de cette méthode n'effectue aucune action. Pour avoir la priorité sur l'implémentation par défaut, vous devez affecter une fonction contenant vos propres actions.

Exemple

L'exemple suivant illustre le processus de spécification d'une fonction de remplacement pour la méthode onConnect dans une simple application de dialogue en ligne.

La fonction contrôle l'écran auquel les utilisateurs sont dirigés selon que la connexion a été établie avec succès ou non. Si la connexion est établie avec succès, les utilisateurs sont dirigés vers l'écran de dialogue principal de l'image nommée startChat. Si la connexion est un échec, les utilisateurs sont dirigés vers un écran d'informations de dépannage dans l'image nommée connectionFailed.

function maOnConnect(succès) {
	if (succès) {
		gotoAndPlay("débutDiscussion")
	} else {
		gotoAndStop("EchecDeLaConnexion")
	}
}

Une fois l'objet XMLSocket créé à l'aide de la méthode constructeur, le script installe la méthode onConnect en utilisant l'opérateur d'affectation :

socket = new XMLSocket()
socket.onConnect = maOnConnect

Pour finir, la connexion est initiée. Si connect renvoie false, l'animation est envoyée directement dans l'image nommée EchecDeLaConnexion et onConnect n'est jamais invoqué. Si connect renvoie true, l'animation est envoyée dans une image appelée attenteDeConnexion, qui est l'écran affichant un message d'attente. L'animation reste sur l'image attenteDeConnexion jusqu'à ce que le gestionnaire onConnect soit invoqué, ce qui arrive à un moment donné dans le futur, selon le délai d'attente du réseau.

if (!socket.connect(null, 2000)) {
	gotoAndStop("EchecDeLaConnexion")
} else {
	gotoAndStop("attenteDeConnexion")
}

Voir aussi

function, XMLSocket.connect