SlimDXc_Jun2010(VC++2008)/source/directinput/Joystick.h

   1 /*
   2 * Copyright (c) 2007-2010 SlimDX Group
   3 *
   4 * Permission is hereby granted, free of charge, to any person obtaining a copy
   5 * of this software and associated documentation files (the "Software"), to deal
   6 * in the Software without restriction, including without limitation the rights
   7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   8 * copies of the Software, and to permit persons to whom the Software is
   9 * furnished to do so, subject to the following conditions:
  10 *
  11 * The above copyright notice and this permission notice shall be included in
  12 * all copies or substantial portions of the Software.
  13 *
  14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  20 * THE SOFTWARE.
  21 */
  22 #pragma once
  23
  24 #include "DeviceDI.h"
  25 #include "JoystickState.h"
  26
  27 namespace SlimDX
  28 {
  29         namespace DirectInput
  30         {
  31                 public ref class Joystick : Device
  32                 {
  33                         COMOBJECT(IDirectInputDevice8, Joystick);
  34
  35                 public:
  36                         Joystick( DirectInput^ directInput, System::Guid subsystem );
  37
  38                         /// <summary>
  39                         /// Retrieves the current device state.
  40                         /// </summary>
  41                         /// <returns>The current device state.</returns>
  42                         JoystickState^ GetCurrentState();
  43
  44                         /// <summary>
  45                         /// Retrieves the current device state.
  46                         /// </summary>
  47                         /// <returns>A <see cref="SlimDX::Result"/> object describing the result of the operation.</returns>
  48                         [System::Security::Permissions::SecurityPermission( System::Security::Permissions::SecurityAction::LinkDemand, Flags=System::Security::Permissions::SecurityPermissionFlag::UnmanagedCode )]
  49                         Result GetCurrentState( JoystickState^% data );
  50
  51                         /// <summary>
  52                         /// Retrieves buffered data from the device.
  53                         /// </summary>
  54                         /// <returns>A collection of buffered input events.</returns>
  55                         System::Collections::Generic::IList<JoystickState^>^ GetBufferedData();
  56
  57                         /// <summary>
  58                         /// Gets properties about a single object on an input device.
  59                         /// </summary>
  60                         /// <param name="name">The name of the object whose properties are to be retrieved.</param>
  61                         /// <returns>The properties of the desired object.</returns>
  62                         ObjectProperties^ GetObjectPropertiesByName( System::String^ name );
  63
  64                         DeviceObjectInstance GetObjectInfoByName( System::String^ name );
  65                 };
  66         }
  67 }