Egenskapsbladshanterare

När en användare högerklickar på ett Shell-objekt innehåller snabbmenyn som visas normalt ett Egenskaper objekt. Om du väljer det objektet startas ett egenskapsblad som gör att användaren kan visa och i vissa fall ändra objektets egenskaper. Du kan anpassa det här egenskapsbladet genom att implementera och registrera en egenskapsbladshanterare.

De allmänna procedurerna för att implementera och registrera en Shell-tilläggshanterare beskrivs i Skapa gränssnittstilläggshanterare. Det här dokumentet fokuserar på de aspekter av implementeringen som är specifika för egenskapsbladshanterare.

• Hur egenskapsbladshanterare fungerar
• registrera och implementera en egenskapsdokumenthanterare för en monterad enhet
• Relaterade ämnen

Så här fungerar egenskapsbladshanterare

Följande bild visar egenskapsbladet Egenskaper för en Windows XP-textfil.

Den här bilden visar standardegenskapsbladet Egenskaper som visas för alla filer. För många sådana egenskapsblad kan du lägga till en eller flera sidor i egenskapsbladet genom att implementera och registrera en egenskapsbladshanterare.

Egenskapsbladshanterare är oftast registrerade för en filtyp. Varje hanterare kan lägga till en anpassad sida i egenskapsbladet Egenskaper för klassen. Dessa sidor ger vanligtvis användare åtkomst till egenskaper som är specifika för den specifika filtypen. En filtyp som består av textdokument kan till exempel visa en sida som visar rubriken och författaren och en sammanfattning av dokumentet. Ett specialfall för den här typen av egenskapsbladshanterare används för att lägga till en sida i egenskapsbladet Egenskaper för en monterad enhet.

Den andra användningen för egenskapsbladshanterare är att ersätta sidor i egenskapsbladen som visas av Kontrollpanelens program. En mustillverkare kan till exempel använda en egenskapsbladshanterare för att ersätta sidan knappar på kontrollpanelens musegenskaper egenskapsblad med en sida som är anpassad för musens egenskaper.

Precis som alla Gränssnittstilläggshanterare är egenskapsbladshanterare com-objekt (Komponentobjektmodell) som implementeras som DLL:er. De måste exportera två gränssnitt utöver IUnknown: IShellExtInit och IShellPropSheetExt.

Gränssnittet IShellExtInit används av gränssnittet för att initiera hanteraren. När gränssnittet anropar IShellExtInit::Initieraskickar det in ett dataobjekt med objektets namn och pekaren till en lista över objektidentifierare (PIDL) för mappen som innehåller filen. Parametern hRegKey används inte med egenskapsbladshanterare. Metoden IShellExtInit::Initialize måste extrahera filnamnet från dataobjektet och lagra namnet och mappens PIDL för senare användning. Mer information finns i avsnittet Implementing IShellExtInit i Creating Shell Extension Handlers.

Resten av åtgärden sker via hanterarens IShellPropSheetExt--gränssnitt. Om egenskapsbladet är associerat med en filtyp anropar Shell IShellPropSheetExt::AddPages så att hanteraren kan lägga till en sida i egenskapsbladet. Om egenskapsbladet är associerat med ett kontrollpanelsprogram anropar Shell IShellPropSheetExt::ReplacePage- för att tillåta att hanteraren ersätter en sida.

Registrera och implementera en egenskapsbladshanterare för en monterad enhet

Varje monterad enhet har ett egenskapsblad som kan visas av användaren. Följande bild visar egenskapsbladet Egenskaper för en CD-ROM enhet.

Det finns en mängd olika enheter som kan monteras som enheter. Eftersom standardegenskapsbladet, som är utformat för diskenheter, kanske inte räcker för vissa enheter, kan en egenskapsbladshanterare implementeras för att lägga till en sida som är specifik för den monterade enheten. Den grundläggande implementeringen av den här typen av egenskapsbladshanterare är identisk med den som beskrivs i How to Register and Implement a Property Sheet Handler for a File Type, med två undantag.

• Dataobjektet som skickas till hanterarens IShellExtInit::Initiera-metoden kan innehålla enhetssökvägen i CFSTR_MOUNTEDVOLUME format i stället för CF_HDROP format. Det CF_HDROP formatet används när enheten monteras på en enhetsbeteckning. Det CFSTR_MOUNTEDVOLUME formatet används med NTFS-filsystem när fjärrenheten monteras i en mapp i stället för till en enhetsbeteckning.
• Hanterarens GUID registreras under HKEY_CLASSES_ROOT\Drive\shellex\PropertySheetHandlers nyckel.

Relaterade ämnen

Registrera och implementera en egenskapsdokumenthanterare för en filtyp

Registrera och implementera en egenskapsdokumenthanterare för ett kontrollpanelsprogram