pad_inq_icon_font()

PAD_$INQ_ICON_FONT                Domain/OS                 PAD_$INQ_ICON_FONT


NAME
     pad_$inq_icon_font - get the current icon font

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

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

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

     procedure pad_$inq_icon_font(
          in stream_id: ios_$id_t;
          in window_no: integer;
          out font_name: univ name_$long_pname_t;
          in font_buf_len: integer;
          out 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_width
           integer*2 font_buf_len, font_len
           character font_name*1023

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

DESCRIPTION
     Pad_$inq_icon_font gets the pathname of the icon font in use for the win-
     dow described by stream_id and window_no.

     stream_id
          The stream ID for the window inquired about.

     window_no
          The window number for which information is wanted.  Window_no is an
          index into the window list returned by pad_$inq_windows.  A
          window_no of 1 always 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
          (/).  If the the number of bytes in font_name exceeds font_buf_len,
          the Display Manager truncates the returned pathname.

     font_buf_len
          The number of bytes available in the font_name string buffer.
          Pad_$inq_icon_font fills the buffer with up to font_buf_len charac-
          ters.  Specify a font_buf_len of 0 if the font file pathname is not
          needed.

     font_len
          The number of bytes in font_name.  If this value is greater than
          font_buf_len, the Display Manager truncates the returned pathname.

     status
          The completion status.

NOTES
     The default icon font file is /sys/dm/fonts/icons.  A program can change
     the icon font with pad_$set_icon_font.

SEE ALSO
     pad_$create_icon, pad_$icon_wait, pad_$inq_icon, pad_$is_icon,
     pad_$make_icon, pad_$set_icon_pos.
Museum
