Documentation  |   Table of Contents   |  < Previous   |  Next >  

79    PalmOSGlue

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

This chapter summarizes changes to the APIs declared in the following Palm OS Garnet header files:

  • BmpGlue.h
  • CtlGlue.h
  • DateGlue.h
  • FldGlue.h
  • FntGlue.h
  • FrmGlue.h
  • IntlGlue.h
  • LmGlue.h
  • LstGlue.h
  • MemGlue.h
  • OmGlue.h
  • ResGlue.h
  • SysGlue.h
  • TblGlue.h
  • TsmGlue.h
  • TxtGlue.h
  • UIColorGlue.h
  • WinGlue.h

The Palm OS Glue APIs were designed to allow developers to write code that was backwardly-compatible with earlier releases of Palm OS. They are not needed in Palm OS Cobalt since there isn't an earlier set of ARM-native APIs with which a Palm OS Cobalt application could be compatible. Applications that used the Palm OS Glue functions should be written to use the underlying operating system function which is usually—but not always—named the same as the glue function with the word "Glue" removed. So, for instance, instead of calling CtlGlueGetFont() your application should call CtlGetFont().

Deleted APIs ^TOP^

Table 79.1  Deleted functions 

Deleted API

Use instead

BmpGlueGetBitDepth()

BmpGetBitDepth()

BmpGlueGetBits()

BmpGetBits()

BmpGlueGetCompressionType()

BmpGetCompressionType()

BmpGlueGetDimensions()

BmpGetDimensions()

BmpGlueGetNextBitmap()

BmpGetNextBitmap()

BmpGlueGetTransparentValue()

BmpGetTransparentValue()

BmpGlueSetTransparentValue()

BmpSetTransparentValue()

CtlGlueGetControlStyle()

CtlGetControlStyle()

CtlGlueGetFont()

CtlGetFont()

CtlGlueGetGraphics()

CtlGetGraphics()

CtlGlueIsGraphical()

CtlIsGraphicControl()

CtlGlueNewSliderControl()

CtlNewSliderControl()

CtlGlueSetFont()

CtlSetFont()

CtlGlueSetFrameStyle()

CtlSetFrameStyle()

CtlGlueSetLeftAnchor()

CtlSetLeftAnchor()

DateGlueTemplateToAscii()

DateTemplateToAscii()

DateGlueToDOWDMFormat()

DateToDOWDMFormat()

FldGlueGetLineInfo()

FldGetLineInfo()

FntGlueGetDefaultFontID()

FntGetDefaultFontID()

FntGlueTruncateString()

FntTruncateString()

FntGlueWCharWidth()

FntCharWidth()

FntGlueWidthToOffset()

FntWidthToOffset()

FrmGlueGetActiveField()

FrmGetActiveField()

FrmGlueGetDefaultButtonID()

FrmGetDefaultButtonID()

FrmGlueGetEventHandler()

FrmGetEventHandler()

FrmGlueGetHelpID()

FrmGetHelpID()

FrmGlueGetLabelFont()

FrmGetLabelFont()

FrmGlueGetMenuBarID()

FrmGetMenuBarID()

FrmGlueGetObjectUsable()

FrmGetObjectUsable()

FrmGlueGetObjIDFromObjPtr()

FrmGetObjectIdFromObjectPtr()

FrmGlueSetDefaultButtonID()

FrmSetDefaultButtonID()

FrmGlueSetHelpID()

FrmSetHelpID()

FrmGlueSetLabelFont()

FrmSetLabelFont()

IntlGlueGetRoutineAddress()

There is no single function that corresponds to this, but see "Patching Shared Libraries" of Exploring Palm OS: System Management for information on function entry points.

TxtLatinByteAttr()

LmGlueGetLocaleSetting()

LmGetLocaleSetting()

LmGlueGetNumLocales()

LmGetNumLocales()

LmGlueGetSystemLocale()

LmGetSystemLocale()

LmGlueLocaleToIndex()

LmLocaleToIndex()

LstGlueGetDrawFunction()

LstGlueGetFont()

LstGetFont()

LstGlueGetItemsText()

LstGetItemsText()

LstGlueGetTopItem()

LstGetTopItem()

LstGlueSetFont()

LstSetFont()

LstGlueSetIncrementalSearch()

LstSetIncrementalSearch()

MemGluePtrNew()

MemPtrNew()

