L_DispContainerShowTitlebar

#include "ltivw.h"

L_LTIVW_API L_INT L_DispContainerShowTitlebar(hCon, uShow, uFlags)

HDISPCONTAINER hCon;

/* handle to the container */

L_UINT uShow;

/* flag */

L_UINT uFlags;

/* reserved for future use */

Shows or hides the title bar.

Parameter

Description

hCon

Handle to the container.

uShow

Flag that indicates whether to show the title bar. Possible values are:

 

Value

Meaning

 

TRUE

Show the title bar.

 

FALSE

Do not show the title bar.

uFlags

Reserved for future use. Pass 0.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Required DLLs and Libraries

LTIVW

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_DispContainerCreate, L_DispContainerDestroy, L_DispContainerIsTitlebarIconChecked, L_DispContainerGetIconProperties L_DispContainerGetTitlebarProperties, L_DispContainerIsTitlebarEnabled, L_DispContainerSetIconProperties, L_DispContainerSetTitlebarProperties, L_DispContainerCheckTitlebarIcon

Topics:

Image Viewer Cells

Image Viewer Functions: Image Viewer Cells

Example

This function maniplulates the title bar feature. In this sample we assume that the user has opened one cell that contains one frame.

L_INT DispContainerShowTitlebarExample(HDISPCONTAINER hCon) 
{
   L_INT                          nI;
   DISPCONTAINERTITLEBARPROPS     DispContainerTitlebarProps;
   DISPCONTAINERTITLEBARICONPROPS DispContainerIconProps;
   L_INT                          nRet;

   // Check if the title bar is already shown or not.
   if (!L_DispContainerIsTitlebarEnabled(hCon, 0))
      // Show the title bar.
      L_DispContainerShowTitlebar(hCon, TRUE, 0);

   DispContainerTitlebarProps.uMask = DCTITLEBAR_ALL;
   DispContainerTitlebarProps.uStructSize = sizeof(DISPCONTAINERTITLEBARPROPS);
   // Set a brighter color for the title bar.
   L_DispContainerGetTitlebarProperties(hCon, &DispContainerTitlebarProps, 0);

   if (DispContainerTitlebarProps.bCustomTitlebarColor)
   {
      DispContainerTitlebarProps.crColor = RGB(min(255, GetRValue(DispContainerTitlebarProps.crColor) + 10),
                                               min(255, GetGValue(DispContainerTitlebarProps.crColor) + 10),
                                               min(255, GetBValue(DispContainerTitlebarProps.crColor) + 10));

      L_DispContainerSetTitlebarProperties(hCon, &DispContainerTitlebarProps, 0);
   }

   // Invert the button icon status for all the cells.
   for (nI = 0; nI < 8; nI++)
   {
      DispContainerIconProps.uMask = DCTITLEBAR_ICONPROPS_ALL;
      DispContainerIconProps.uStructSize = sizeof(DISPCONTAINERTITLEBARICONPROPS);

      nRet = L_DispContainerGetIconProperties(hCon, nI, &DispContainerIconProps, 0);

      if (!DispContainerIconProps.bReadOnly)
      {
         L_DispContainerCheckTitlebarIcon(hCon, 0, 0, nI, !L_DispContainerIsTitlebarIconChecked(hCon, 0, 0, nI, 0), 0);
      }
      nRet = L_DispContainerSetIconProperties(hCon, nI, &DispContainerIconProps, 0);
   }
   return SUCCESS;
}