# setDisplayPortrait()

Description:

The `setDisplayPortrait` method changes the orientation of a widget's screen to the portrait mode.

Syntax:

    [void] window.widget.setDisplayPortrait(void)

or

    [void] widget.setDisplayPortrait(void)

Arguments:

This method does not take any arguments.

Return value:

This method does not return a value.

Remarks:

`setDisplayPortrait()` should be used only if a device supports screen orientation changes. To check this, use the `isrotationsupported` property.

This method only changes the orientation of the screen. It does not change the behavior of other UI components of a device such as the softkeys and their associated keys.

For more information on handling screen orientation changes in a widget, see Designing for dynamic screen orientation.

Example code:

    if (widget.isrotationsupported)
       // change the screen orientation
       widget.setDisplayPortrait();