| // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| #ifndef ACCESSIBILITY_GFX_NATIVE_WIDGET_TYPES_H_ |
| #define ACCESSIBILITY_GFX_NATIVE_WIDGET_TYPES_H_ |
| |
| #include <cstdint> |
| |
| #include "ax_build/build_config.h" |
| #include "gfx/gfx_export.h" |
| |
| #if defined(OS_ANDROID) |
| #include "base/android/scoped_java_ref.h" |
| #elif defined(OS_APPLE) |
| #include <objc/objc.h> |
| #elif defined(OS_WIN) |
| #include "base/win/windows_types.h" |
| #endif |
| |
| // This file provides cross platform typedefs for native widget types. |
| // NativeWindow: this is a handle to a native, top-level window |
| // NativeView: this is a handle to a native UI element. It may be the |
| // same type as a NativeWindow on some platforms. |
| // NativeViewId: Often, in our cross process model, we need to pass around a |
| // reference to a "window". This reference will, say, be echoed back from a |
| // renderer to the browser when it wishes to query its size. On Windows we |
| // use an HWND for this. |
| // |
| // As a rule of thumb - if you're in the renderer, you should be dealing |
| // with NativeViewIds. This should remind you that you shouldn't be doing |
| // direct operations on platform widgets from the renderer process. |
| // |
| // If you're in the browser, you're probably dealing with NativeViews, |
| // unless you're in the IPC layer, which will be translating between |
| // NativeViewIds from the renderer and NativeViews. |
| // |
| // The name 'View' here meshes with OS X where the UI elements are called |
| // 'views' and with our Chrome UI code where the elements are also called |
| // 'views'. |
| |
| #if defined(USE_AURA) |
| namespace aura { |
| class Window; |
| } |
| namespace ui { |
| class Cursor; |
| class Event; |
| namespace mojom { |
| enum class CursorType; |
| } |
| } // namespace ui |
| |
| #endif // defined(USE_AURA) |
| |
| #if defined(OS_WIN) |
| typedef struct HFONT__* HFONT; |
| struct IAccessible; |
| #elif defined(OS_IOS) |
| struct CGContext; |
| #ifdef __OBJC__ |
| @class UIEvent; |
| @class UIFont; |
| @class UIImage; |
| @class UIView; |
| @class UIWindow; |
| @class UITextField; |
| #else |
| class UIEvent; |
| class UIFont; |
| class UIImage; |
| class UIView; |
| class UIWindow; |
| class UITextField; |
| #endif // __OBJC__ |
| #elif defined(OS_MAC) |
| struct CGContext; |
| #ifdef __OBJC__ |
| @class NSCursor; |
| @class NSEvent; |
| @class NSFont; |
| @class NSImage; |
| @class NSView; |
| @class NSWindow; |
| @class NSTextField; |
| #else |
| class NSCursor; |
| class NSEvent; |
| class NSFont; |
| class NSImage; |
| struct NSView; |
| class NSWindow; |
| class NSTextField; |
| #endif // __OBJC__ |
| #endif |
| |
| #if defined(OS_ANDROID) |
| struct ANativeWindow; |
| namespace ui { |
| class WindowAndroid; |
| class ViewAndroid; |
| } // namespace ui |
| #endif |
| class SkBitmap; |
| |
| #if defined(OS_LINUX) && !defined(OS_CHROMEOS) |
| extern "C" { |
| struct _AtkObject; |
| typedef struct _AtkObject AtkObject; |
| } |
| #endif |
| |
| namespace gfx { |
| |
| #if defined(USE_AURA) |
| typedef ui::Cursor NativeCursor; |
| typedef aura::Window* NativeView; |
| typedef aura::Window* NativeWindow; |
| typedef ui::Event* NativeEvent; |
| constexpr NativeView kNullNativeView = nullptr; |
| constexpr NativeWindow kNullNativeWindow = nullptr; |
| #elif defined(OS_IOS) |
| typedef void* NativeCursor; |
| typedef UIView* NativeView; |
| typedef UIWindow* NativeWindow; |
| typedef UIEvent* NativeEvent; |
| constexpr NativeView kNullNativeView = nullptr; |
| constexpr NativeWindow kNullNativeWindow = nullptr; |
| #elif defined(OS_MAC) |
| typedef NSCursor* NativeCursor; |
| typedef NSEvent* NativeEvent; |
| // NativeViews and NativeWindows on macOS are not necessarily in the same |
| // process as the NSViews and NSWindows that they represent. Require an |
| // explicit function call (GetNativeNSView or GetNativeNSWindow) to retrieve |
| // the underlying NSView or NSWindow. |
| // https://crbug.com/893719 |
| class GFX_EXPORT NativeView { |
| public: |
| constexpr NativeView() {} |
| // TODO(ccameron): Make this constructor explicit. |
| constexpr NativeView(NSView* ns_view) : ns_view_(ns_view) {} |
| |
| // This function name is verbose (that is, not just GetNSView) so that it |
| // is easily grep-able. |
| NSView* GetNativeNSView() const { return ns_view_; } |
| |
| operator bool() const { return ns_view_ != 0; } |
| bool operator==(const NativeView& other) const { |
| return ns_view_ == other.ns_view_; |
| } |
| bool operator!=(const NativeView& other) const { |
| return ns_view_ != other.ns_view_; |
| } |
| bool operator<(const NativeView& other) const { |
| return ns_view_ < other.ns_view_; |
| } |
| |
| private: |
| NSView* ns_view_ = nullptr; |
| }; |
| class GFX_EXPORT NativeWindow { |
| public: |
| constexpr NativeWindow() {} |
| // TODO(ccameron): Make this constructor explicit. |
| constexpr NativeWindow(NSWindow* ns_window) : ns_window_(ns_window) {} |
| |
| // This function name is verbose (that is, not just GetNSWindow) so that it |
| // is easily grep-able. |
| NSWindow* GetNativeNSWindow() const { return ns_window_; } |
| |
| operator bool() const { return ns_window_ != 0; } |
| bool operator==(const NativeWindow& other) const { |
| return ns_window_ == other.ns_window_; |
| } |
| bool operator!=(const NativeWindow& other) const { |
| return ns_window_ != other.ns_window_; |
| } |
| bool operator<(const NativeWindow& other) const { |
| return ns_window_ < other.ns_window_; |
| } |
| |
| private: |
| NSWindow* ns_window_ = nullptr; |
| }; |
| const NativeView kNullNativeView = NativeView(nullptr); |
| const NativeWindow kNullNativeWindow = NativeWindow(nullptr); |
| #elif defined(OS_ANDROID) |
| typedef void* NativeCursor; |
| typedef ui::ViewAndroid* NativeView; |
| typedef ui::WindowAndroid* NativeWindow; |
| typedef base::android::ScopedJavaGlobalRef<jobject> NativeEvent; |
| constexpr NativeView kNullNativeView = nullptr; |
| constexpr NativeWindow kNullNativeWindow = nullptr; |
| #elif defined(OS_LINUX) |
| // TODO(chunhtai): Figures out what is the correct type for Linux |
| // https://github.com/flutter/flutter/issues/74270 |
| typedef void* NativeCursor; |
| #elif defined(OS_WIN) |
| typedef void* NativeCursor; |
| typedef void* NativeView; |
| typedef void* NativeWindow; |
| typedef void* NativeEvent; |
| constexpr NativeView kNullNativeView = nullptr; |
| constexpr NativeWindow kNullNativeWindow = nullptr; |
| #else |
| #error Unknown build environment. |
| #endif |
| |
| #if defined(OS_WIN) |
| typedef HFONT NativeFont; |
| typedef IAccessible* NativeViewAccessible; |
| #elif defined(OS_IOS) |
| typedef UIFont* NativeFont; |
| typedef id NativeViewAccessible; |
| #elif defined(OS_MAC) |
| typedef NSFont* NativeFont; |
| typedef id NativeViewAccessible; |
| #elif defined(OS_LINUX) && !defined(OS_CHROMEOS) |
| // Linux doesn't have a native font type. |
| typedef AtkObject* NativeViewAccessible; |
| #else |
| // Android, Chrome OS, etc. |
| typedef struct _UnimplementedNativeViewAccessible |
| UnimplementedNativeViewAccessible; |
| typedef UnimplementedNativeViewAccessible* NativeViewAccessible; |
| #endif |
| |
| // A constant value to indicate that gfx::NativeCursor refers to no cursor. |
| #if defined(USE_AURA) |
| const ui::mojom::CursorType kNullCursor = |
| static_cast<ui::mojom::CursorType>(-1); |
| #else |
| const gfx::NativeCursor kNullCursor = static_cast<gfx::NativeCursor>(nullptr); |
| #endif |
| |
| // Note: for test_shell we're packing a pointer into the NativeViewId. So, if |
| // you make it a type which is smaller than a pointer, you have to fix |
| // test_shell. |
| // |
| // See comment at the top of the file for usage. |
| typedef intptr_t NativeViewId; |
| |
| // AcceleratedWidget provides a surface to compositors to paint pixels. |
| #if defined(OS_WIN) |
| typedef HWND AcceleratedWidget; |
| constexpr AcceleratedWidget kNullAcceleratedWidget = nullptr; |
| #elif defined(OS_IOS) |
| typedef UIView* AcceleratedWidget; |
| constexpr AcceleratedWidget kNullAcceleratedWidget = 0; |
| #elif defined(OS_MAC) |
| typedef uint64_t AcceleratedWidget; |
| constexpr AcceleratedWidget kNullAcceleratedWidget = 0; |
| #elif defined(OS_ANDROID) |
| typedef ANativeWindow* AcceleratedWidget; |
| constexpr AcceleratedWidget kNullAcceleratedWidget = 0; |
| #elif defined(USE_OZONE) || defined(USE_X11) |
| typedef uint32_t AcceleratedWidget; |
| constexpr AcceleratedWidget kNullAcceleratedWidget = 0; |
| #elif defined(OS_LINUX) |
| // TODO(chunhtai): Figure out what the correct type is for the Linux. |
| // https://github.com/flutter/flutter/issues/74270 |
| typedef void* AcceleratedWidget; |
| constexpr AcceleratedWidget kNullAcceleratedWidget = nullptr; |
| #else |
| #error unknown platform |
| #endif |
| |
| } // namespace gfx |
| |
| #endif // ACCESSIBILITY_GFX_NATIVE_WIDGET_TYPES_H_ |