1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
|
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim:expandtab:shiftwidth=2:tabstop=2:
*/
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef nsWinUtils_h_
#define nsWinUtils_h_
#include <functional>
#include <windows.h>
#include "nsICSSDeclaration.h"
#include "nsCOMPtr.h"
class nsIContent;
namespace mozilla {
namespace a11y {
class DocAccessible;
const LPCWSTR kClassNameRoot = L"MozillaUIWindowClass";
const LPCWSTR kClassNameTabContent = L"MozillaContentWindowClass";
const LPCWSTR kPropNameDocAcc = L"MozDocAccessible";
const LPCWSTR kPropNameDocAccParent = L"MozDocAccessibleParent";
class nsWinUtils {
public:
/**
* Return computed styles declaration for the given node.
*
* @note Please use it carefully since it can shutdown the accessible tree
* you operate on.
*/
static already_AddRefed<nsICSSDeclaration> GetComputedStyleDeclaration(
nsIContent* aContent);
/**
* Start window emulation if presence of specific AT is detected.
*/
static bool MaybeStartWindowEmulation();
/**
* Free resources used for window emulation.
*/
static void ShutdownWindowEmulation();
/**
* Return true if window emulation is started.
*/
static bool IsWindowEmulationStarted() { return sWindowEmulationStarted; }
/**
* Helper to register window class.
*/
static void RegisterNativeWindow(LPCWSTR aWindowClass);
typedef std::function<void(HWND)> NativeWindowCreateProc;
/**
* Helper to create a window.
*
* NB: If additional setup needs to be done once the window has been created,
* you should do so via aOnCreateProc. Hooks will fire during the
* CreateNativeWindow call, thus triggering events in the AT.
* Using aOnCreateProc guarantees that your additional initialization will
* have completed prior to the AT receiving window creation events.
*
* For example:
*
* nsWinUtils::NativeWindowCreateProc onCreate([](HWND aHwnd) -> void {
* DoSomeAwesomeInitializationStuff(aHwnd);
* DoMoreAwesomeInitializationStuff(aHwnd);
* });
* HWND hwnd = nsWinUtils::CreateNativeWindow(..., &onCreate);
* // Doing further initialization work to hwnd on this line is too late!
*/
static HWND CreateNativeWindow(
LPCWSTR aWindowClass, HWND aParentWnd, int aX, int aY, int aWidth,
int aHeight, bool aIsActive,
NativeWindowCreateProc* aOnCreateProc = nullptr);
/**
* Helper to show window.
*/
static void ShowNativeWindow(HWND aWnd);
/**
* Helper to hide window.
*/
static void HideNativeWindow(HWND aWnd);
private:
/**
* Flag that indicates if window emulation is started.
*/
static bool sWindowEmulationStarted;
};
} // namespace a11y
} // namespace mozilla
#endif
|
