*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> DtWsmSetWorkspaceTitle (3)              


 DtWsmSetWorkspaceTitle(API)                     DtWsmSetWorkspaceTitle(API)

 NAME    [Toc]    [Back]
      DtWsmSetWorkspaceTitle - set workspace title

 SYNOPSIS    [Toc]    [Back]
      #include <Dt/Wsm.h>
      int DtWsmSetWorkspaceTitle(
      Widget widget,
      Atom workspace,
      char *title);

 DESCRIPTION    [Toc]    [Back]
      The DtWsmSetWorkspaceTitle() function works with the CDE workspace
      manager, dtwm(1), and changes a specific workspace's title.
      Applications can use this function to implement an interface to the
      workspace manager.

      If the DtWsmSetWorkspaceTitle() function is not successful, the most
      likely reason for failure is that the CDE workspace manager, dtwm(1),
      is not running.  The DtWsmSetWorkspaceTitle() function requires a
      widget. A gadget (or unrealized widget) is not acceptable for the
      widget argument.

      DtWsmSetWorkspaceTitle() sends a message to the CDE workspace manager,
      dtwm(1), to set the title. If the workspace name is not valid, no
      action is taken and the workspace manager reports no error.

 ARGUMENTS    [Toc]    [Back]
      widget    A realized widget on the screen of interest

      workspace The name of the workspace (in X atom form) where the title
                should be set

      title     The new title

 RETURN VALUE    [Toc]    [Back]
      The function returns Success (0) when it succeeds, and non-zero upon
      failure.  Note that these are not the same values that
      _DtWsmSetWorkspaceTitle returns.

 SEE ALSO    [Toc]    [Back]

      "Communicating with the Workspace Manager" section in the CDE
      Programmer's Guide

      "Workspace Manager" section in the CDE Programmer's Overview

                                    - 1 -       Formatted:  January 24, 2005
[ Back ]
 Similar pages
Name OS Title
setproctitle FreeBSD set process title
setproctitle OpenBSD set process title
setproctitle NetBSD set process title
DtMmdbBookGetShortTitle HP-UX obtains the short title of a book
DtMmdbSectionGetLongTitle HP-UX obtains the long title for a section
DtMmdbBookGetLongTitle HP-UX obtains the long title of a book
DtMmdbSectionGetShortTitle HP-UX obtains the short title for a section
wintitle IRIX adds a title bar to the current graphics window
icontitle IRIX assigns the icon title for the current graphics window.
DtWsmAddWorkspace HP-UX add a workspace
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service