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 API in addition to the Toolbar API, 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;
}