Wt::WAnchor Class Reference

A widget that represents an HTML anchor (to link to other documents). More...

#include <Wt/WAnchor>

Inheritance diagram for Wt::WAnchor:

Inheritance graph
[legend]

List of all members.

Public Member Functions

 WAnchor (WContainerWidget *parent=0)
 Create an anchor.
 WAnchor (const std::string &url, WContainerWidget *parent=0)
 Create an anchor referring to a URL.
 WAnchor (WResource *resource, WContainerWidget *parent=0)
 Create an anchor referring to a resource.
 WAnchor (const std::string &url, const WString &text, WContainerWidget *parent=0)
 Create an anchor referring to a URL, using a text message.
 WAnchor (WResource *resource, const WString &text, WContainerWidget *parent=0)
 Create an anchor reffering to a resource, using a text message.
 WAnchor (const std::string &ref, WImage *image, WContainerWidget *parent=0)
 Create an anchor reffering to a URL, using an image.
 WAnchor (WResource *resource, WImage *image, WContainerWidget *parent=0)
 Create an anchor reffering to a resource, using an image.
void setRef (const std::string &url)
 Set the destination URL.
void setRefInternalPath (const std::string &path)
 Set the destination URL to an internal path.
const std::string & ref () const
 Returns the destination URL.
void setResource (WResource *resource)
 Set a destination resource.
WResourceresource () const
 Returns the destination resource.
void setText (const WString &text)
 Sets a text label.
const WStringtext () const
 Returns the label text.
void setWordWrap (bool on)
 Configure text word wrapping.
bool wordWrap () const
 Returns whether the widget may break lines.
void setImage (WImage *image)
 Set an image.
WImageimage () const
 Returns the image.
void setTarget (AnchorTarget target)
 Set the location where the referred content should be displayed.
AnchorTarget target () const
 Returns the location where the referred content should be displayed.


Detailed Description

A widget that represents an HTML anchor (to link to other documents).

WAnchor is an inline widget.

Use an anchor to link to an internal path or another web page, document or resource. The anchor may contain text, image, or any other widget (since it inherits from WContainerWidget). A click will activate the target link.

Note:
If you set a text or image using one of the API methods like setText() or setImage() or a constructor, you should not attempt to remove all contents (using clear(), or provide a layout (using setLayout()), as this will result in undefined behaviour.

Constructor & Destructor Documentation

Wt::WAnchor::WAnchor ( WResource resource,
WContainerWidget parent = 0 
)

Create an anchor referring to a resource.

A resource specifies application-dependent content, which may be generated by your application on demand.

The anchor does not assume ownership of the resource.

Wt::WAnchor::WAnchor ( WResource resource,
const WString text,
WContainerWidget parent = 0 
)

Create an anchor reffering to a resource, using a text message.

A resource specifies application-dependent content, which may be generated by your application on demand.

The anchor does not assume ownership of the resource.

Wt::WAnchor::WAnchor ( const std::string &  ref,
WImage image,
WContainerWidget parent = 0 
)

Create an anchor reffering to a URL, using an image.

Ownership of the image is transferred to the anchor.

Wt::WAnchor::WAnchor ( WResource resource,
WImage image,
WContainerWidget parent = 0 
)

Create an anchor reffering to a resource, using an image.

A resource specifies application-dependent content, which may be generated by your application on demand.

The anchor does not assume ownership of the resource.

Ownership of the image is transferred to the anchor.


Member Function Documentation

void Wt::WAnchor::setRef ( const std::string &  url  ) 

Set the destination URL.

This method should not be used when the anchor has been pointed to a dynamically generated resource using setResource().

See also:
setResource(), setRefInternalPath()

void Wt::WAnchor::setRefInternalPath ( const std::string &  path  ) 

Set the destination URL to an internal path.

Sets the anchor to point to the internal path path. When the anchor is activated, the internal path is set to path, and the WApplication::internalPathChanged signal is emitted. The path change is handled within the current session.

This is the easiest way to let the application participate in browser history, and generate URLs that are bookmarkable.

Internally, this method binds sets the destination URL using:

 setRef(wApp->bookmarkUrl(path))
The clicked signal is connected to a slot that changes the internal path using
 wApp->setInternalPath(ref(), true);

See also:
setRef(), setResource()

WApplication::bookmarkUrl(), WApplication::setInternalPath()

const std::string& Wt::WAnchor::ref (  )  const [inline]

Returns the destination URL.

When the anchor refers to a resource, the current resource URL is returned. When the anchor refers to an internal path, the internal path is returned. Otherwise, the URL is returned that was set using setRef().

See also:
setRef(), WResource::generateUrl()

void Wt::WAnchor::setResource ( WResource resource  ) 

Set a destination resource.

A resource specifies application-dependent content, which may be generated by your application on demand.

This sets the resource as the destination of the anchor, and is an alternative to setRef(). The resource may be cleared by passing resource = 0.

The anchor does not assume ownership of the resource.

See also:
setRef()

WResource* Wt::WAnchor::resource (  )  const [inline]

Returns the destination resource.

Returns 0 if no resource has been set.

See also:
setResource()

void Wt::WAnchor::setText ( const WString text  ) 

Sets a text label.

If no text was previously set, a new WText widget is added using addWidget().

const WString & Wt::WAnchor::text (  )  const

Returns the label text.

Returns an empty string if no label was set.

See also:
setText()

void Wt::WAnchor::setWordWrap ( bool  on  ) 

Configure text word wrapping.

When on is true, the text set with setText() may be broken up over multiple lines. When on is false, the text will displayed on a single line, unless the text contains <br /> tags or other block-level tags.

The default value is true.

See also:
wordWrap()

bool Wt::WAnchor::wordWrap (  )  const

Returns whether the widget may break lines.

See also:
setWordWrap(bool)

void Wt::WAnchor::setImage ( WImage image  ) 

Set an image.

If an image was previously set, it is deleted. The image is added using addWidget().

Ownership of the image is transferred to the anchor.

WImage* Wt::WAnchor::image (  )  const [inline]

Returns the image.

Returns 0 if no image is set.

See also:
setImage()

void Wt::WAnchor::setTarget ( AnchorTarget  target  ) 

Set the location where the referred content should be displayed.

By default, the referred content is displayed in the application (Wt::TargetSelf). When the destination is an HTML document, the application is replaced with the new document. When the reference is a document that cannot be displayed in the browser, it is offered for download or opened using an external program, depending on browser settings.

By setting target to Wt::TargetNewWindow, the destination is displayed in a new browser window or tab.

See also:
target()

AnchorTarget Wt::WAnchor::target (  )  const [inline]

Returns the location where the referred content should be displayed.

See also:
setTarget()


Generated on Mon Jan 26 14:14:05 2009 for Wt by doxygen 1.5.6