Provided by: libprima-perl_1.28-1.2_amd64 bug

NAME

       Prima::Const - predefined constants

DESCRIPTION

       "Prima::Const" and Prima::Classes is a minimal set of perl modules needed for the toolkit.
       Since the module provides bindings for the core constants, it is required to be included
       in every Prima-related module and program.

       The constants are assembled under the top-level package names, with no "Prima::" prefix.
       This violates the perl guidelines about package naming, however, it was considered way too
       inconvenient to prefix every constant with "Prima::" string.

       This document provides description of all core-coded constants. The constants are also
       described in the articles together with the corresponding methods and properties. For
       example, "nt" constants are also described in "Flow" in Prima::Object article.

API

   am::  - Prima::Icon auto masking
       See also "autoMasking" in Prima::Image

               am::None           - no mask update performed
               am::MaskColor      - mask update based on Prima::Icon::maskColor property
               am::MaskIndex      - mask update based on Prima::Icon::maskIndex property
               am::Auto           - mask update based on corner pixel values

   apc:: - OS type
       See "get_system_info" in Prima::Application

               apc::Os2
               apc::Win32
               apc::Unix

   bi::  - border icons
       See "borderIcons" in Prima::Window

               bi::SystemMenu  - system menu button and/or close button
                                 ( usually with icon ) is shown
               bi::Minimize    - minimize button
               bi::Maximize    - maximize ( and eventual restore )
               bi::TitleBar    - window title
               bi::All         - all of the above

   bs::  - border styles
       See "borderStyle" in Prima::Window

               bs::None      - no border
               bs::Single    - thin border
               bs::Dialog    - thick border
               bs::Sizeable  - thick border with interactive resize capabilities

   ci::  - color indices
       See "colorIndex" in Prima::Widget

               ci::NormalText or ci::Fore
               ci::Normal or ci::Back
               ci::HiliteText
               ci::Hilite
               ci::DisabledText
               ci::Disabled
               ci::Light3DColor
               ci::Dark3DColor
               ci::MaxId

   cl:: - colors
       See "colorIndex" in Prima::Widget

       Direct color constants
                   cl::Black
                   cl::Blue
                   cl::Green
                   cl::Cyan
                   cl::Red
                   cl::Magenta
                   cl::Brown
                   cl::LightGray
                   cl::DarkGray
                   cl::LightBlue
                   cl::LightGreen
                   cl::LightCyan
                   cl::LightRed
                   cl::LightMagenta
                   cl::Yellow
                   cl::White
                   cl::Gray

       Indirect color constants
                   cl::NormalText, cl::Fore
                   cl::Normal, cl::Back
                   cl::HiliteText
                   cl::Hilite
                   cl::DisabledText
                   cl::Disabled
                   cl::Light3DColor
                   cl::Dark3DColor
                   cl::MaxSysColor

       Special constants
           See "Colors" in Prima::gp_problems

                   cl::Set      - logical all-1 color
                   cl::Clear    - logical all-0 color
                   cl::Invalid  - invalid color value
                   cl::SysFlag  - indirect color constant bit set
                   cl::SysMask  - indirect color constant bit clear mask

   cm::  - commands
       Keyboard and mouse commands
           See "key_down" in Prima::Widget, "mouse_down" in Prima::Widget

                   cm::KeyDown
                   cm::KeyUp
                   cm::MouseDown
                   cm::MouseUp
                   cm::MouseClick
                   cm::MouseWheel
                   cm::MouseMove
                   cm::MouseEnter
                   cm::MouseLeave

       Internal commands ( used in core only or not used at all )
                   cm::Close
                   cm::Create
                   cm::Destroy
                   cm::Hide
                   cm::Show
                   cm::ReceiveFocus
                   cm::ReleaseFocus
                   cm::Paint
                   cm::Repaint
                   cm::Size
                   cm::Move
                   cm::ColorChanged
                   cm::ZOrderChanged
                   cm::Enable
                   cm::Disable
                   cm::Activate
                   cm::Deactivate
                   cm::FontChanged
                   cm::WindowState
                   cm::Timer
                   cm::Click
                   cm::CalcBounds
                   cm::Post
                   cm::Popup
                   cm::Execute
                   cm::Setup
                   cm::Hint
                   cm::DragDrop
                   cm::DragOver
                   cm::EndDrag
                   cm::Menu
                   cm::EndModal
                   cm::MenuCmd
                   cm::TranslateAccel
                   cm::DelegateKey

   cr::  - pointer cursor resources
       See "pointerType" in Prima::Widget

               cr::Default                 same pointer type as owner's
               cr::Arrow                   arrow pointer
               cr::Text                    text entry cursor-like pointer
               cr::Wait                    hourglass
               cr::Size                    general size action pointer
               cr::Move                    general move action pointer
               cr::SizeWest, cr::SizeW     right-move action pointer
               cr::SizeEast, cr::SizeE     left-move action pointer
               cr::SizeWE                  general horizontal-move action pointer
               cr::SizeNorth, cr::SizeN    up-move action pointer
               cr::SizeSouth, cr::SizeS    down-move action pointer
               cr::SizeNS                  general vertical-move action pointer
               cr::SizeNW                  up-right move action pointer
               cr::SizeSE                  down-left move action pointer
               cr::SizeNE                  up-left move action pointer
               cr::SizeSW                  down-right move action pointer
               cr::Invalid                 invalid action pointer
               cr::User                    user-defined icon

   dt::  - drive types
       See "query_drive_type" in Prima::Utils

               dt::None
               dt::Unknown
               dt::Floppy
               dt::HDD
               dt::Network
               dt::CDROM
               dt::Memory

   dt::  - Prima::Drawable::draw_text constants
               dt::Left              - text is aligned to the left boundary
               dt::Right             - text is aligned to the right boundary
               dt::Center            - text is aligned horizontally in center
               dt::Top               - text is aligned to the upper boundary
               dt::Bottom            - text is aligned to the lower boundary
               dt::VCenter           - text is aligned vertically in center
               dt::DrawMnemonic      - tilde-escapement and underlining is used
               dt::DrawSingleChar    - sets tw::BreakSingle option to
                                       Prima::Drawable::text_wrap call
               dt::NewLineBreak      - sets tw::NewLineBreak option to
                                       Prima::Drawable::text_wrap call
               dt::SpaceBreak        - sets tw::SpaceBreak option to
                                       Prima::Drawable::text_wrap call
               dt::WordBreak         - sets tw::WordBreak option to
                                       Prima::Drawable::text_wrap call
               dt::ExpandTabs        - performs tab character ( \t ) expansion
               dt::DrawPartial       - draws the last line, if it is visible partially
               dt::UseExternalLeading- text lines positioned vertically with respect to
                                       the font external leading
               dt::UseClip           - assign ::clipRect property to the boundary rectangle
               dt::QueryLinesDrawn   - calculates and returns number of lines drawn
                                       ( contrary to dt::QueryHeight )
               dt::QueryHeight       - if set, calculates and returns vertical extension
                                       of the lines drawn
               dt::NoWordWrap        - performs no word wrapping by the width of the boundaries
               dt::WordWrap          - performs word wrapping by the width of the boundaries
               dt::Default           - dt::NewLineBreak|dt::WordBreak|dt::ExpandTabs|
                                       dt::UseExternalLeading

   fdo:: - find / replace dialog options
       See Prima::EditDialog

               fdo::MatchCase
               fdo::WordsOnly
               fdo::RegularExpression
               fdo::BackwardSearch
               fdo::ReplacePrompt

   fds:: - find / replace dialog scope type
       See Prima::EditDialog

               fds::Cursor
               fds::Top
               fds::Bottom

   fe::  - file events constants
       See Prima::File

               fe::Read
               fe::Write
               fe::Exception

   fp::  - standard fill pattern indices
       See "fillPattern" in Prima::Drawable

               fp::Empty
               fp::Solid
               fp::Line
               fp::LtSlash
               fp::Slash
               fp::BkSlash
               fp::LtBkSlash
               fp::Hatch
               fp::XHatch
               fp::Interleave
               fp::WideDot
               fp::CloseDot
               fp::SimpleDots
               fp::Borland
               fp::Parquet

   fp::  - font pitches
       See "pitch" in Prima::Drawable

               fp::Default
               fp::Fixed
               fp::Variable

   fr::  - fetch resource constants
       See "fetch_resource" in Prima::Widget

               fr::Color
               fr::Font
               fs::String

   fs::  - font styles
       See "style" in Prima::Drawable

               fs::Normal
               fs::Bold
               fs::Thin
               fs::Italic
               fs::Underlined
               fs::StruckOut
               fs::Outline

   fw::  - font weights
       See "weight" in Prima::Drawable

               fw::UltraLight
               fw::ExtraLight
               fw::Light
               fw::SemiLight
               fw::Medium
               fw::SemiBold
               fw::Bold
               fw::ExtraBold
               fw::UltraBold

   gm::  - grow modes
       See "growMode" in Prima::Widget

       Basic constants
                   gm::GrowLoX     widget's left side is kept in constant
                                   distance from owner's right side
                   gm::GrowLoY     widget's bottom side is kept in constant
                                   distance from owner's top side
                   gm::GrowHiX     widget's right side is kept in constant
                                   distance from owner's right side
                   gm::GrowHiY     widget's top side is kept in constant
                                   distance from owner's top side
                   gm::XCenter     widget is kept in center on its owner's
                                   horizontal axis
                   gm::YCenter     widget is kept in center on its owner's
                                   vertical axis
                   gm::DontCare    widgets origin is maintained constant relative
                                   to the screen

       Derived or aliased constants
                   gm::GrowAll      gm::GrowLoX|gm::GrowLoY|gm::GrowHiX|gm::GrowHiY
                   gm::Center       gm::XCenter|gm::YCenter
                   gm::Client       gm::GrowHiX|gm::GrowHiY
                   gm::Right        gm::GrowLoX|gm::GrowHiY
                   gm::Left         gm::GrowHiY
                   gm::Floor        gm::GrowHiX

   gui:: - GUI types
       See "get_system_info" in Prima::Application

               gui::Default
               gui::PM
               gui::Windows
               gui::XLib
               gui::GTK2

   le::  - line end styles
       See "lineEnd" in Prima::Drawable

               le::Flat
               le::Square
               le::Round

   lj::  - line join styles
       See "lineJoin" in Prima::Drawable

               lj::Round
               lj::Bevel
               lj::Miter

   lp::  - predefined line pattern styles
       See "linePattern" in Prima::Drawable

               lp::Null           #    ""              /*              */
               lp::Solid          #    "\1"            /* ___________  */
               lp::Dash           #    "\x9\3"         /* __ __ __ __  */
               lp::LongDash       #    "\x16\6"        /* _____ _____  */
               lp::ShortDash      #    "\3\3"          /* _ _ _ _ _ _  */
               lp::Dot            #    "\1\3"          /* . . . . . .  */
               lp::DotDot         #    "\1\1"          /* ............ */
               lp::DashDot        #    "\x9\6\1\3"     /* _._._._._._  */
               lp::DashDotDot     #    "\x9\3\1\3\1\3" /* _.._.._.._.. */

   im::  - image types
       See "type" in Prima::Image.

       Bit depth constants
                   im::bpp1
                   im::bpp4
                   im::bpp8
                   im::bpp16
                   im::bpp24
                   im::bpp32
                   im::bpp64
                   im::bpp128

       Pixel format constants
                   im::Color
                   im::GrayScale
                   im::RealNumber
                   im::ComplexNumber
                   im::TrigComplexNumber

       Mnemonic image types
                   im::Mono          - im::bpp1
                   im::BW            - im::bpp1 | im::GrayScale
                   im::16            - im::bpp4
                   im::Nibble        - im::bpp4
                   im::256           - im::bpp8
                   im::RGB           - im::bpp24
                   im::Triple        - im::bpp24
                   im::Byte          - gray 8-bit unsigned integer
                   im::Short         - gray 16-bit unsigned integer
                   im::Long          - gray 32-bit unsigned integer
                   im::Float         - float
                   im::Double        - double
                   im::Complex       - dual float
                   im::DComplex      - dual double
                   im::TrigComplex   - dual float
                   im::TrigDComplex  - dual double

       Extra formats
                   im::fmtBGR
                   im::fmtRGBI
                   im::fmtIRGB
                   im::fmtBGRI
                   im::fmtIBGR

       Masks
                   im::BPP      - bit depth constants
                   im::Category - category constants
                   im::FMT      - extra format constants

   ict:: - image conversion types
       See "conversion" in Prima::Image.

               ict::None            - no dithering
               ict::Ordered         - 8x8 ordered halftone dithering
               ict::ErrorDiffusion  - error diffusion dithering with static palette
               ict::Optimized       - error diffusion dithering with optimized palette

   is::  - image statistics indices
       See "stats" in Prima::Image.

               is::RangeLo  - minimum pixel value
               is::RangeHi  - maximum pixel value
               is::Mean     - mean value
               is::Variance - variance
               is::StdDev   - standard deviation
               is::Sum      - sum of pixel values
               is::Sum2     - sum of squares of pixel values

   kb::  - keyboard virtual codes
       See also "KeyDown" in Prima::Widget.

       Modificator keys
                   kb::ShiftL   kb::ShiftR   kb::CtrlL      kb::CtrlR
                   kb::AltL     kb::AltR     kb::MetaL      kb::MetaR
                   kb::SuperL   kb::SuperR   kb::HyperL     kb::HyperR
                   kb::CapsLock kb::NumLock  kb::ScrollLock kb::ShiftLock

       Keys with character code defined
                   kb::Backspace  kb::Tab    kb::Linefeed   kb::Enter
                   kb::Return     kb::Escape kb::Esc        kb::Space

       Function keys
                   kb::F1 .. kb::F30
                   kb::L1 .. kb::L10
                   kb::R1 .. kb::R10

       Other
                   kb::Clear    kb::Pause   kb::SysRq  kb::SysReq
                   kb::Delete   kb::Home    kb::Left   kb::Up
                   kb::Right    kb::Down    kb::PgUp   kb::Prior
                   kb::PageUp   kb::PgDn    kb::Next   kb::PageDown
                   kb::End      kb::Begin   kb::Select kb::Print
                   kb::PrintScr kb::Execute kb::Insert kb::Undo
                   kb::Redo     kb::Menu    kb::Find   kb::Cancel
                   kb::Help     kb::Break   kb::BackTab

       Masking constants
                   kb::CharMask - character codes
                   kb::CodeMask - virtual key codes ( all other kb:: values )
                   kb::ModMask  - km:: values

   km::  - keyboard modifiers
       See also "KeyDown" in Prima::Widget.

               km::Shift
               km::Ctrl
               km::Alt
               km::KeyPad
               km::DeadKey

   mt:: - modality types
       See "get_modal" in Prima::Window, "get_modal_window" in Prima::Window

               mt::None
               mt::Shared
               mt::Exclusive

   nt::  - notification types
       Used in "Prima::Component::notification_types" to describe event flow.

       See also "Flow" in Prima::Object.

       Starting point constants
                   nt::PrivateFirst
                   nt::CustomFirst

       Direction constants
                   nt::FluxReverse
                   nt::FluxNormal

       Complexity constants
                   nt::Single
                   nt::Multiple
                   nt::Event

       Composite constants
                   nt::Default       ( PrivateFirst | Multiple | FluxReverse)
                   nt::Property      ( PrivateFirst | Single   | FluxNormal )
                   nt::Request       ( PrivateFirst | Event    | FluxNormal )
                   nt::Notification  ( CustomFirst  | Multiple | FluxReverse )
                   nt::Action        ( CustomFirst  | Single   | FluxReverse )
                   nt::Command       ( CustomFirst  | Event    | FluxReverse )

   mb::  - mouse buttons
       See also "MouseDown" in Prima::Widget.

               mb::b1 or mb::Left
               mb::b2 or mb::Middle
               mb::b3 or mb::Right
               mb::b4
               mb::b5
               mb::b6
               mb::b7
               mb::b8

   mb:: - message box constants
       Message box and modal result button commands
           See also "modalResult" in Prima::Window, "modalResult" in Prima::Button.

                   mb::OK, mb::Ok
                   mb::Cancel
                   mb::Yes
                   mb::No
                   mb::Abort
                   mb::Retry
                   mb::Ignore
                   mb::Help

       Message box composite ( multi-button ) constants
                   mb::OKCancel, mb::OkCancel
                   mb::YesNo
                   mb::YesNoCancel

       Message box icon and bell constants
                   mb::Error
                   mb::Warning
                   mb::Information
                   mb::Question

   rop:: - raster operation codes
       See "Raster operations" in Prima::Drawable

               rop::Blackness      #   = 0
               rop::NotOr          #   = !(src | dest)
               rop::NotSrcAnd      #  &= !src
               rop::NotPut         #   = !src
               rop::NotDestAnd     #   = !dest & src
               rop::Invert         #   = !dest
               rop::XorPut         #  ^= src
               rop::NotAnd         #   = !(src & dest)
               rop::AndPut         #  &= src
               rop::NotXor         #   = !(src ^ dest)
               rop::NotSrcXor      #     alias for rop::NotXor
               rop::NotDestXor     #     alias for rop::NotXor
               rop::NoOper         #   = dest
               rop::NotSrcOr       #  |= !src
               rop::CopyPut        #   = src
               rop::NotDestOr      #   = !dest | src
               rop::OrPut          #  |= src
               rop::Whiteness      #   = 1

   sbmp:: - system bitmaps indices
       See also Prima::StdBitmap.

               sbmp::Logo
               sbmp::CheckBoxChecked
               sbmp::CheckBoxCheckedPressed
               sbmp::CheckBoxUnchecked
               sbmp::CheckBoxUncheckedPressed
               sbmp::RadioChecked
               sbmp::RadioCheckedPressed
               sbmp::RadioUnchecked
               sbmp::RadioUncheckedPressed
               sbmp::Warning
               sbmp::Information
               sbmp::Question
               sbmp::OutlineCollaps
               sbmp::OutlineExpand
               sbmp::Error
               sbmp::SysMenu
               sbmp::SysMenuPressed
               sbmp::Max
               sbmp::MaxPressed
               sbmp::Min
               sbmp::MinPressed
               sbmp::Restore
               sbmp::RestorePressed
               sbmp::Close
               sbmp::ClosePressed
               sbmp::Hide
               sbmp::HidePressed
               sbmp::DriveUnknown
               sbmp::DriveFloppy
               sbmp::DriveHDD
               sbmp::DriveNetwork
               sbmp::DriveCDROM
               sbmp::DriveMemory
               sbmp::GlyphOK
               sbmp::GlyphCancel
               sbmp::SFolderOpened
               sbmp::SFolderClosed
               sbmp::Last

   sv::  - system value indices
       See also "get_system_value" in Prima::Application

               sv::YMenu            - height of menu bar in top-level windows
               sv::YTitleBar        - height of title bar in top-level windows
               sv::XIcon            - width and height of main icon dimensions,
               sv::YIcon              acceptable by the system
               sv::XSmallIcon       - width and height of alternate icon dimensions,
               sv::YSmallIcon         acceptable by the system
               sv::XPointer         - width and height of mouse pointer icon
               sv::YPointer           acceptable by the system
               sv::XScrollbar       - width of the default vertical scrollbar
               sv::YScrollbar       - height of the default horizontal scrollbar
               sv::XCursor          - width of the system cursor
               sv::AutoScrollFirst  - the initial and the repetitive
               sv::AutoScrollNext     scroll timeouts
               sv::InsertMode       - the system insert mode
               sv::XbsNone          - widths and heights of the top-level window
               sv::YbsNone            decorations, correspondingly, with borderStyle
               sv::XbsSizeable        bs::None, bs::Sizeable, bs::Single, and
               sv::YbsSizeable        bs::Dialog.
               sv::XbsSingle
               sv::YbsSingle
               sv::XbsDialog
               sv::YbsDialog
               sv::MousePresent     - 1 if the mouse is present, 0 otherwise
               sv::MouseButtons     - number of the mouse buttons
               sv::WheelPresent     - 1 if the mouse wheel is present, 0 otherwise
               sv::SubmenuDelay     - timeout ( in ms ) before a sub-menu shows on
                                       an implicit selection
               sv::FullDrag         - 1 if the top-level windows are dragged dynamically,
                                      0 - with marquee mode
               sv::DblClickDelay    - mouse double-click timeout in milliseconds
               sv::ShapeExtension   - 1 if Prima::Widget::shape functionality is supported,
                                      0 otherwise
               sv::ColorPointer     - 1 if system accepts color pointer icons.
               sv::CanUTF8_Input    - 1 if system can generate key codes in unicode
               sv::CanUTF8_Output   - 1 if system can output utf8 text

   ta::  - alignment constants
       Used in: Prima::InputLine, Prima::ImageViewer, Prima::Label, Prima::Terminals.

               ta::Left
               ta::Right
               ta::Center

               ta::Top
               ta::Bottom
               ta::Middle

   tw::  - text wrapping constants
       See "text_wrap" in Prima::Drawable

               tw::CalcMnemonic          - calculates tilde underline position
               tw::CollapseTilde         - removes escaping tilde from text
               tw::CalcTabs              - wraps text with respect to tab expansion
               tw::ExpandTabs            - expands tab characters
               tw::BreakSingle           - determines if text is broken to single
                                           characters when text cannot be fit
               tw::NewLineBreak          - breaks line on newline characters
               tw::SpaceBreak            - breaks line on space or tab characters
               tw::ReturnChunks          - returns wrapped text chunks
               tw::ReturnLines           - returns positions and lengths of wrapped
                                           text chunks
               tw::WordBreak             - defines if text break by width goes by the
                                           characters or by the words
               tw::ReturnFirstLineLength - returns length of the first wrapped line
               tw::Default               - tw::NewLineBreak | tw::CalcTabs | tw::ExpandTabs |
                                           tw::ReturnLines | tw::WordBreak

   wc::  - widget classes
       See "widgetClass" in Prima::Widget

               wc::Undef
               wc::Button
               wc::CheckBox
               wc::Combo
               wc::Dialog
               wc::Edit
               wc::InputLine
               wc::Label
               wc::ListBox
               wc::Menu
               wc::Popup
               wc::Radio
               wc::ScrollBar
               wc::Slider
               wc::Widget, wc::Custom
               wc::Window
               wc::Application

   ws::  - window states
       See "windowState" in Prima::Window

               ws::Normal
               ws::Minimized
               ws::Maximized

AUTHOR

       Dmitry Karasik, <dmitry@karasik.eu.org>.

SEE ALSO

       Prima, Prima::Classes