OmGlueGetCurrentLocale()

LmGetLocaleSetting()

OmGlueGetSystemLocale()

LmGetSystemLocale()

ResGlueLoadConstant()

ResLoadConstant()

SysGlueGetTrapAddress()

There is no single function that corresponds to this, but see "Patching Shared Libraries" of Exploring Palm OS: System Management for information on function entry points.

TblGlueGetColumnMasked()

TblGetColumnMasked()

TblGlueGetItemPtr()

TblGetItemPtr()

TblGlueGetNumberOfColumns()

TblGetNumberOfColumns()

TblGlueGetTopRow()

TblGetTopRow()

TblGlueSetSelection()

TblSetSelection()

TsmGlueGetFepMode()

TsmGetFepMode()

TsmGlueSetFepMode()

TsmSetFepMode()

TxtGlueByteAttr()

TxtByteAttr()

TxtGlueCaselessCompare()

TxtCaselessCompare()

TxtGlueCharAttr()

TxtCharAttr()

TxtGlueCharBounds()

TxtCharBounds()

TxtGlueCharEncoding()

TxtCharEncoding()

TxtGlueCharIsValid()

TxtCharIsValid()

TxtGlueCharIsVirtual()

TxtCharIsVirtual() macro

TxtGlueCharSize()

TxtCharSize()

TxtGlueCharWidth()

FntCharWidth()

TxtGlueCharXAttr()

TxtCharXAttr()

TxtGlueCompare()

TxtCompare()

TxtGlueConvertEncoding()

TxtConvertEncoding()

TxtGlueEncodingName()

TxtEncodingName()

TxtGlueFindString()

TxtFindString()

TxtGlueGetChar()

TxtGetChar()

TxtGlueGetHorizEllipsisChar()

ChrHorizEllipsis() macro

TxtGlueGetNextChar()

TxtGetNextChar()

TxtGlueGetNumericSpaceChar()

ChrNumericSpace() macro

TxtGlueGetPreviousChar()

TxtGetPreviousChar()

TxtGlueGetTruncationOffset()

TxtGetTruncationOffset()

TxtGlueLowerChar()

TxtGlueLowerStr()

TxtGlueMaxEncoding()

TxtMaxEncoding()

TxtGlueParamString()

TxtParamString()

TxtGluePrepFindString()

TxtPrepFindString()

TxtGlueReplaceStr()

TxtReplaceStr()

TxtGlueSetNextChar()

TxtSetNextChar()

TxtGlueStrEncoding()

TxtStrEncoding()

TxtGlueStripSpaces()

TxtGlueTransliterate()

TxtTransliterate()

TxtGlueTruncateString()

TxtTruncateString()

TxtGlueUpperChar()

TxtGlueUpperStr()

TxtGlueWordBounds()

TxtWordBounds()

UIColorGlueGetNumTableEntries()

WinGlueDrawChar()

WinDrawChar()

WinGlueDrawTruncChars()

WinDrawTruncChars()

WinGlueGetFrameType()

WinGetFrameType()

WinGlueSetFrameType()

WinSetFrameType()

Table 79.2  Deleted macros 

Deleted API

Use instead

SysGlueTrapExists()

There is no single function that corresponds to this, but see "Patching Shared Libraries" of Exploring Palm OS: System Management for information on function entry points.

TxtGlueCharIsAlNum()

TxtCharIsAlNum()

TxtGlueCharIsAlpha()

TxtCharIsAlpha()

TxtGlueCharIsCntrl()

TxtCharIsCntrl()

TxtGlueCharIsDelim()

TxtCharIsDelim()

TxtGlueCharIsDigit()

TxtCharIsDigit()

TxtGlueCharIsGraph()

TxtCharIsGraph()

TxtGlueCharIsHex()

TxtCharIsHex()

TxtGlueCharIsLower()

TxtCharIsLower()

TxtGlueCharIsPrint()

TxtCharIsPrint()

TxtGlueCharIsPunct()

TxtCharIsPunct()

TxtGlueCharIsSpace()

TxtCharIsSpace()

TxtGlueCharIsUpper()

TxtCharIsUpper()

TxtGlueNextCharSize()

TxtNextCharSize()

TxtGluePreviousCharSize()

TxtPreviousCharSize()

Unchanged APIs ^TOP^

Table 79.3  Unchanged enumerated types

fontDefaults

FontDefaultType