pad_set_icon_font()

PAD_$SET_ICON_FONT                Domain/OS                 PAD_$SET_ICON_FONT


NAME
     pad_$set_icon_font - choose a new icon font

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/pad.h>

     void pad_$set_icon_font(
          ios_$id_t &stream_id,
          short &window_no,
          char *font_name,
          short &font_len,
          status_$t *status)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/pad.ins.pas';

     procedure pad_$set_icon_font(
          in stream_id: ios_$id_t;
          in window_no: integer;
          in font_name: univ name_$long_pname_t;
          in font_len: integer;
          out status: status_$t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/pad.ins.ftn'

           integer*4 status
           integer*2 stream_id, window_no, font_len
           character font_name*1023

           call pad_$set_icon_font(stream_id, window_no, font_name,
          &                        font_len, status)

DESCRIPTION
     Call pad_$set_icon_font to change the icon font in use for the window
     specified by stream_id and window_no.  Pad_$set_icon_font changes the
     font for the specified window only.  Find out the current icon font by
     calling pad_$inq_icon_font.  The default icon font file is
     /sys/dm/fonts/icons.

     Whenever a window is created, the Display Manager assigns it an icon from
     the current icon font.  The default icon font file is
     /sys/dm/fonts/icons.

     stream_id
          The stream ID for the pad viewed by the window.

     window_no
          The number of the window to use the new font.  Window_no is an index
          into the window list returned by pad_$inq_windows.  A window_no of 1
          refers to the first window created to view the pad.

     font_name
          The full pathname of the font file up to the node entry directory
          (/).

     font_len
          The number of bytes in font_name.

     status
          The completion status.
Museum
