Difference between revisions of "Currently active document"

From Apache OpenOffice Wiki
Jump to: navigation, search
(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:  
  
<code>[oobas]
+
<source lang="oobas">
 
  StarDesktop.CurrentComponent
 
  StarDesktop.CurrentComponent
</code>
+
</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:  
  
<code>[oobas]<pre>
+
<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></code>
+
</pre></source>
 
   
 
   
  
 
An example of calling this function is:  
 
An example of calling this function is:  
  
<code>[oobas]<pre>
+
<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></code>
+
</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>
Personal tools