Prima::Const

Langue: en

Autres versions - même langue

Version: 2009-02-24 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

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