1*b1cdbd2cSJim Jagielski /************************************************************** 2*b1cdbd2cSJim Jagielski * 3*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 4*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 5*b1cdbd2cSJim Jagielski * distributed with this work for additional information 6*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 7*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 8*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 9*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 10*b1cdbd2cSJim Jagielski * 11*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 12*b1cdbd2cSJim Jagielski * 13*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 14*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 15*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 17*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 18*b1cdbd2cSJim Jagielski * under the License. 19*b1cdbd2cSJim Jagielski * 20*b1cdbd2cSJim Jagielski *************************************************************/ 21*b1cdbd2cSJim Jagielski 22*b1cdbd2cSJim Jagielski 23*b1cdbd2cSJim Jagielski 24*b1cdbd2cSJim Jagielski #ifndef __FRAMEWORK_TARGETHELPER_HXX_ 25*b1cdbd2cSJim Jagielski #define __FRAMEWORK_TARGETHELPER_HXX_ 26*b1cdbd2cSJim Jagielski 27*b1cdbd2cSJim Jagielski //_______________________________________________ 28*b1cdbd2cSJim Jagielski // own includes 29*b1cdbd2cSJim Jagielski 30*b1cdbd2cSJim Jagielski #include <sal/types.h> 31*b1cdbd2cSJim Jagielski #include <rtl/ustring.hxx> 32*b1cdbd2cSJim Jagielski #include <targets.h> 33*b1cdbd2cSJim Jagielski //_______________________________________________ 34*b1cdbd2cSJim Jagielski // namespace 35*b1cdbd2cSJim Jagielski 36*b1cdbd2cSJim Jagielski namespace framework{ 37*b1cdbd2cSJim Jagielski 38*b1cdbd2cSJim Jagielski //_______________________________________________ 39*b1cdbd2cSJim Jagielski // definitions 40*b1cdbd2cSJim Jagielski 41*b1cdbd2cSJim Jagielski /** @short can be used to detect, if a target name (used e.g. for XFrame.findFrame()) 42*b1cdbd2cSJim Jagielski has a special meaning or can be used as normal frame name (e.g. for XFrame.setName()). 43*b1cdbd2cSJim Jagielski 44*b1cdbd2cSJim Jagielski @author as96863 45*b1cdbd2cSJim Jagielski */ 46*b1cdbd2cSJim Jagielski class TargetHelper 47*b1cdbd2cSJim Jagielski { 48*b1cdbd2cSJim Jagielski //___________________________________________ 49*b1cdbd2cSJim Jagielski // const 50*b1cdbd2cSJim Jagielski 51*b1cdbd2cSJim Jagielski public: 52*b1cdbd2cSJim Jagielski 53*b1cdbd2cSJim Jagielski /** @short its used at the following interfaces to classify 54*b1cdbd2cSJim Jagielski target names. 55*b1cdbd2cSJim Jagielski */ 56*b1cdbd2cSJim Jagielski enum ESpecialTarget 57*b1cdbd2cSJim Jagielski { 58*b1cdbd2cSJim Jagielski E_NOT_SPECIAL , 59*b1cdbd2cSJim Jagielski E_SELF , 60*b1cdbd2cSJim Jagielski E_PARENT , 61*b1cdbd2cSJim Jagielski E_TOP , 62*b1cdbd2cSJim Jagielski E_BLANK , 63*b1cdbd2cSJim Jagielski E_DEFAULT , 64*b1cdbd2cSJim Jagielski E_BEAMER , 65*b1cdbd2cSJim Jagielski E_MENUBAR , 66*b1cdbd2cSJim Jagielski E_HELPAGENT , 67*b1cdbd2cSJim Jagielski E_HELPTASK 68*b1cdbd2cSJim Jagielski }; 69*b1cdbd2cSJim Jagielski 70*b1cdbd2cSJim Jagielski //___________________________________________ 71*b1cdbd2cSJim Jagielski // interface 72*b1cdbd2cSJim Jagielski 73*b1cdbd2cSJim Jagielski public: 74*b1cdbd2cSJim Jagielski 75*b1cdbd2cSJim Jagielski //___________________________________________ 76*b1cdbd2cSJim Jagielski 77*b1cdbd2cSJim Jagielski /** @short it checks the given unknown target name, 78*b1cdbd2cSJim Jagielski if it's the expected special one. 79*b1cdbd2cSJim Jagielski 80*b1cdbd2cSJim Jagielski @note An empty target is similar to "_self"! 81*b1cdbd2cSJim Jagielski 82*b1cdbd2cSJim Jagielski @param sCheckTarget 83*b1cdbd2cSJim Jagielski must be the unknwon target name, which should be checked. 84*b1cdbd2cSJim Jagielski 85*b1cdbd2cSJim Jagielski @param eSpecialTarget 86*b1cdbd2cSJim Jagielski represent the expected target. 87*b1cdbd2cSJim Jagielski 88*b1cdbd2cSJim Jagielski @return It returns <TRUE/> if <var>sCheckTarget</var> represent 89*b1cdbd2cSJim Jagielski the expected <var>eSpecialTarget</var> value; <FALSE/> otherwhise. 90*b1cdbd2cSJim Jagielski */ 91*b1cdbd2cSJim Jagielski static sal_Bool matchSpecialTarget(const ::rtl::OUString& sCheckTarget , 92*b1cdbd2cSJim Jagielski ESpecialTarget eSpecialTarget); 93*b1cdbd2cSJim Jagielski 94*b1cdbd2cSJim Jagielski //___________________________________________ 95*b1cdbd2cSJim Jagielski 96*b1cdbd2cSJim Jagielski /** @short it checks, if the given name can be used 97*b1cdbd2cSJim Jagielski to set it at a frame using XFrame.setName() method. 98*b1cdbd2cSJim Jagielski 99*b1cdbd2cSJim Jagielski @descr Because we handle special targets in a hard coded way 100*b1cdbd2cSJim Jagielski (means we do not check the real name of a frame then) 101*b1cdbd2cSJim Jagielski such named frames will never be found! 102*b1cdbd2cSJim Jagielski 103*b1cdbd2cSJim Jagielski And in case such special names can exists one times only 104*b1cdbd2cSJim Jagielski by definition inside the same frame tree (e.g. _beamer and 105*b1cdbd2cSJim Jagielski OFFICE_HELP_TASK) its not a good idea to allow anything here :-) 106*b1cdbd2cSJim Jagielski 107*b1cdbd2cSJim Jagielski Of course we can't check unknwon names, which are not special ones. 108*b1cdbd2cSJim Jagielski But we decide, that it's not allowed to use "_" as first sign 109*b1cdbd2cSJim Jagielski (because we reserve this letter for our own purposes!) 110*b1cdbd2cSJim Jagielski and the value must not a well known special target. 111*b1cdbd2cSJim Jagielski 112*b1cdbd2cSJim Jagielski @param sName 113*b1cdbd2cSJim Jagielski the new frame name, which sould be checked. 114*b1cdbd2cSJim Jagielski */ 115*b1cdbd2cSJim Jagielski static sal_Bool isValidNameForFrame(const ::rtl::OUString& sName); 116*b1cdbd2cSJim Jagielski }; 117*b1cdbd2cSJim Jagielski 118*b1cdbd2cSJim Jagielski } // namespace framework 119*b1cdbd2cSJim Jagielski 120*b1cdbd2cSJim Jagielski #endif // #ifndef __FRAMEWORK_TARGETHELPER_HXX_ 121