<?xml version="1.0" encoding="UTF-8"?>
<helpdocument version="1.0">
<!--
* This file is part of the LibreOffice project.
*
* 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/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
-->
<meta>
<topic id="textsbasicshared03010304xml" indexer="include" status="PUBLISH">
<title id="tit" xml-lang="en-US">QBColor Function</title>
<filename>/text/sbasic/shared/03010304.xhp</filename>
</topic>
</meta>
<body>
<section id="qbcolor">
<bookmark xml-lang="en-US" branch="index" id="bm_id201546205404067">
<bookmark_value>QBColor function</bookmark_value>
</bookmark>
<paragraph id="hd_id3149670" role="heading" level="1" xml-lang="en-US"><link href="text/sbasic/shared/03010304.xhp" name="QBColor Function">QBColor Function</link></paragraph>
<paragraph id="par_id3150359" role="paragraph" xml-lang="en-US">Returns the <link href="text/sbasic/shared/03010305.xhp" name="RGB">RGB</link> color code of the color passed as a color value through an older MS-DOS based programming system.</paragraph>
</section>
<paragraph id="hd_id3154140" role="heading" level="2" xml-lang="en-US">Syntax:</paragraph>
<paragraph id="par_id3151042" role="code" xml-lang="en-US">QBColor (ColorNumber As Integer)</paragraph>
<paragraph id="hd_id3145172" role="heading" level="2" xml-lang="en-US">Return value:</paragraph>
<paragraph id="par_id3154685" role="paragraph" xml-lang="en-US">Long</paragraph>
<paragraph id="hd_id3156560" role="heading" level="2" xml-lang="en-US">Parameter:</paragraph>
<paragraph id="par_id3161832" role="paragraph" xml-lang="en-US"> <emph>ColorNumber</emph>: Any integer expression that specifies the color value of the color passed from an older MS-DOS based programming system.</paragraph>
<paragraph id="par_id3147318" role="paragraph" xml-lang="en-US"> <emph>ColorNumber</emph> can be assigned the following values:</paragraph>
<paragraph id="par_id3152576" role="paragraph" xml-lang="en-US">0 : Black</paragraph>
<paragraph id="par_id3146975" role="paragraph" xml-lang="en-US">1 : Blue</paragraph>
<paragraph id="par_id3151116" role="paragraph" xml-lang="en-US">2 : Green</paragraph>
<paragraph id="par_id3155412" role="paragraph" xml-lang="en-US">3 : Cyan</paragraph>
<paragraph id="par_id3155306" role="paragraph" xml-lang="en-US">4 : Red</paragraph>
<paragraph id="par_id3153364" role="paragraph" xml-lang="en-US">5 : Magenta</paragraph>
<paragraph id="par_id3146119" role="paragraph" xml-lang="en-US">6 : Yellow</paragraph>
<paragraph id="par_id3154730" role="paragraph" xml-lang="en-US">7 : White</paragraph>
<paragraph id="par_id3153877" role="paragraph" xml-lang="en-US">8 : Gray</paragraph>
<paragraph id="par_id3147124" role="paragraph" xml-lang="en-US">9 : Light Blue</paragraph>
<paragraph id="par_id3145646" role="paragraph" xml-lang="en-US">10 : Light Green</paragraph>
<paragraph id="par_id3149958" role="paragraph" xml-lang="en-US">11 : Light Cyan</paragraph>
<paragraph id="par_id3154943" role="paragraph" xml-lang="en-US">12 : Light Red</paragraph>
<paragraph id="par_id3150715" role="paragraph" xml-lang="en-US">13 : Light Magenta</paragraph>
<paragraph id="par_id3146970" role="paragraph" xml-lang="en-US">14 : Light Yellow</paragraph>
<paragraph id="par_id3150750" role="paragraph" xml-lang="en-US">15 : Bright White</paragraph>
<paragraph id="par_id3146914" role="paragraph" xml-lang="en-US">This function is used only to convert from older MS-DOS based BASIC applications that use the above color codes. The function returns a long integer value indicating the color to be used in the $[officename] IDE.</paragraph>
<embed href="text/sbasic/shared/00000003.xhp#errorcode"/>
<embed href="text/sbasic/shared/00000003.xhp#err5"/>
<paragraph id="hd_id3148406" role="heading" level="2" xml-lang="en-US">Example:</paragraph>
<bascode>
<paragraph id="par_idm1341247424" role="bascode" localize="false" xml-lang="en-US">Sub ExampleQBColor</paragraph>
<paragraph id="par_idm1341246192" role="bascode" localize="false" xml-lang="en-US">Dim iColor As Integer</paragraph>
<paragraph id="par_idm1341244960" role="bascode" localize="false" xml-lang="en-US">Dim sText As String</paragraph>
<paragraph id="par_idm1341243728" role="bascode" localize="false" xml-lang="en-US"> iColor = 7</paragraph>
<paragraph id="par_idm1341242496" role="bascode" localize="false" xml-lang="en-US"> sText = "RGB= " & Red(QBColor( iColor) ) & ":" & Blue(QBColor( iColor) ) & ":" & Green(QBColor( iColor) )</paragraph>
<paragraph id="par_id3149566" role="bascode" xml-lang="en-US"> MsgBox stext,0,"Color " & iColor</paragraph>
<paragraph id="par_idm1341239392" role="bascode" localize="false" xml-lang="en-US">End Sub</paragraph>
</bascode>
</body>
</helpdocument>