Dela via

Referens för allmän kontroll

  • Artikel

Det här avsnittet innehåller referensinformation om programmeringselement som gäller för flera kontroller, inte bara för en specifik kontroll. Det finns funktioner, makron, meddelanden, meddelanden och strukturer som de flesta kontroller stöder. De flesta kontroller använder till exempel NM_HOVER meddelanden för att bearbeta musklickningar.

Översikter

Ämne Innehåll
Om vanliga kontroller De vanliga kontrollerna är en uppsättning fönster som implementeras av det gemensamma kontrollbiblioteket, som är en DLL som ingår i Windows-operativsystemet.
Vanliga frågor och svar om vanliga kontroller Vanliga frågor och svar ger svar på några vanliga frågor om de vanliga kontrollerna.

Funktioner

Ämne Innehåll
DoReaderMode Aktiverar läsläge i ett fönster.
DPA_Clone Duplicerar en dynamisk pekarmatris (DPA).
DPA_Create Skapar en DPA.
DPA_CreateEx Skapar en DPA med en angiven storlek och heapplats.
DPA_DeleteAllPtrs Tar bort alla objekt från en DPA och krymper DPA i enlighet med detta.
DPA_DeletePtr Tar bort ett objekt från en DPA. DPA krymper om det behövs för att hantera det borttagna objektet.
DPA_Destroy Frigör en dynamisk pekarmatris (DPA).
DPA_DestroyCallback Anropar pfnCB- på varje element i DPA och frigör sedan DPA.
DPA_EnumCallback Itererar genom DPA (Dynamic Pointer Array) och anropar pfnCB- för varje objekt.
DPA_GetPtr Hämtar ett objekt från en DPA.
DPA_GetPtrIndex Hämtar indexet för ett matchande objekt som finns i en DPA.
DPA_GetSize Hämtar storleken på en DPA.
DPA_Grow Ändrar antalet pekare i en DPA.
DPA_InsertPtr Infogar ett nytt objekt på en angiven position i en DPA. Om det behövs expanderar DPA för att hantera det nya objektet.
DPA_LoadStream Läser in DPA från en dataström genom att anropa den angivna återanropsfunktionen för att läsa varje element.
DPA_Merge Kombinerar innehållet i två DPA:er.
DPA_SaveStream Sparar DPA till en dataström genom att skriva ut ett huvud och sedan anropa den angivna återanropsfunktionen för att skriva varje element.
DPA_Search Hittar ett objekt i en DPA.
DPA_SetPtr Tilldelar ett värde till ett objekt i en DPA.
DPA_Sort Sorterar objekten i en dynamisk pekarmatris (DPA).
DrawShadowText Ritar text som har en skugga.
DrawTextExPrivWrap Ritar formaterad text i den angivna rektangeln. Den här funktionen omsluter ett anrop till DrawTextEx.
DrawTextWrap Ritar formaterad text i den angivna rektangeln. Den formaterar texten enligt den angivna metoden (expanderar flikar, justerar tecken, radbrytningar och så vidare). Den här funktionen omsluter ett anrop till DrawText.
DSA_Clone Duplicerar en dynamisk strukturmatris (DSA).
DSA_Create Skapar en DSA.
DSA_DeleteAllItems Tar bort alla objekt från en DSA.
DSA_DeleteItem Tar bort ett objekt från en DSA.
DSA_Destroy Frigör en DSA.
DSA_DestroyCallback Itererar via en DSA och anropar en angiven återanropsfunktion för varje objekt. När du når slutet av matrisen frigörs DSA.
DSA_EnumCallback Itererar via DSA och anropar pfnCB- för varje objekt.
DSA_GetItem Hämtar ett element från en DSA.
DSA_GetItemPtr Hämtar en pekare till ett element från en DSA.
DSA_GetSize Hämtar storleken på DSA.
DSA_InsertItem Infogar ett nytt objekt i en DSA. Vid behov expanderar DSA för att rymma det nya objektet.
DSA_SetItem Anger innehållet i ett element i en DSA.
DSA_Sort Sorterar objekten i en DSA.
ExtTextOutWrap Ritar text med det markerade teckensnittet, bakgrundsfärgen och textfärgen. Du kan också ange dimensioner som ska användas för urklipp, ogenomskinlighet eller både och. Den här funktionen omsluter ett anrop till ExtTextOut.
GetEffectiveClientRect Beräknar dimensionerna för en rektangel i klientområdet som innehåller alla angivna kontroller.
GetMUILanguage Hämtar det språk som används av de vanliga kontrollerna för en viss process.
GetTextExtentPoint32Wrap Beräknar bredden och höjden på den angivna textsträngen. Den här funktionen omsluter ett anrop till GetTextExtentPoint.
InitCommonControls Registrerar och initierar vissa vanliga kontrollfönsterklasser. Den här funktionen är föråldrad. Nya program bör använda funktionen InitCommonControlsEx.
InitCommonControlsEx Registrerar specifika vanliga kontrollklasser från den gemensamma kontroll-DLL:en.
InitMUILanguage Gör att ett program kan ange ett språk som ska användas med vanliga kontroller som skiljer sig från systemspråket.
LoadIconMetric Läser in en angiven ikonresurs med ett klient angivet systemmått.
LoadIconWithScaleDown Läser in en ikon. Om ikonen inte är en standardstorlek skalar den här funktionen ned en större bild i stället för att skala upp en mindre bild.
MirrorIcon Backar (speglar) ikoner så att de visas korrekt i en speglad enhetskontext.
PFNDACOMPARE Definierar prototypen för jämförelsefunktionen som används av DSA_Sort.
PFNDACOMPARECONST Definierar prototypen för jämförelsefunktionen som används av DSA_Sort när objekten som jämförs är konstanta objekt.
PFNDAENUMCALLBACK Definierar prototypen för återanropsfunktionen som används av DSA- och DPA-funktioner.
PFNDAENUMCALLBACKCONST Definierar prototypen för återanropsfunktionen som används av DSA- och DPA-funktioner när de aktuella objekten pekar på konstanta data.
PFNDPACOMPARE Definierar prototypen för jämförelsefunktionen som används av DPA_Sort och DPA_Search.
PFNDPACOMPARECONST Definierar prototypen för jämförelsefunktionen som används av DPA_Sort eller DPA_Search när objekten som jämförs är konstanta objekt.
PFNDPAENUMCALLBACK Definierar prototypen för återanropsfunktionen som används av DPA_EnumCallback.
PFNDPAMERGE- Definierar prototypen för sammanslagningsfunktionen som används av DPA_Merge.
PFNDPAMERGECONST Definierar prototypen för sammanslagningsfunktionen som används av DPA_Merge, med hjälp av konstanta värden.
PFNDPASTREAM Definierar prototypen för återanropsfunktionen som används av DPA_LoadStream och DPA_SaveStream.
PFNDSAENUMCALLBACK Definierar prototypen för återanropsfunktionen som används av DSA_DestroyCallback.
ReaderScroll En programdefinierad återanropsfunktion som används när muspekaren flyttas inom den del av läsarens lägesfönster som har deklarerats som det aktiva rullningsområdet.
ShowHideMenuCtl Anger eller tar bort det angivna menyalternativets bockmarkeringsattribut och visar eller döljer motsvarande kontroll. Funktionen lägger till en bockmarkering i det angivna menyalternativet om det inte har ett och visar sedan motsvarande kontroll. Om menyalternativet redan har en bockmarkering tar funktionen bort bockmarkeringen och döljer motsvarande kontroll.
Str_GetPtr Kopierar en sträng från en buffert till en annan.
Str_SetPtrW Anger ppszAktuell till en kopia av pszNy och frigör det tidigare värdet om det behövs.
TranslateDispatch Används av klienten för funktionen DoReaderMode för att fånga upp och uttryckligen hantera alla Windows-meddelanden som är avsedda för rullningsområdet i fönstret för läsarläge. Det här är en programdefinierad återanropsfunktion.

