mirror of
https://bitbucket.org/chromiumembedded/cef
synced 2024-12-13 01:56:20 +01:00
0b99f92e97
A modal dialog is a child CefWindow that implements some special behaviors relative to a parent CefWindow. Like any CefWindow it can be framed with titlebar or frameless, and optionally contain draggable regions (subject to platform limitations described below). Modal dialogs are shown centered on the parent window (inside a single display) and always stay on top of the parent window in z-order. Sizing behavior and available window buttons are controlled via the usual CefWindowDelegate callbacks. For example, the dialog can have a preferred size with resize, minimize and maximize disabled (via GetPreferredSize, CanResize, CanMinimize and CanMaximize respectively). This change adds support for two modality modes. With window modality all controls in the parent window are disabled. With browser modality only the browser view in the parent window is disabled. Both modality modes require that a valid parent window be returned via GetParentWindow. For window modality return true from IsWindowModalDialog and call CefWindow::Show. For browser modality return false from IsWindowModalDialog (the default value) and call CefWindow::ShowAsBrowserModalDialog with a reference to the parent window's browser view. Window modal dialog behavior depends on the platform. On Windows and Linux these dialogs have a titlebar and can be moved independent of the parent window. On macOS these dialogs do not have a titlebar, move with the parent window, and do not support draggable regions (because they are implemented using sheets). On Linux disabling the parent window controls requires a window manager the supports _NET_WM_STATE_MODAL. Browser modal dialog behavior is similar on all platforms. The dialog will be automatically sized and positioned relative to the parent window's browser view. Closing the parent window or navigating the parent browser view will dismiss the dialog. The dialog can also be moved independent of the parent window though it will be recentered when the parent window itself is resized or redisplayed. On MacOS the dialog will move along with the parent window while on Windows and Linux the parent window can be moved independently. To test: Use the Tests > Dialog Window menu option in cefclient with Views enabled (`--use-views` or `--enable-chrome-runtime` command-line flag). Browser modal dialog is the default behavior. For window modal dialog add the `--use-window-modal-dialog` command-line flag.
57 lines
1.9 KiB
C++
57 lines
1.9 KiB
C++
// Copyright (c) 2013 The Chromium Embedded Framework Authors. All rights
|
|
// reserved. Use of this source code is governed by a BSD-style license that
|
|
// can be found in the LICENSE file.
|
|
|
|
// Defines all of the command line switches used by cefclient.
|
|
|
|
#ifndef CEF_TESTS_SHARED_SHARED_COMMON_SWITCHES_H_
|
|
#define CEF_TESTS_SHARED_SHARED_COMMON_SWITCHES_H_
|
|
#pragma once
|
|
|
|
namespace client {
|
|
namespace switches {
|
|
|
|
extern const char kMultiThreadedMessageLoop[];
|
|
extern const char kExternalMessagePump[];
|
|
extern const char kCachePath[];
|
|
extern const char kUrl[];
|
|
extern const char kOffScreenRenderingEnabled[];
|
|
extern const char kOffScreenFrameRate[];
|
|
extern const char kTransparentPaintingEnabled[];
|
|
extern const char kShowUpdateRect[];
|
|
extern const char kSharedTextureEnabled[];
|
|
extern const char kExternalBeginFrameEnabled[];
|
|
extern const char kMouseCursorChangeDisabled[];
|
|
extern const char kOffline[];
|
|
extern const char kFilterChromeCommands[];
|
|
extern const char kRequestContextPerBrowser[];
|
|
extern const char kRequestContextSharedCache[];
|
|
extern const char kBackgroundColor[];
|
|
extern const char kEnableGPU[];
|
|
extern const char kFilterURL[];
|
|
extern const char kUseViews[];
|
|
extern const char kUseNative[];
|
|
extern const char kHideFrame[];
|
|
extern const char kHideControls[];
|
|
extern const char kHideOverlays[];
|
|
extern const char kAlwaysOnTop[];
|
|
extern const char kHideTopMenu[];
|
|
extern const char kSslClientCertificate[];
|
|
extern const char kCRLSetsPath[];
|
|
extern const char kLoadExtension[];
|
|
extern const char kNoActivate[];
|
|
extern const char kEnableChromeRuntime[];
|
|
extern const char kShowChromeToolbar[];
|
|
extern const char kInitialShowState[];
|
|
extern const char kHideChromeStatusBubble[];
|
|
extern const char kUseDefaultPopup[];
|
|
extern const char kUseClientDialogs[];
|
|
extern const char kUseTestHttpServer[];
|
|
extern const char kShowWindowButtons[];
|
|
extern const char kUseWindowModalDialog[];
|
|
|
|
} // namespace switches
|
|
} // namespace client
|
|
|
|
#endif // CEF_TESTS_SHARED_SHARED_COMMON_SWITCHES_H_
|