src/video/uikit/SDL_uikitview.h
author Sam Lantinga <slouken@libsdl.org>
Sun, 04 Nov 2012 21:53:28 -0800
changeset 6654 2ecfb25be1e2
parent 6597 d359909f8121
child 6885 700f1b25f77f
permissions -rw-r--r--
Synchronized the on-screen keyboard state with whether we are accepting text input.
The functions to show/hide/toggle the on-screen keyboard have been folded into the text input state.
Calling SDL_StartTextInput() will automatically show the on-screen keyboard if it's available.
Calling SDL_StopTextInput() will automatically hide the on-screen keyboard if it's available.
There is a new API function SDL_IsTextInputActive() which will return whether text input is currently active.
Text input is disabled by default, you must call SDL_StartTextInput() when you are ready to accept text input.
SDL_HasScreenKeyboardSupport() no longer needs to be passed a window.
The iPhone-specific on-screen keyboard functions have been removed.
     1 /*
     2   Simple DirectMedia Layer
     3   Copyright (C) 1997-2012 Sam Lantinga <slouken@libsdl.org>
     4 
     5   This software is provided 'as-is', without any express or implied
     6   warranty.  In no event will the authors be held liable for any damages
     7   arising from the use of this software.
     8 
     9   Permission is granted to anyone to use this software for any purpose,
    10   including commercial applications, and to alter it and redistribute it
    11   freely, subject to the following restrictions:
    12 
    13   1. The origin of this software must not be misrepresented; you must not
    14      claim that you wrote the original software. If you use this software
    15      in a product, an acknowledgment in the product documentation would be
    16      appreciated but is not required.
    17   2. Altered source versions must be plainly marked as such, and must not be
    18      misrepresented as being the original software.
    19   3. This notice may not be removed or altered from any source distribution.
    20 */
    21 
    22 #import <UIKit/UIKit.h>
    23 #import "SDL_uikitviewcontroller.h"
    24 
    25 #include "SDL_touch.h"
    26 
    27 #define IPHONE_TOUCH_EFFICIENT_DANGEROUS
    28 
    29 #ifndef IPHONE_TOUCH_EFFICIENT_DANGEROUS
    30 #define MAX_SIMULTANEOUS_TOUCHES 5
    31 #endif
    32 
    33 #if SDL_IPHONE_KEYBOARD
    34 @interface SDL_uikitview : UIView<UITextFieldDelegate> {
    35 #else
    36 @interface SDL_uikitview : UIView {
    37 #endif
    38 
    39     SDL_TouchID touchId;
    40     SDL_FingerID leftFingerDown;
    41 #ifndef IPHONE_TOUCH_EFFICIENT_DANGEROUS
    42     UITouch *finger[MAX_SIMULTANEOUS_TOUCHES];
    43 #endif
    44 
    45 #if SDL_IPHONE_KEYBOARD
    46     UITextField *textField;
    47     BOOL keyboardVisible;
    48 #endif
    49 
    50 @public
    51     SDL_uikitviewcontroller *viewcontroller;
    52 }
    53 - (CGPoint)touchLocation:(UITouch *)touch shouldNormalize:(BOOL)normalize;
    54 - (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event;
    55 - (void)touchesEnded:(NSSet *)touches withEvent:(UIEvent *)event;
    56 - (void)touchesMoved:(NSSet *)touches withEvent:(UIEvent *)event;
    57 
    58 #if SDL_IPHONE_KEYBOARD
    59 - (void)showKeyboard;
    60 - (void)hideKeyboard;
    61 - (void)initializeKeyboard;
    62 @property (readonly) BOOL keyboardVisible;
    63 
    64 SDL_bool UIKit_HasScreenKeyboardSupport(_THIS);
    65 void UIKit_ShowScreenKeyboard(_THIS, SDL_Window *window);
    66 void UIKit_HideScreenKeyboard(_THIS, SDL_Window *window);
    67 SDL_bool UIKit_IsScreenKeyboardShown(_THIS, SDL_Window *window);
    68 
    69 #endif
    70 
    71 @end
    72 
    73 /* vi: set ts=4 sw=4 expandtab: */