Makron

Ämne Innehåll
DPA_AppendPtr Infogar ett nytt objekt i slutet av en DPA.
DPA_FastDeleteLastPtr Tar bort den sista pekaren från en DPA.
DPA_FastGetPtr Hämtar värdet för den angivna pekaren i DPA.
DPA_GetPtrCount Hämtar antalet pekare i en DPA.
DPA_GetPtrPtr Hämtar pekaren till den interna pekarmatrisen för en DPA.
DPA_SetPtrCount Anger antalet pekare i en DPA.
DPA_SortedInsertPtr Infogar ett nytt objekt före eller efter ett angivet befintligt objekt.
DSA_AppendItem Lägger till ett nytt objekt i slutet av en DSA.
DSA_GetItemCount Hämtar antalet objekt i en DSA.
FORWARD_WM_NOTIFY Skickar eller publicerar meddelandet WM_NOTIFY.
HANDLE_WM_NOTIFY Anropar en funktion som bearbetar WM_NOTIFY-meddelandet.
INDEXTOSTATEIMAGEMASK Förbereder indexet för en tillståndsbild så att en trädvykontroll eller listvykontroll kan använda indexet för att hämta tillståndsbilden för ett objekt.

Meddelanden

Ämne Innehåll
CCM_DPISCALE Aktiverar automatisk skalning av höga punkter per tum (dpi) i Tree-View kontroller, List-View kontroller, ComboBoxEx-kontroller, Rubrikkontroller, Knappar, Verktygsfältskontroller, Animeringskontrolleroch bildlistor.
CCM_GETUNICODEFORMAT Hämtar unicode-teckenformatflaggan för kontrollen.
CCM_GETVERSION Hämtar versionsnumret för en kontrolluppsättning av det senaste CCM_SETVERSION meddelandet.
CCM_SETUNICODEFORMAT Anger unicode-teckenformatflaggan för kontrollen. Med det här meddelandet kan du ändra den teckenuppsättning som används av kontrollen vid körning i stället för att behöva återskapa kontrollen.
CCM_SETVERSION Det här meddelandet används för att informera kontrollen om att du förväntar dig ett beteende som är associerat med en viss version.
CCM_SETWINDOWTHEME Anger den visuella stilen för en kontroll.
WM_NOTIFY Skickas av en gemensam kontroll till dess överordnade fönster när en händelse har inträffat eller kontrollen kräver viss information.
WM_NOTIFYFORMAT Avgör om ett fönster accepterar ANSI- eller Unicode-strukturer i WM_NOTIFY meddelandemeddelandet. WM_NOTIFYFORMAT meddelanden skickas från en gemensam kontroll till dess överordnade fönster och från det överordnade fönstret till den gemensamma kontrollen.

Meddelanden

Ämne Innehåll
NM_CHAR NM_CHAR-meddelandekoden skickas av en kontroll när en teckennyckel bearbetas. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_CUSTOMDRAW Meddelar en kontrolls överordnade fönster om anpassade ritningsåtgärder. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_CUSTOMTEXT Meddelar en kontrolls överordnade fönster om anpassade textåtgärder. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_FONTCHANGED Skickas av en listvykontroll när kontrollen har ändrat ett teckensnitt. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_GETCUSTOMSPLITRECT Skickas med en knappkontroll till dess överordnade för att få mått för de två rektanglar som utgör delningsknappen. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_HOVER Skickas av en kontroll när musen hovrar över ett objekt. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_KEYDOWN Skickas av en kontroll när kontrollen har tangentbordsfokus och användaren trycker på en tangent. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_KILLFOCUS Meddelar en kontrolls överordnade fönster att kontrollen har förlorat indatafokuset. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_LDOWN Meddelar en kontrolls överordnade fönster att den vänstra musknappen har tryckts på. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_NCHITTEST Skickas av en omlistekontroll när kontrollen tar emot ett WM_NCHITTEST meddelande. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_OUTOFMEMORY Meddelar en kontrolls överordnade fönster att kontrollen inte kunde slutföra en åtgärd eftersom det inte fanns tillräckligt med minne tillgängligt. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_RDOWN Stöds inte för närvarande.
NM_RELEASEDCAPTURE Meddelar en kontrolls överordnade fönster att kontrollen släpper musfångst. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_RETURN Meddelar en kontrolls överordnade fönster att kontrollen har indatafokus och att användaren har tryckt på RETUR-tangenten. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_SETCURSOR Meddelar en kontrolls överordnade fönster att kontrollen ställer in markören som svar på ett NM_SETCURSOR meddelande. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_SETFOCUS Meddelar en kontrolls överordnade fönster att kontrollen har fått indatafokuset. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_THEMECHANGED Meddelar en kontrolls överordnade fönster att temat har ändrats. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_TOOLTIPSCREATED Meddelar en kontrolls överordnade fönster att kontrollen har skapat en knappbeskrivningskontroll. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.
NM_TVSTATEIMAGECHANGING Skickas av en trädvykontroll till dess överordnade fönster som tillståndsbilden ändras. Den här meddelandekoden skickas i form av ett WM_NOTIFY meddelande.

Strukturer

Ämne Innehåll
COLORSCHEME Innehåller information om ritning av knappar i ett verktygsfält eller en omliste.
DPASTREAMINFO Innehåller ett dataströmobjekt som används av funktionen PFNDPASTREAM motringning.
INITCOMMONCONTROLSEX Innehåller information som används för att läsa in vanliga kontrollklasser från DLL-biblioteket (dynamic-link library). Den här strukturen används med funktionen InitCommonControlsEx.
NMCHAR- Innehåller information som används med teckenmeddelanden.
NMCUSTOMSPLITRECTINFO Innehåller information om de två rektanglarna för en delad knapp. Skickas med NM_GETCUSTOMSPLITRECT-meddelandet.
NMCUSTOMTEXT Innehåller information som används med anpassad textavisering.
NMHDR- Innehåller information om ett meddelande.
NMKEY- Innehåller information som används med viktiga meddelanden.
NMMOUSE Innehåller information som används med musmeddelanden.
NMOBJECTNOTIFY Innehåller information som används med meddelandekoderna TBN_GETOBJECT, TCN_GETOBJECToch PSN_GETOBJECT.
NMTOOLTIPSSKAPAD Innehåller information som används med NM_TOOLTIPSCREATED meddelandekod.
READERMODEINFO Innehåller information som krävs för att initiera funktionen DoReaderMode.

Konstanter

Ämne Innehåll
CDRF-konstanter Dessa konstanter används som returvärden av en kontroll som svar på en NM_CUSTOMDRAW meddelandekod.
formatmallar I det här avsnittet visas vanliga kontrollformat. Förutom där detta anges gäller dessa format för rubrikkontroller, verktygsfältskontroller och statusfönster.
fönsterklasser I det här avsnittet visas de fönsterklassnamn som tillhandahålls av det gemensamma kontrollbiblioteket.