vcl/inc/salsys.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef _SV_SALSYS_HXX
  21 #define _SV_SALSYS_HXX
  22
  23 #include <tools/gen.hxx>
  24 #include <vcl/dllapi.h>
  25 #include <rtl/ustring.hxx>
  26
  27 // Button combinations for ShowNativeMessageBox
  28 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTNCOMBI_OK                 = 0;
  29 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTNCOMBI_OK_CANCEL          = 1;
  30 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTNCOMBI_ABORT_RETRY_IGNORE = 2;
  31 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTNCOMBI_YES_NO_CANCEL      = 3;
  32 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTNCOMBI_YES_NO             = 4;
  33 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTNCOMBI_RETRY_CANCEL       = 5;
  34
  35 // Button identifier for ShowNativeMessageBox
  36 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTN_OK     = 1;
  37 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTN_CANCEL = 2;
  38 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTN_ABORT  = 3;
  39 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTN_RETRY  = 4;
  40 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTN_IGNORE = 5;
  41 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTN_YES    = 6;
  42 const int SALSYSTEM_SHOWNATIVEMSGBOX_BTN_NO     = 7;
  43
  44 class VCL_PLUGIN_PUBLIC SalSystem
  45 {
  46 public:
  47             SalSystem() {}
  48     virtual ~SalSystem();
  49
  50     // get info about the display
  51
  52     /*  Gets the number of active screens attached to the display
  53
  54         @returns the number of active screens
  55     */
  56     virtual unsigned int GetDisplayScreenCount() = 0;
  57     /*  Queries whether multiple screens are part of one bigger display
  58
  59         @returns true if screens form one big display
  60                  false if screens are distinct and windows cannot
  61                  be moved between, or span multiple screens
  62     */
  63     virtual bool IsUnifiedDisplay() { return true; }
  64     /*  Queries the default screen number. The default screen is the
  65         screen on which windows will appear if no special positioning
  66         is made.
  67
  68         @returns the default screen number
  69     */
  70     virtual unsigned int GetDisplayBuiltInScreen() { return 0; }
  71     /*  Gets relative position and size of the screens attached to the display
  72
  73         @param nScreen
  74         The screen number to be queried
  75
  76         @returns position: (0,0) in case of IsMultiscreen() == true
  77                            else position relative to whole display
  78                  size: size of the screen
  79     */
  80     virtual Rectangle GetDisplayScreenPosSizePixel( unsigned int nScreen ) = 0;
  81     /*  Gets position and size of the work area of a screen attached to the display
  82
  83         @param nScreen
  84         The screen number to be queried
  85
  86         @returns position and size relative to the scree
  87     */
  88     virtual Rectangle GetDisplayScreenWorkAreaPosSizePixel( unsigned int nScreen ) = 0;
  89     /* Gets the name of a screen
  90
  91        @param nScreen
  92        The screen number to be queried
  93
  94        @returns the name of the screen
  95     */
  96     virtual OUString GetDisplayScreenName( unsigned int nScreen ) = 0;
  97
  98     /*  Shows a native message box with the specified title, message and button
  99         combination.
 100
 101         @param  rTitle
 102         The title to be shown by the dialog box.
 103
 104         @param  rMessage
 105         The message to be shown by the dialog box.
 106
 107         @param  nButtonCombination
 108         Specify which button combination the message box should display.
 109         See button combinations above.
 110
 111         @param  nDefaultButton
 112         Specifies which button has the focus initially.
 113         See button identifiers above.
 114         The effect of specifying a button that doesn't belong
 115         to the specified button combination is undefined.
 116
 117         @param  bUseResources
 118         If false, assume initialization of the application failed early and do
 119         not try to access any resources.
 120
 121         @returns the identifier of the button that was pressed by the user.
 122         See button identifier above. If the function fails the
 123         return value is 0.
 124     */
 125     virtual int ShowNativeMessageBox( const OUString& rTitle,
 126                                       const OUString& rMessage,
 127                                       int nButtonCombination,
 128                                       int nDefaultButton,
 129                                       bool bUseResources ) = 0;
 130
 131 };
 132
 133 SalSystem* ImplGetSalSystem();
 134
 135 #endif // _SV_SALSYS_HXX
 136
 137 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */