DESKBANDINFO 구조체(shobjidl_core.h)

밴드 개체에 대한 정보를 받습니다. 이 구조체는 사용되지 않는 IDeskBand::GetBandInfo 메서드와 함께 사용됩니다.

구문

typedef struct DESKBANDINFO {
  DWORD    dwMask;
  POINTL   ptMinSize;
  POINTL   ptMaxSize;
  POINTL   ptIntegral;
  POINTL   ptActual;
  WCHAR    wszTitle[256];
  DWORD    dwModeFlags;
  COLORREF crBkgnd;
} DESKBANDINFO;

멤버

dwMask

형식:DWORD

호출자가 이 구조체의 멤버를 요청하는 플래그 집합입니다. 다음 값 중 하나 이상:

DBIM_MINSIZE

ptMinSize 가 요청되었습니다.

DBIM_MAXSIZE

ptMaxSize 가 요청되었습니다.

DBIM_INTEGRAL

ptIntegral 이 요청되었습니다.

DBIM_ACTUAL

ptActual 이 요청됩니다.

DBIM_TITLE

wszTitle 이 요청되었습니다.

DBIM_MODEFLAGS

dwModeFlags 가 요청됩니다.

DBIM_BKCOLOR

crBkgnd 가 요청됩니다.

ptMinSize

형식: POINTL

밴드 개체의 최소 크기를 받는 POINTL 구조체입니다. POINTL 구조체의 x 멤버에 최소 너비가 지정되고 최소 높이가 y 멤버에 지정됩니다.

ptMaxSize

형식: POINTL

밴드 개체의 최대 크기를 받는 POINTL 구조체입니다. POINTL 구조체의 y 멤버에 최대 높이가 지정되고 x 멤버는 무시됩니다. 밴드 개체의 최대 높이에 제한이 없는 경우 (LONG)-1을 사용해야 합니다.

ptIntegral

형식: POINTL

밴드 개체의 크기가 조정되는 크기 조정 단계 값(증분)을 수신하는 POINTL 구조체입니다. POINTL 구조체의 y 멤버에 세로 단계 값이 지정되고 x 멤버는 무시됩니다.

dwModeFlags 멤버는 DBIMF_VARIABLEHEIGHT 플래그를 포함해야 합니다. 그렇지 않으면 ptIntegral이 무시됩니다.

ptActual

형식: POINTL

밴드 개체의 이상적인 크기를 받는 POINTL 구조체입니다. POINTL 구조체의 x 멤버에 이상적인 너비가 지정되고 y 멤버에 이상적인 높이가 지정됩니다. 밴드 컨테이너는 이러한 값을 사용하려고 하지만 밴드가 이 크기로 보장되지는 않습니다.

wszTitle[256]

형식: WCHAR[256]

밴드의 제목을 받는 WCHAR 버퍼입니다.

dwModeFlags

형식:DWORD

밴드 개체에 대한 작업 모드를 지정하는 플래그 집합을 수신하는 값입니다. 다음 값 중 하나 이상:

DBIMF_NORMAL

밴드는 기본 속성을 사용합니다. 다른 모드 플래그는 이 플래그를 수정합니다.

DBIMF_FIXED

Windows XP 이상: 밴드 개체의 크기 및 위치가 고정되어 있습니다. 이 플래그를 사용하면 크기 조정 그립이 밴드 개체에 표시되지 않습니다.

DBIMF_FIXEDBMP

Windows XP 이상: 밴드 개체는 고정 비트맵(.bmp) 파일을 배경으로 사용합니다. 배경은 모든 경우에 지원되지 않으므로 이 플래그가 설정된 경우에도 비트맵이 표시되지 않을 수 있습니다.

DBIMF_VARIABLEHEIGHT

밴드 개체의 높이를 변경할 수 있습니다. ptIntegral 멤버는 밴드 개체의 크기를 조정할 수 있는 단계 값을 정의합니다.

DBIMF_UNDELETEABLE

Windows XP 이상: 밴드 개체는 밴드 컨테이너에서 제거할 수 없습니다.

DBIMF_DEBOSSED

밴드 개체는 침몰한 모양으로 표시됩니다.

DBIMF_BKCOLOR

밴드는 crBkgnd에 지정된 배경색으로 표시됩니다.

DBIMF_USECHEVRON

Windows XP 이상: 전체 밴드 개체를 표시할 수 없는 경우(즉, 밴드 개체가 ptActual보다 작으면 사용 가능한 옵션이 더 있음을 나타내는 펼침 단추가 표시됩니다. 이러한 옵션은 펼침 단추를 클릭할 때 표시됩니다.

DBIMF_BREAK

Windows XP 이상: 밴드 개체는 밴드 컨테이너의 새 행에 표시됩니다.

DBIMF_ADDTOFRONT

Windows XP 이상: 밴드 개체는 밴드 컨테이너의 첫 번째 개체입니다.

DBIMF_TOPALIGN

Windows XP 이상: 밴드 개체는 밴드 컨테이너의 위쪽 행에 표시됩니다.

DBIMF_NOGRIPPER

Windows Vista 이상: 사용자가 밴드 개체를 이동하거나 크기를 조정할 수 있도록 크기 조정 그립이 표시되지 않습니다.

DBIMF_ALWAYSGRIPPER

Windows Vista 이상: 해당 밴드 개체가 컨테이너에 있는 유일한 개체인 경우에도 사용자가 밴드 개체를 이동하거나 크기를 조정할 수 있는 크기 조정 그립이 항상 표시됩니다.

DBIMF_NOMARGINS

Windows Vista 이상: 밴드 개체는 여백을 표시해서는 안 됩니다.

crBkgnd

형식: COLORREF

밴드의 배경색을 받는 COLORREF 구조체입니다. dwModeFlags 멤버는DBIMF_BKCOLOR 플래그를 포함해야 합니다. 그렇지 않으면 crBkgnd가 무시됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
머리글	shobjidl_core.h(Shobjidl.h 포함)