Unit 'intuition' Package
[Overview][Constants][Types][Procedures and functions][Variables][Index] [#os4units]

NextPubScreen

Identify next public screen in the cycle.

Declaration

Source position: intuition.pas line 3891

function NextPubScreen(

  const Screen: PScreen;

  NameBuf: PChar

):PChar;

Arguments

Screen

  

A pointer to the public screen your window is open in or nil if you don't have a pointer to a public screen.

NameBuf

  

A pointer to a buffer with (at least) MAXPUBSCREENNAME + 1 characters to put the name of the next public screen in.

Function result

Returns namebuff or nil if there are no public screens.

Description

Returns name of next public screen in system rotation, to allow visitor windows to provide function to "jump" among public-screens in a cycle.

Notes:

There is no guarantee that the public screen whose name was returned by this function will exist or be in "public" state by the time you call LockPubScreen(), etc. You must handle cases where LockPubScreen(), etc. will fail.

Note that this function may return the name of a public screen which is open but in "private mode" (see PubScreenStatus() and PSNF_PRIVATE).

The cycle order is undefined, so draw no conclusions based on it!

See also

OpenScreen

  

Open an Intuition screen

PubScreenStatus

  

Change status flags for a public screen.


Documentation generated on: 2021-07-30