Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Het Document hostitem is een type dat het Document type uitbreidt van de primaire interop-assembly voor Word. Het Document hostitem biedt dezelfde eigenschappen, methoden en gebeurtenissen als een Document object, maar biedt ook aanvullende gebeurtenissen en fungeert als een container voor hostbesturingselementen en Windows Forms-besturingselementen.
Van toepassing op: De informatie in dit onderwerp is van toepassing op projecten op documentniveau en VSTO-invoegtoepassingsprojecten voor Word. Zie Functies die beschikbaar zijn voor de Office-toepassing en het projecttype voor meer informatie.
In projecten op documentniveau is er een standaardhostitem Document dat het document in uw project vertegenwoordigt. In VSTO-invoegtoepassingsprojecten kunt u tijdens de uitvoeringstijd hostitems genereren Document.
Inzicht in het document-hostitem in documentniveauprojecten
Gebruik de ThisDocument klasse om toegang te krijgen tot het document in uw project. Wanneer u een project op documentniveau maakt, genereert Visual Studio de ThisDocument klasse die fungeert als de communicatiekoppeling tussen Word en uw aanpassingscode. De ThisDocument klasse geeft u toegang tot leden van het Document hostitem om basistaken uit te voeren in uw aanpassing, zoals het uitvoeren van code wanneer het document wordt geopend of gesloten. U kunt de klasse ook gebruiken om besturingselementen aan het document toe te voegen. Door verschillende sets besturingselementen te combineren en code te schrijven, kunt u de besturingselementen binden aan gegevens, informatie van de gebruiker verzamelen en reageren op gebruikersacties. Zie Documentaanpassingen op programmagebied voor meer informatie.
De ThisDocument klasse biedt een locatie waar u code in uw project kunt gaan schrijven. Omdat de klasse dezelfde eigenschappen, methoden en gebeurtenissen biedt als het Document object in de primaire interop-assembly voor Word, kunt u ook ThisDocument gebruiken om het objectmodel van Word te openen. Zie het overzicht van het Word-objectmodel voor meer informatie.
Beperkingen van het documenthostitem in projecten op documentniveau
Een project op documentniveau kan slechts één Document hostitem bevatten (dat wil gezegd de ThisDocument klasse). U kunt geen nieuwe Document hostitems toevoegen aan uw project tijdens het ontwerp en u kunt geen nieuwe Document hostitems maken tijdens runtime vanuit een aanpassing op documentniveau.
Als u tijdens runtime een nieuw Word-document maakt, is dit van het type Document. Omdat het geen hostitem is, kan het geen hostbesturingselementen of Windows Forms-besturingselementen bevatten. Zie Instructies voor het programmatisch maken van nieuwe documenten voor meer informatie over het maken van documenten tijdens runtime.
Begrijp documenthostitems in projecten op toepassingsniveau
In VSTO-invoegtoepassingsprojecten kunt u tijdens runtime een Document hostitem genereren voor elk document dat is geopend in Word. U kunt het Document hostitem gebruiken om besturingselementen toe te voegen aan het bijbehorende document of om gebeurtenissen af te handelen die niet beschikbaar zijn voor Document objecten.
Als u een Document hostitem wilt genereren, gebruikt u de GetVstoObject methode. Zie Word-documenten en Excel-werkmappen tijdens runtime uitbreiden in VSTO-invoegtoepassingen voor meer informatie.