L_TBCreate

#include "LtTLB.h"

L_LTTLB_API L_INT L_TBCreate(pToolbar, hwndParent, szTitle, dwFlags )

pTOOLBARHANDLE pToolbar;

/* pointer to a toolbar handle */

L_HWND hwndParent;

/* window handle */

L_TCHAR * szTitle;

/* window title string */

L_UINT32 dwFlags;

/* flag that indicates the toolbar type */

Creates a toolbar.

Parameter

Description

pToolbar

Pointer to a toolbar handle. This toolbar handle should be initialized before calling this function.

hwndParent

Window handle to the toolbar's parent window.

szTitle

Character string that contains the title for the toolbar window. This is a NULL terminated string.

dwFlags

Flags that will indicate the type of the toolbar to be created. Possible values are:

 

Value

Meaning

 

TOOLBAR_PAINT

Creates a digital painting toolkit toolbar.

 

TOOLBAR_VECTOR

Creates a vector toolkit toolbar.

 

TOOLBAR_EMPTY

Create an empty toolbar.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes

Comments

L_TBInit must be called before calling this function.

The toolbar is created as a child window to the window specified in hwndParent.

Note:

Vector and Paint toolbars are Automation toolbars. When using the Automation C DLL in addition to the Toolbar C DLL, these toolbars automatically handle the buttons and the necessary function calls. If automation is not used, then it is the user's responsibility to create buttons, assign ID numbers, process the events and handle all necessary function calls.

The paint toolbar contains the following buttons:

Description

Button ID

image\Apbrush.gif Paintbrush tool

ID_TOOL_PAINT_BRUSH

image\Alinetool.gif Line shape tool

ID_TOOL_PAINT_SHAPE_LINE

image\Arecttool.gif Rectangle shape tool

ID_TOOL_PAINT_SHAPE_RECT

image\RndRctTl.gif Rounded rectangle shape tool

ID_TOOL_PAINT_SHAPE_ROUNDRECT

image\EllipseTl.gif Ellipse shape tool

ID_TOOL_PAINT_SHAPE_ELLIPSE

image\PylgnTool.gif Polygon shape tool

ID_TOOL_PAINT_SHAPE_POLYGON

image\Bezier.gif Bezier shape tool

ID_TOOL_PAINT_SHAPE_BEZIER

image\RectRgn.gif Region rectangle tool

ID_TOOL_PAINT_REGION_RECT

image\RndRctRgn.gif Rounded rectangle region too

D_TOOL_PAINT_REGION_ROUNDRECT

image\EllpsRgn.gif Ellipse region tool

ID_TOOL_PAINT_REGION_ELLIPSE

image\PlygnRgn.gif Polygon region tool

ID_TOOL_PAINT_REGION_POLYGON

image\SurfRgn.gif Surface region tool

ID_TOOL_PAINT_REGION_SURFACE

image\BordRgn.gif Border region tool

ID_TOOL_PAINT_REGION_BORDER

image\ColorRgn.gif Color region tool

ID_TOOL_PAINT_REGION_COLOR

image\SurfFill.gif Surface fill tool

ID_TOOL_PAINT_FILL_SURFACE

image\BordFill.gif Border fill tool

ID_TOOL_PAINT_FILL_BORDER

image\ClrRplc.gif Color replace tool

ID_TOOL_PAINT_FILL_COLORREPLACE

image\TextTool.gif Text tool

ID_TOOL_PAINT_TEXT

image\Zoom.gif Zoom tool

ID_TOOL_PAINT_ZOOM

image\BdrClrPkr.gif Border color picker tool

ID_TOOL_PAINT_BORDERCOLORPICKER

image\MovrTool.gif Mover tool

ID_TOOL_PAINT_MOVER

The vector toolbar contains the following buttons:

image\Neutral.gif Neutral (No tool selected)

ID_TOOL_VECTOR_NONE

image\SelectButton.gif Select object(s)

ID_TOOL_VECTOR_SELECT

image\Vertex.gif Vertex

ID_TOOL_VECTOR_VERTEX

image\Line.gif Line

ID_TOOL_VECTOR_LINE

image\Rectang.gif Rectangle

ID_TOOL_VECTOR_RECTANGLE

image\Polyline.gif Polyline

ID_TOOL_VECTOR_POLYLINE

image\Pbezier.gif Polybezier

ID_TOOL_VECTOR_POLYBEZIER

image\Polygon.gif Polygon

ID_TOOL_VECTOR_POLYGON

image\VEllipse.gif Ellipse

ID_TOOL_VECTOR_ELLIPSE

image\VCircle.gif Circle

ID_TOOL_VECTOR_CIRCLE

image\Varc.gif Arc

ID_TOOL_VECTOR_ARC

image\VText.gif Text

ID_TOOL_VECTOR_TEXT

image\VPie.gif Pie

ID_TOOL_VECTOR_PIE

image\VChord.gif Chord

ID_TOOL_VECTOR_CHORD

image\VRaster.gif Raster

ID_TOOL_VECTOR_RASTER

image\VRotate.gif Rotate

ID_TOOL_VECTOR_ROTATE

image\VPan.gif Pan

ID_TOOL_VECTOR_PAN

Required DLLs and Libraries

LTTLB

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_TBInit, L_TBFree, L_TBIsValid

Topics:

Creating a Toolbar

Example

This example will initiate, create a toolbar, set its position and make it visible

L_INT TBCreateExample( HWND hWnd, pTOOLBARHANDLE* ppLeadToolbar)
{
   L_INT nRet;
   /* Initiate the toolbar handle */
    nRet = L_TBInit ( ppLeadToolbar ); 
    if(nRet != SUCCESS)
       return nRet;
    nRet = L_TBIsValid( *ppLeadToolbar );
    /* Check the validity of the handle */
    if (SUCCESS == nRet )
    {
       POINT pt = { 0, 0 };

      /* Initiate the point will be used to align the toolbar at the top-left of its owner client area */
      ClientToScreen ( hWnd, &pt );

      /* Create the toolbar  */
      nRet = L_TBCreate ( *ppLeadToolbar, hWnd, TEXT("Tools Window"), TOOLBAR_PAINT );
      if(nRet != SUCCESS)
         return nRet;

      /* Set the toolbar position */
      nRet = L_TBSetPosition ( *ppLeadToolbar, &pt, TOOLBAR_POSITION_TOP | TOOLBAR_POSITION_LEFT );
      if(nRet != SUCCESS)
         return nRet;

      /* Show the toolbar */
      nRet = L_TBSetVisible ( *ppLeadToolbar, TRUE );
      if(nRet != SUCCESS)
         return nRet;
   }
    else
       return nRet;

   return SUCCESS;
}