windowing/windowserver/nga/CLIENT/RWINDOW.CPP
changeset 188 1b081cb0800b
parent 85 cdf2f6e5c390
child 156 ec4d3ac02166
child 178 89bd4cfee505
equal deleted inserted replaced
187:9f66f99ee56f 188:1b081cb0800b
  1361 (for example a touch screen that is able to determine coordinates of more than
  1361 (for example a touch screen that is able to determine coordinates of more than
  1362 one finger touching it at the same time), then this method will enable delivering
  1362 one finger touching it at the same time), then this method will enable delivering
  1363 events from all detected pointers to this window.
  1363 events from all detected pointers to this window.
  1364 
  1364 
  1365 This method must be called before the window is activated by calling RWindowBase::Activate().
  1365 This method must be called before the window is activated by calling RWindowBase::Activate().
  1366 Otherwise this will be ignored (release build), or panic (debug build). 
  1366 Otherwise the client is panicked with the code EWservPanicUnableToEnableAdvPointer.
  1367 
  1367 
  1368 If this method is not called for the window, it is assumed that the window is not
  1368 If this method is not called for the window, it is assumed that the window is not
  1369 able to receive events from multiple pointers, and thus only events from a single
  1369 able to receive events from multiple pointers, and thus only events from a single
  1370 emulated pointer are sent to it. Emulated pointer ensures that code written for a single 
  1370 emulated pointer are sent to it. Emulated pointer ensures that code written for a single 
  1371 pointer environment works properly in a multiple pointer environment: there is only 
  1371 pointer environment works properly in a multiple pointer environment: there is only 
  2796 @param aModifiers Bitmask that identifies which of the modifier keys in 
  2796 @param aModifiers Bitmask that identifies which of the modifier keys in 
  2797 aModifierMask need to be set and which need to be unset. For example, see the 
  2797 aModifierMask need to be set and which need to be unset. For example, see the 
  2798 description above. 
  2798 description above. 
  2799 @param aPriority A priority value - if more than one window group has requested 
  2799 @param aPriority A priority value - if more than one window group has requested 
  2800 capture for the same key event, the one with the highest priority will capture it.
  2800 capture for the same key event, the one with the highest priority will capture it.
       
  2801 The value must be greater than KMinTInt.
  2801 @return A handle identifying the capture key, or one of the system-wide error 
  2802 @return A handle identifying the capture key, or one of the system-wide error 
  2802 codes (if <0). KErrPermissionDenied indicates that the requested key cannot be 
  2803 codes (if <0). KErrPermissionDenied indicates that the requested key cannot be 
  2803 captured by this window group, because it has been protected by another window group. 
  2804 captured by this window group, because it has been protected by another window group. 
  2804 For more information, see the PROTECTEDKEY parameter in wsini.ini. Handles should be 
  2805 For more information, see the PROTECTEDKEY parameter in wsini.ini. Handles should be 
  2805 kept in order to be passed to CancelCaptureKey() later. 
  2806 kept in order to be passed to CancelCaptureKey() later. 
  2864 Possible values are defined in TEventModifier. 
  2865 Possible values are defined in TEventModifier. 
  2865 @param aModifiers Bitmask that identifies which of the modifier keys in 
  2866 @param aModifiers Bitmask that identifies which of the modifier keys in 
  2866 aModifierMask need to be set and which need to be unset. 
  2867 aModifierMask need to be set and which need to be unset. 
  2867 @param aPriority A priority value - if more than one window group has requested 
  2868 @param aPriority A priority value - if more than one window group has requested 
  2868 capture for the same key event, the one with the highest priority will capture it.
  2869 capture for the same key event, the one with the highest priority will capture it.
       
  2870 The value must be greater than KMinTInt.
  2869 @return A handle identifying the capture key, or one of the system-wide error 
  2871 @return A handle identifying the capture key, or one of the system-wide error 
  2870 codes (if < 0). KErrPermissionDenied indicates that the requested key cannot be captured by this 
  2872 codes (if < 0). KErrPermissionDenied indicates that the requested key cannot be captured by this 
  2871 window group, because it has been protected by another window group. For more information, see 
  2873 window group, because it has been protected by another window group. For more information, see 
  2872 the PROTECTEDKEY parameter in wsini.ini. Handles should be kept in order to be passed to 
  2874 the PROTECTEDKEY parameter in wsini.ini. Handles should be kept in order to be passed to 
  2873 CancelCaptureKeyUpAndDowns() later.
  2875 CancelCaptureKeyUpAndDowns() later.
  2935 @param aModifiers The key is captured only when the modifier keys specified 
  2937 @param aModifiers The key is captured only when the modifier keys specified 
  2936 in aModifierMask match these states, where 1 = modifier set, and 0 = modifier 
  2938 in aModifierMask match these states, where 1 = modifier set, and 0 = modifier 
  2937 not set. Modifier key states are defined in TEventModifier. 
  2939 not set. Modifier key states are defined in TEventModifier. 
  2938 @param aPriority If more than one window group has requested capture for the 
  2940 @param aPriority If more than one window group has requested capture for the 
  2939 same long key event, the one with the highest priority will capture the event.
  2941 same long key event, the one with the highest priority will capture the event.
       
  2942 The value must be greater than KMinTInt.
  2940 @param aFlags Configures the long key capture behaviour. See the TLongCaptureFlags 
  2943 @param aFlags Configures the long key capture behaviour. See the TLongCaptureFlags 
  2941 enum.
  2944 enum.
  2942 @return Identifying value for the long key capture. For use with the CancelCaptureLongKey() 
  2945 @return Identifying value for the long key capture. For use with the CancelCaptureLongKey() 
  2943 function.
  2946 function.
  2944 @see TLongCaptureFlags 
  2947 @see TLongCaptureFlags 
  2970 @param aModifiers The key is captured only when the modifier keys specified 
  2973 @param aModifiers The key is captured only when the modifier keys specified 
  2971 in aModifierMask match these states, where 1 = modifier set, and 0 = modifier 
  2974 in aModifierMask match these states, where 1 = modifier set, and 0 = modifier 
  2972 not set. Modifier key states are defined in TEventModifier. 
  2975 not set. Modifier key states are defined in TEventModifier. 
  2973 @param aPriority If more than one window group has requested capture for the 
  2976 @param aPriority If more than one window group has requested capture for the 
  2974 same long key event, the one with the highest priority will capture the event.
  2977 same long key event, the one with the highest priority will capture the event.
       
  2978 The value must be greater than KMinTInt.
  2975 @param aFlags Configures the long key capture behaviour. See the TLongCaptureFlags 
  2979 @param aFlags Configures the long key capture behaviour. See the TLongCaptureFlags 
  2976 enum.
  2980 enum.
  2977 @return Identifying value for the long key capture. For use with the CancelCaptureLongKey() 
  2981 @return Identifying value for the long key capture. For use with the CancelCaptureLongKey() 
  2978 function.
  2982 function.
  2979 @see TLongCaptureFlags
  2983 @see TLongCaptureFlags