IAgentNotifySink::Move

[Der Microsoft Agent ist seit Windows 7 veraltet und kann in späteren Versionen von Windows nicht mehr verfügbar sein.]

HRESULT Move(
   long dwCharID,  // character ID
   long x,         // x-coordinate of new location
   long y,         // y-coordinate of new location
   long dwCause    // cause of move state
);                          

Benachrichtigt eine Clientanwendung, wenn der Charakter verschoben wurde.

• Kein Rückgabewert.

dwCharID

Bezeichner des Charakters, der verschoben wurde.

x

Die x-Koordinate der neuen Position in Pixel, relativ zum Bildschirmursprung (oben links). Die Position eines Charakters basiert auf der oberen linken Ecke des Animationsrahmens.

y

Die y-Koordinate der neuen Position in Pixel, relativ zum Bildschirmursprung (oben links). Die Position eines Charakters basiert auf der oberen linken Ecke des Animationsrahmens.

dwCause

Die Ursache für die Charakterverschiebung. Beim Parameter kann es sich um einen der folgenden handeln:

Wert	Beschreibung
const unsigned shortNeverMoved = 0;	Der Charakter wurde nicht verschoben.
const unsigned shortUserMoved = 1;	Der Benutzer hat den Charakter gezogen.
const unsigned shortProgramMoved = 2;	Die Anwendung hat den Charakter verschoben.
const unsigned shortOtherProgramMoved = 3;	Eine andere Anwendung hat den Charakter verschoben.
const unsigned shortSystemMoved = 4	Der Server hat den Charakter verschoben, damit er nach einer Änderung der Bildschirmauflösung auf dem Bildschirm bleibt.

Dieses Ereignis wird an alle Clients des Charakters gesendet.

Weitere Informationen

IAgentCharacter::GetMoveCause, IAgentCharacter::MoveTo