Difference between revisions of "Documentation/How Tos/Calc: HYPERLINK function"
From Apache OpenOffice Wiki
< Documentation | How Tos
OOoWikiBot (Talk | contribs) m (Robot: Automated text replacement %s) |
(Paragraph formatting: formulas without line break) |
||
Line 22: | Line 22: | ||
:: 1. that cell becomes a hyperlinked cell; that is, if you click on it it will attempt to open a page in a browser window. | :: 1. that cell becomes a hyperlinked cell; that is, if you click on it it will attempt to open a page in a browser window. | ||
− | ::: For example, in a cell with <tt>'''=IF(TRUE(); "some text"; HYPERLINK("<nowiki>http://www.example.com</nowiki>"))'''</tt> the <tt>'''HYPERLINK'''</tt> function is never evaluated - but nevertheless the cell becomes a hyperlinked cell (although the link will fail - see 2. below). | + | ::: For example, in a cell with <br /><tt>'''=IF(TRUE(); "some text"; HYPERLINK("<nowiki>http://www.example.com</nowiki>"))'''</tt> <br />the <tt>'''HYPERLINK'''</tt> function is never evaluated - but nevertheless the cell becomes a hyperlinked cell (although the link will fail - see 2. below). |
:: 2. the <u>formula</u> in the cell is evaluated '''twice'''. | :: 2. the <u>formula</u> in the cell is evaluated '''twice'''. | ||
Line 28: | Line 28: | ||
::: ii) The second time, any <tt>'''HYPERLINK'''</tt> function returns <tt>'''celltext'''</tt> (or <tt>'''linkaddress'''</tt> if no <tt>'''celltext'''</tt> is given), and the result of the formula is displayed in the cell. | ::: ii) The second time, any <tt>'''HYPERLINK'''</tt> function returns <tt>'''celltext'''</tt> (or <tt>'''linkaddress'''</tt> if no <tt>'''celltext'''</tt> is given), and the result of the formula is displayed in the cell. | ||
− | ::: For example, <tt>'''= "h" & HYPERLINK("ttp://"; "ot ") & HYPERLINK("<nowiki>www.example.com</nowiki>"; "link")'''</tt> evaluates twice. The first time <tt>'''"h"'''</tt> & <tt>'''"ttp://"'''</tt> & <tt>'''"<nowiki>www.example.com</nowiki>"'''</tt> are concatenated to form <tt>'''"<nowiki>http://www.example.com</nowiki>"'''</tt> - the address to link to. The second time <tt>'''"h"'''</tt> & <tt>'''"ot "'''</tt> & <tt>'''"link"'''</tt> are concatenated to form <tt>'''"hot link"'''</tt> - the text that appears in the cell. | + | ::: For example, <br /><tt>'''= "h" & HYPERLINK("ttp://"; "ot ") & HYPERLINK("<nowiki>www.example.com</nowiki>"; "link")'''</tt><br /> evaluates twice. The first time <tt>'''"h"'''</tt> & <tt>'''"ttp://"'''</tt> & <tt>'''"<nowiki>www.example.com</nowiki>"'''</tt> are concatenated to form <tt>'''"<nowiki>http://www.example.com</nowiki>"'''</tt> - the address to link to. The second time <tt>'''"h"'''</tt> & <tt>'''"ot "'''</tt> & <tt>'''"link"'''</tt> are concatenated to form <tt>'''"hot link"'''</tt> - the text that appears in the cell. |
− | ::: For example, <tt>'''= "h" & HYPERLINK("ttp://"; "ere is ") & HYPERLINK("www.example.com")'''</tt> evaluates firstly to concatenate <tt>'''"h"'''</tt> & <tt>'''"ttp://"'''</tt> & <tt>'''"www.example.com"'''</tt>, forming <tt>'''"<nowiki>http://www.example.com</nowiki>"'''</tt> - the address to link to, and secondly to concatenate <tt>'''"h"'''</tt> & <tt>'''"ere is "'''</tt> & <tt>'''"www.example.com"'''</tt>, forming <tt>'''"here is <nowiki>www.example.com</nowiki>"'''</tt> - the text that appears in the cell. | + | ::: For example, <br /> <tt>'''= "h" & HYPERLINK("ttp://"; "ere is ") & HYPERLINK("www.example.com")'''</tt> <br /> evaluates firstly to concatenate <tt>'''"h"'''</tt> & <tt>'''"ttp://"'''</tt> & <tt>'''"www.example.com"'''</tt>, forming <tt>'''"<nowiki>http://www.example.com</nowiki>"'''</tt> - the address to link to, and secondly to concatenate <tt>'''"h"'''</tt> & <tt>'''"ere is "'''</tt> & <tt>'''"www.example.com"'''</tt>, forming <tt>'''"here is <nowiki>www.example.com</nowiki>"'''</tt> - the text that appears in the cell. |
:: 3. If any error is returned, the cell ceases to be a hyperlinked cell. | :: 3. If any error is returned, the cell ceases to be a hyperlinked cell. |
Revision as of 09:25, 20 March 2010
HYPERLINK
Sets a cell to open a hyperlink (in another application) when clicked.
Syntax:
HYPERLINK(linkaddress; celltext)
- A cell containing a HYPERLINK function will open a hyperlink when the cell is clicked.
- linkaddress is the address (as text) that is opened. celltext is the text displayed in the cell. If celltext is omitted, linkaddress is displayed in the cell.
- To edit a hyperlinked cell, select a nearby cell, and navigate to the hyperlinked cell using the keyboard arrows (if you click directly, it will open the hyperlink).
- For common, straightforward usage of HYPERLINK, see the Examples section.
- If you need a fuller explanation of the unique way in which HYPERLINK works, it follows now:
- If a cell contains a HYPERLINK function (even if the HYPERLINK function is not evaluated):
- 1. that cell becomes a hyperlinked cell; that is, if you click on it it will attempt to open a page in a browser window.
- For example, in a cell with
=IF(TRUE(); "some text"; HYPERLINK("http://www.example.com"))
the HYPERLINK function is never evaluated - but nevertheless the cell becomes a hyperlinked cell (although the link will fail - see 2. below).
- For example, in a cell with
- 2. the formula in the cell is evaluated twice.
- i) The first time, any HYPERLINK function returns linkaddress, and the result of the formula becomes the address to link to.
- ii) The second time, any HYPERLINK function returns celltext (or linkaddress if no celltext is given), and the result of the formula is displayed in the cell.
- 2. the formula in the cell is evaluated twice.
- For example,
= "h" & HYPERLINK("ttp://"; "ot ") & HYPERLINK("www.example.com"; "link")
evaluates twice. The first time "h" & "ttp://" & "www.example.com" are concatenated to form "http://www.example.com" - the address to link to. The second time "h" & "ot " & "link" are concatenated to form "hot link" - the text that appears in the cell.
- For example,
- For example,
= "h" & HYPERLINK("ttp://"; "ere is ") & HYPERLINK("www.example.com")
evaluates firstly to concatenate "h" & "ttp://" & "www.example.com", forming "http://www.example.com" - the address to link to, and secondly to concatenate "h" & "ere is " & "www.example.com", forming "here is www.example.com" - the text that appears in the cell.
- For example,
- 3. If any error is returned, the cell ceases to be a hyperlinked cell.
- The examples above illustrate how HYPERLINK works - but not how it should be used.
Example:
=HYPERLINK("http://www.example.org")
- displays http://www.example.org in the cell and opens the hyperlink http://www.example.org when clicked.
=HYPERLINK("http://www.example.org"; "Click here")
- displays Click here in the cell and opens the hyperlink http://www.example.org when clicked.
=HYPERLINK("http://www."; "Click ") & "example.org"
- displays Click example.org in the cell and opens the hyperlink http://www.example.org when clicked.
Issues:
- Text rotated through 90 degrees may not be clickable (issue 74471).
- The mouse pointer may not revert after leaving the "Format Cells" dialog (issue 74490).