DLGITEMTEMPLATE

DLGITEMTEMPLATE -struktur definerer dimensjoner og stil av en kontroll i en dialogboks. En eller flere av disse strukturene er kombinert med en DLGTEMPLATE struktur for å danne en standardmal for en dialogboks.

typeDef struct {/ / dlit DWORD stil; 
    DWORD dwExtendedStyle; 
    kort x; 
    kort y; 
    kort cx; 
    kort cy; 
    WORD-id 
} DLGITEMTEMPLATE 

 

Medlemmer

stil

Angir stilen for kontrollen. Dette medlemmet kan være en kombinasjon av vinduet stil verdier (for eksempel WS_BORDER) og ett eller flere av verdiene for kontrollen-stil (for eksempel BS_PUSHBUTTON og ES_LEFT).

dwExtendedStyle

Angir utvidede stiler for et vindu. Dette medlemmet er ikke brukes til å opprette kontroller i dialogbokser, men programmer som bruker dialogboksen boksen maler kan bruke den til å opprette andre typer windows.

x

Angir x-koordinaten, i dialogboksen boksen enheter, av det øverste venstre hjørnet av kontrollen. Denne koordinat er alltid forhold til øverste venstre hjørne av dialogboksens klientområdet.

y

Angir y-koordinaten, i dialogboksen boksen enheter, av det øverste venstre hjørnet av kontrollen. Denne koordinat er alltid forhold til øverste venstre hjørne av dialogboksens klientområdet.

cx

Angir bredden i dialogboksen boksen enheter for kontrollen.

cy

Angir høyden i dialogboksen boksen enheter for kontrollen.

id

Angir identifikatoren for kontrollen.

Merknader

I standard mal for en dialogboks, er DLGITEMTEMPLATE -strukturen alltid umiddelbart etterfulgt av tre variabel lengde-matriser som angir klassen, tittel og etableringen dataene for kontrollen. Hver matrise som består av ett eller flere 16-biters-elementer.

Hver DLGITEMTEMPLATE strukturen i malen må justeres på en DWORD -grense. De klasse og tittel matrisene må justeres på WORD grenser. Matrisen etableringen dataene må justeres på en grenselinje for ord.

Rett etter hver DLGITEMTEMPLATE struktur er en klasse matrise som identifiserer vindusklasse for kontrollen. Hvis det første elementet i denne datatabellen er en annen verdi enn 0xFFFF, behandler systemet matrisen som en null-avbrutt Unicode-streng som angir navnet på en registrert vindusklasse. Hvis det første elementet er 0xFFFF, har matrisen flere elementer som angir Ordenstallet til en forhåndsdefinert systemklasse. Ordenstallet kan være en av følgende atom verdier.

Etter klasse-matrise er en matrise med tittel som inneholder innledende tekst eller ressurs-IDen for kontrollen. Hvis det første elementet i denne datatabellen er 0xFFFF, har matrisen flere elementer som angir en Ordenstallet til en ressurs, for eksempel et ikon i en kjørbar fil. Du kan bruke en ressursidentifikatoren for kontroller, for eksempel statisk ikonet kontroller, som lastes inn og viser et ikon eller andre ressurs heller enn tekst. Hvis det første elementet er en annen verdi enn 0xFFFF, behandler systemet matrisen som en null-avbrutt Unicode-streng som angir den første teksten.

Etableringen data matrisen begynner på neste grenselinje for ord etter tittel matrisen. Denne etableringen data kan være en hvilken som helst størrelse og format. Hvis det første ordet i etableringen data matrisen er ikke-null, angir størrelsen, i byte, på etableringen dataene (inkludert størrelse ordet). Kontrollens vindusprosedyre må kunne tolke dataene. Når programmet oppretter kontrollen, sender den en peker til disse dataene i lParam -parameteren for WM_CREATE-meldingen som sendes til kontrollen.

Hvis du angir tegnstrenger i klassen og tittel-matriser, må du bruke Unicode-strenger. For å opprette kode som fungerer på både Windows og Windows NT, kan du bruke MultiByteToWideChar -funksjonen til å generere disse Unicode-strenger.

X-, y-, cx- og cy medlemmene angi verdier i dialogboksen boksen enheter. Du kan konvertere disse verdiene til skjermen enheter (piksler) ved hjelp av MapDialogRect -funksjonen.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.

Se også

Oversikt over dialogboksen-boksene, dialogboksen boksen strukturer, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DLGITEMTEMPLATEEX, DLGTEMPLATE, DLGTEMPLATEEX, MapDialogRect, MultiByteToWideChar, WM_CREATE

Index