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 |