Struktur DESKBANDINFO (shobjidl_core.h)

Menerima informasi tentang objek pita. Struktur ini digunakan dengan metode IDeskBand::GetBandInfo yang tidak digunakan lagi.

Sintaks

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

Anggota

dwMask

Jenis: DWORD

Kumpulan bendera yang menentukan anggota struktur ini mana yang diminta oleh pemanggil. Satu atau beberapa nilai berikut ini:

DBIM_MINSIZE

ptMinSize diminta.

DBIM_MAXSIZE

ptMaxSize diminta.

DBIM_INTEGRAL

ptIntegral diminta.

DBIM_ACTUAL

ptActual diminta.

DBIM_TITLE

wszTitle diminta.

DBIM_MODEFLAGS

dwModeFlags diminta.

DBIM_BKCOLOR

crBkgnd diminta.

ptMinSize

Jenis: POINTL

Struktur POINTL yang menerima ukuran minimum objek band. Lebar minimum diberikan dalam anggota x struktur POINTL dan tinggi minimum diberikan pada anggota y.

ptMaxSize

Jenis: POINTL

Struktur POINTL yang menerima ukuran maksimum objek pita. Tinggi maksimum diberikan dalam anggota y struktur POINTL dan anggota x diabaikan. Jika objek pita tidak memiliki batas untuk tinggi maksimumnya, (LONG)-1 harus digunakan.

ptIntegral

Jenis: POINTL

Struktur POINTL yang menerima nilai langkah ukuran (kenaikan) di mana objek pita diubah ukurannya. Nilai langkah vertikal diberikan dalam anggota y struktur POINTL dan anggota x diabaikan.

Anggota dwModeFlags harus berisi bendera DBIMF_VARIABLEHEIGHT; jika tidak, ptIntegral diabaikan.

ptActual

Jenis: POINTL

Struktur POINTL yang menerima ukuran ideal objek pita. Lebar ideal diberikan dalam anggota x struktur POINTL dan tinggi ideal diberikan pada anggota y. Kontainer band mencoba menggunakan nilai-nilai ini, tetapi pita tidak dijamin sebesar ini.

wszTitle[256]

Jenis: WCHAR[256]

Buffer WCHAR yang menerima judul band.

dwModeFlags

Jenis: DWORD

Nilai yang menerima sekumpulan bendera yang menentukan mode operasi untuk objek band. Satu atau beberapa nilai berikut ini:

DBIMF_NORMAL

Pita menggunakan properti default. Bendera mode lainnya mengubah bendera ini.

DBIMF_FIXED

Windows XP dan yang lebih baru: Objek pita berukuran tetap dan posisi. Dengan bendera ini, pegangan ukuran tidak ditampilkan pada objek band.

DBIMF_FIXEDBMP

Windows XP dan yang lebih baru: Objek pita menggunakan file bitmap tetap (.bmp) sebagai latar belakangnya. Perhatikan bahwa latar belakang tidak didukung dalam semua kasus, sehingga bitmap mungkin tidak terlihat bahkan ketika bendera ini diatur.

DBIMF_VARIABLEHEIGHT

Tinggi objek pita dapat diubah. Anggota ptIntegral menentukan nilai langkah di mana objek band dapat diubah ukurannya.

DBIMF_UNDELETEABLE

Windows XP dan yang lebih baru: Objek pita tidak dapat dihapus dari kontainer pita.

DBIMF_DEBOSSED

Objek band ditampilkan dengan tampilan tenggelam.

DBIMF_BKCOLOR

Pita ditampilkan dengan warna latar belakang yang ditentukan dalam crBkgnd.

DBIMF_USECHEVRON

Windows XP dan yang lebih baru: Jika objek pita lengkap tidak dapat ditampilkan (yaitu, objek band lebih kecil dari ptActual, chevron ditunjukkan untuk menunjukkan bahwa ada lebih banyak opsi yang tersedia. Opsi ini ditampilkan saat chevron diklik.

DBIMF_BREAK

Windows XP dan yang lebih baru: Objek pita ditampilkan dalam baris baru dalam kontainer band.

DBIMF_ADDTOFRONT

Windows XP dan yang lebih baru: Objek band adalah objek pertama dalam kontainer band.

DBIMF_TOPALIGN

Windows XP dan yang lebih baru: Objek pita ditampilkan di baris atas kontainer band.

DBIMF_NOGRIPPER

Windows Vista dan yang lebih baru: Tidak ada pegangan ukuran yang pernah ditampilkan untuk memungkinkan pengguna memindahkan atau mengubah ukuran objek band.

DBIMF_ALWAYSGRIPPER

Windows Vista dan yang lebih baru: Pegangan ukuran yang memungkinkan pengguna untuk memindahkan atau mengubah ukuran objek band selalu ditampilkan, bahkan jika objek band tersebut adalah satu-satunya di kontainer.

DBIMF_NOMARGINS

Windows Vista dan yang lebih baru: Objek pita tidak boleh menampilkan margin.

crBkgnd

Jenis: COLORREF

Struktur COLORREF yang menerima warna latar belakang pita. Anggota dwModeFlags harus berisi bendera DBIMF_BKCOLOR ; jika tidak, crBkgnd diabaikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	shobjidl_core.h (termasuk Shobjidl.h)