L_TBCreate

Summary

Creates a toolbar.

Syntax

#include "LtTLB.h"

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

Parameters

pTOOLBARHANDLE pToolbar

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

L_HWND hwndParent

Window handle to the toolbar's parent window.

L_TCHAR * szTitle

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

L_UINT32 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 Creates an empty toolbar.

Returns

Value Meaning
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 API in addition to the Toolbar C 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.

Paint Toolbar Buttons

The paint toolbar contains the following buttons:

Image 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 tool 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

Vector Toolbar Buttons

The vector toolbar contains the following buttons:

Image Description Button ID
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

See Also

Functions

Topics

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; 
} 

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Toolbar C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.