KiCad PCB EDA Suite
Loading...
Searching...
No Matches
ui.h
Go to the documentation of this file.
1/*
2 * This program source code file is part of KiCad, a free EDA CAD application.
3 *
4 * Copyright (C) 2020 Ian McInerney <Ian.S.McInerney at ieee.org>
5 * Copyright The KiCad Developers, see AUTHORS.txt for contributors.
6 *
7 * This program is free software: you can redistribute it and/or modify it
8 * under the terms of the GNU General Public License as published by the
9 * Free Software Foundation, either version 3 of the License, or (at your
10 * option) any later version.
11 *
12 * This program is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License for more details.
16 *
17 * You should have received a copy of the GNU General Public License
18 * along with this program. If not, see <https://www.gnu.org/licenses/>.
19 */
20
21#ifndef KIPLATFORM_UI_H_
22#define KIPLATFORM_UI_H_
23
24#include <wx/cursor.h>
25
26class wxChoice;
27class wxDataViewCtrl;
28class wxDialog;
29class wxNonOwnedWindow;
30class wxTopLevelWindow;
31class wxWindow;
32
33namespace KIPLATFORM
34{
35 namespace UI
36 {
42 bool IsDarkTheme();
43
44 wxColour GetDialogBGColour();
45
53 void ForceFocus( wxWindow* aWindow );
54
61 bool IsWindowActive( wxWindow* aWindow );
62
75 void ReparentModal( wxNonOwnedWindow* aWindow );
76
77 void ReparentWindow( wxNonOwnedWindow* aWindow, wxTopLevelWindow* aParent );
78
79 /*
80 * An ugly hack to fix an issue on OSX: cmd+c closes the dialog instead of copying the
81 * text if a button with wxID_CANCEL is used in a wxStdDialogButtonSizer created by
82 * wxFormBuilder: the label is &Cancel, and this accelerator key has priority over the
83 * standard copy accelerator.
84 * Note: problem also exists in other languages; for instance cmd+a closes dialogs in
85 * German because the button is &Abbrechen.
86 */
87 void FixupCancelButtonCmdKeyCollision( wxWindow* aWindow );
88
94 bool IsStockCursorOk( wxStockCursor aCursor );
95
102 void LargeChoiceBoxHack( wxChoice* aChoice );
103
110 void EllipsizeChoiceBox( wxChoice* aChoice );
111
118 double GetPixelScaleFactor( const wxWindow* aWindow );
119
125 double GetContentScaleFactor( const wxWindow* aWindow );
126
130 void GetInfoBarColours( wxColour& aFGColour, wxColour& aBGColour );
131
138 wxSize GetUnobscuredSize( const wxWindow* aWindow );
139
144 void SetOverlayScrolling( const wxWindow* aWindow, bool overlay );
145
149 bool AllowIconsInMenus();
150
155 wxPoint GetMousePosition();
156
164 bool WarpPointer( wxWindow* aWindow, int aX, int aY );
165
169 void ImmControl( wxWindow* aWindow, bool aEnable );
170
174 void ImeNotifyCancelComposition( wxWindow* aWindow );
175
184 bool InfiniteDragPrepareWindow( wxWindow* aWindow );
185
190
197 void EnsureVisible( wxWindow* aWindow );
198
209 void StabilizeWindowPosition( wxWindow* aWindow );
210
214 void SetFloatLevel( wxWindow* aWindow );
215
226 void ReleaseChildWindow( wxNonOwnedWindow* aWindow );
227
243 void AllowNetworkFileSystems( wxDialog* aDialog );
244
257 void CancelPendingScroll( wxDataViewCtrl* aCtrl );
258
276 void SetWMClass( wxWindow* aWindow, const wxString& aClass );
277 }
278}
279
280#endif // KIPLATFORM_UI_H_
bool AllowIconsInMenus()
If the user has disabled icons system-wide, we check that here.
Definition wxgtk/ui.cpp:381
void SetFloatLevel(wxWindow *aWindow)
Intended to set the floating window level in macOS on a window.
Definition wxgtk/ui.cpp:510
void GetInfoBarColours(wxColour &aFGColour, wxColour &aBGColour)
Return the background and foreground colors for info bars in the current scheme.
Definition wxgtk/ui.cpp:70
void ReparentWindow(wxNonOwnedWindow *aWindow, wxTopLevelWindow *aParent)
Definition wxgtk/ui.cpp:260
void ReleaseChildWindow(wxNonOwnedWindow *aWindow)
Release a modal window's parent-child relationship with its parent window.
Definition wxgtk/ui.cpp:515
void EllipsizeChoiceBox(wxChoice *aChoice)
Configure a wxChoice control to ellipsize the shown text in the button with the ellipses placed at th...
Definition wxgtk/ui.cpp:326
void FixupCancelButtonCmdKeyCollision(wxWindow *aWindow)
Definition wxgtk/ui.cpp:266
void SetOverlayScrolling(const wxWindow *aWindow, bool overlay)
Used to set overlay/non-overlay scrolling mode in a window.
Definition wxgtk/ui.cpp:374
wxPoint GetMousePosition()
Returns the mouse position in screen coordinates.
Definition wxgtk/ui.cpp:839
void ImmControl(wxWindow *aWindow, bool aEnable)
Configures the IME mode of a given control handle.
Definition wxgtk/ui.cpp:491
void StabilizeWindowPosition(wxWindow *aWindow)
Prepare a top-level window for reliable position round-tripping.
Definition wxgtk/ui.cpp:170
double GetPixelScaleFactor(const wxWindow *aWindow)
Tries to determine the pixel scaling factor currently in use for the window.
Definition wxgtk/ui.cpp:347
void InfiniteDragReleaseWindow()
On Wayland, allows the cursor to freely move again after a drag (see InfiniteDragPrepareWindow).
Definition wxgtk/ui.cpp:833
void EnsureVisible(wxWindow *aWindow)
Ensure that a window is visible on the screen.
Definition wxgtk/ui.cpp:164
bool IsStockCursorOk(wxStockCursor aCursor)
Checks if we designated a stock cursor for this OS as "OK" or else we may need to load a custom one.
Definition wxgtk/ui.cpp:272
double GetContentScaleFactor(const wxWindow *aWindow)
Tries to determine the content scaling factor currently in use for the window.
Definition wxgtk/ui.cpp:360
void ImeNotifyCancelComposition(wxWindow *aWindow)
Asks the IME to cancel.
Definition wxgtk/ui.cpp:496
void LargeChoiceBoxHack(wxChoice *aChoice)
Configure a wxChoice control to support a lot of entries by disabling functionality that makes adding...
Definition wxgtk/ui.cpp:308
bool WarpPointer(wxWindow *aWindow, int aX, int aY)
Move the mouse cursor to a specific position relative to the window.
Definition wxgtk/ui.cpp:425
wxColour GetDialogBGColour()
Definition wxgtk/ui.cpp:64
bool IsWindowActive(wxWindow *aWindow)
Check to see if the given window is the currently active window (e.g.
Definition wxgtk/ui.cpp:149
wxSize GetUnobscuredSize(const wxWindow *aWindow)
Tries to determine the size of the viewport of a scrollable widget (wxDataViewCtrl,...
Definition wxgtk/ui.cpp:367
void ForceFocus(wxWindow *aWindow)
Pass the current focus to the window.
Definition wxgtk/ui.cpp:127
bool InfiniteDragPrepareWindow(wxWindow *aWindow)
On Wayland, restricts the pointer movement to a rectangle slightly bigger than the given wxWindow.
Definition wxgtk/ui.cpp:826
void SetWMClass(wxWindow *aWindow, const wxString &aClass)
Tag a top-level window with the freedesktop application id of its installed launcher,...
Definition wxgtk/ui.cpp:226
void ReparentModal(wxNonOwnedWindow *aWindow)
Move a window's parent to be the top-level window and force the window to be on top.
Definition wxgtk/ui.cpp:254
void CancelPendingScroll(wxDataViewCtrl *aCtrl)
Cancel any pending scroll-to-item request on aCtrl.
Definition wxgtk/ui.cpp:530
bool IsDarkTheme()
Determine if the desktop interface is currently using a dark theme or a light theme.
Definition wxgtk/ui.cpp:51
void AllowNetworkFileSystems(wxDialog *aDialog)
Configure a file dialog to show network and virtual file systems.
Definition wxgtk/ui.cpp:521
std::shared_ptr< PNS_LOG_VIEWER_OVERLAY > overlay