Difference between revisions of "Currently active document"
(fixed formatting markup) |
|||
Line 3: | Line 3: | ||
An almost equivalent to the BASIC command thisComponent is: | An almost equivalent to the BASIC command thisComponent is: | ||
− | < | + | <source lang="oobas"> |
StarDesktop.CurrentComponent | StarDesktop.CurrentComponent | ||
− | </ | + | </source> |
In OpenOffice.org basic it is generally preferable to use <tt>thisComponent</tt>. | In OpenOffice.org basic it is generally preferable to use <tt>thisComponent</tt>. | ||
Line 14: | Line 14: | ||
To determine the type of document that is currently active you could use the following function: | To determine the type of document that is currently active you could use the following function: | ||
− | < | + | <source lang="oobas"><pre> |
function fnWhichComponent(oDoc) as string | function fnWhichComponent(oDoc) as string | ||
if HasUnoInterfaces(oDoc, "com.sun.star.lang.XServiceInfo") then | if HasUnoInterfaces(oDoc, "com.sun.star.lang.XServiceInfo") then | ||
Line 32: | Line 32: | ||
end if | end if | ||
End function | End function | ||
− | </pre></ | + | </pre></source> |
An example of calling this function is: | An example of calling this function is: | ||
− | < | + | <source lang="oobas"><pre> |
if fnWhichComponent(thisComponent) <> "Text" then | if fnWhichComponent(thisComponent) <> "Text" then | ||
msgbox "Sorry - this only works for text documents", 16, "Error" | msgbox "Sorry - this only works for text documents", 16, "Error" | ||
exit sub | exit sub | ||
end if | end if | ||
− | </pre></ | + | </pre></source> |
[[Category:Basic:Tutorials]] | [[Category:Basic:Tutorials]] |
Revision as of 17:37, 10 July 2008
The currently active document can be accessed using thisComponent.
An almost equivalent to the BASIC command thisComponent is:
StarDesktop.CurrentComponent
In OpenOffice.org basic it is generally preferable to use thisComponent.
By using StarDesktop.CurrentComponent, a macro in one document can be run on another document.
Another exception is when a routine is run by the OpenOffice.org event "Document Open". In this case use StarDesktop.CurrentComponent and a check on the document type. The reason for not using thisComponent is that when a library is opened the event fires and thus runs a second time on the currently active document.
To determine the type of document that is currently active you could use the following function:
<pre> function fnWhichComponent(oDoc) as string if HasUnoInterfaces(oDoc, "com.sun.star.lang.XServiceInfo") then if thisComponent.supportsService ("com.sun.star.text.GenericTextDocument") then fnWhichComponent = "Text" elseif thisComponent.supportsService("com.sun.star.sheet.SpreadsheetDocument") then fnWhichComponent = "Spreadsheet" elseif thisComponent.supportsService("com.sun.star.presentation.PresentationDocument") then fnWhichComponent = "Presentation" elseif thisComponent.supportsService("com.sun.star.drawing.GenericDrawingDocument") then fnWhichComponent = "Drawing" else fnWhichComponent = "Oops current document something else" end if else fnWhichComponent = "Not a document" end if End function </pre>
An example of calling this function is:
<pre> if fnWhichComponent(thisComponent) <> "Text" then msgbox "Sorry - this only works for text documents", 16, "Error" exit sub end if </pre>