Sdílet prostřednictvím

Využívání knihoven a komponent

  • Článek

Projekty C++ často potřebují volat funkce nebo přistupovat k datům v binárním souboru, jako jsou statické knihovny (soubory LIB), knihovna DLL, prostředí Windows Runtime komponenta, komponenta COM nebo sestavení .NET. V těchto případech musíte projekt nakonfigurovat tak, aby v době sestavení mohl tento binární soubor najít. Konkrétní kroky závisí na typu projektu, typu binárního souboru a na tom, jestli se binární soubor sestaví ve stejném řešení jako váš projekt.

Využívání knihoven stažených přes vcpkg

Pokud chcete využívat knihovnu, kterou jste stáhli pomocí správce balíčků vcpkg , můžete následující pokyny ignorovat. Další informace naleznete v tématu:

Využívání statických knihoven

Pokud se projekt statické knihovny sestaví ve stejném řešení:

  1. #include soubory hlaviček pro statickou knihovnu pomocí uvozovek. V typickém řešení začíná cesta ../<library project name>. IntelliSense vám pomůže ho najít.
  2. Přidejte odkaz na projekt statické knihovny. Klikněte pravým tlačítkem myši na Odkazy pod uzlem projektu aplikace v Průzkumník řešení a zvolte Přidat odkaz.

Pokud statická knihovna není součástí řešení:

  1. Klikněte pravým tlačítkem myši na uzel projektu aplikace v Průzkumník řešení a pak zvolte Vlastnosti.
  2. Na stránce vlastností adresářů VC++ přidejte cestu k adresáři, který obsahuje soubor LIB do cest knihovny. Pak přidejte cestu k souborům hlaviček knihovny do adresářů include.
  3. Na stránce vlastnosti Vstup linkeru > přidejte název souboru LIB do dalších závislostí.

Pokud se knihovna DLL sestaví jako součást stejného řešení jako aplikace, postupujte stejně jako u statické knihovny.

Pokud knihovna DLL není součástí řešení aplikace, potřebujete: soubor DLL, hlavičky s prototypy pro exportované funkce a třídy a soubor LIB, který poskytuje nezbytné informace o propojení.

  1. Zkopírujte knihovnu DLL do výstupní složky projektu nebo do jiné složky ve standardní cestě hledání windows pro knihovny DLL. Další informace naleznete v tématu Pořadí hledání knihovny dynamického propojení.
  2. Postupujte podle kroků 1 až 3 pro statické knihovny a zadejte cesty k hlavičkám a souboru LIB.

COM – objekty

Pokud vaše nativní aplikace C++ potřebuje spotřebovat objekt COM a tento objekt je zaregistrovaný, stačí volat CoCreateInstance a předat CLSID objektu. Systém ho najde v registru Systému Windows a načte ho. Projekt C++/CLI může objekt COM využívat stejným způsobem. Nebo ho může využívat tak, že k němu přidáte odkaz ze seznamu Přidat odkazy > modelu COM a zabírají ho prostřednictvím obálky s možností volatelného modulu runtime.

Sestavení .NET a komponenty prostředí Windows Runtime

V projektech UPW nebo C++/CLI využíváte sestavení .NET nebo prostředí Windows Runtime Součásti přidáním odkazu na sestavení nebo komponentu. V uzlu Odkazy v projektu UPW nebo C++/CLI se zobrazí odkazy na běžně používané komponenty. Klikněte pravým tlačítkem myši na uzel Reference v Průzkumník řešení zobrazte Správce odkazů a projděte komponenty dostupné v systému. Zvolte tlačítko Procházet a přejděte do libovolné složky, která obsahuje vlastní komponentu. Vzhledem k tomu, že sestavení .NET a prostředí Windows Runtime komponenty obsahují předdefinované informace o typu, můžete zobrazit jejich metody a třídy kliknutím pravým tlačítkem myši a zvolením možnosti Zobrazit v prohlížeči objektů.

Referenční vlastnosti

Každý druh odkazu má vlastnosti. Vlastnosti můžete zobrazit tak, že vyberete odkaz v Průzkumník řešení a stisknete Alt + Enter nebo kliknete pravým tlačítkem myši a zvolíte Vlastnosti. Některé vlastnosti jsou jen pro čtení a některé jsou upravitelné. Obvykle ale nemusíte tyto vlastnosti upravovat ručně.

vlastnosti odkazu technologie ActiveX

technologie ActiveX vlastnosti odkazu jsou k dispozici pouze pro odkazy na komponenty modelu COM. Tyto vlastnosti se zobrazí pouze v případech, kdy v podokně Reference vyberete komponentu COM. Vlastnosti nejsou upravitelné.

  • Úplná cesta ovládacího prvku

    Zobrazí cestu k adresáři odkazovaného ovládacího prvku.

  • GUID ovládacího prvku

    Zobrazí identifikátor GUID ovládacího prvku technologie ActiveX.

  • Verze ovládacího prvku

    Zobrazí verzi odkazovaného ovládacího prvku technologie ActiveX.

  • Název knihovny typů

    Zobrazí název odkazované knihovny typů.

  • Nástroj Obálka

    Zobrazí nástroj, který se používá k sestavení sestavení vzájemné spolupráce z odkazované knihovny COM nebo technologie ActiveX ovládacího prvku.

Referenční vlastnosti sestavení (C++/CLI)

Vlastnosti odkazu na sestavení jsou k dispozici pouze pro odkazy na sestavení rozhraní .NET Framework v projektech C++/CLI. Tyto vlastnosti se zobrazí pouze při výběru sestavení rozhraní .NET Framework v podokně Reference . Vlastnosti nejsou upravitelné.

  • Relativní cesta

    Zobrazí relativní cestu z adresáře projektu k odkazovanému sestavení.

Vlastnosti sestavení

Následující vlastnosti jsou k dispozici na různých typech odkazů. Umožňují určit, jak se mají vytvářet s odkazy.

  • Kopírovat místní

    Určuje, zda se má automaticky kopírovat odkazované sestavení do cílového umístění během sestavení.

  • Kopírování místních satelitních sestavení (C++/CLI)

    Určuje, zda se mají automaticky kopírovat satelitní sestavení odkazovaného sestavení do cílového umístění během sestavení. Používá se pouze v případě, že je místní kopie true.

  • Referenční výstup sestavení

    Určuje, že se toto sestavení použije v procesu sestavení. Pokud truese sestavení použije na příkazovém řádku kompilátoru během sestavení.

Referenční vlastnosti projektu k projektu

Následující vlastnosti definují odkaz projektu na projekt z projektu vybraného v podokně Odkazy na jiný projekt ve stejném řešení. Další informace naleznete v tématu Správa odkazů v projektu.

  • Závislosti knihovny odkazů

    Pokud je tato vlastnost True, systém projektu pro propojení souborů LIB, které nezávislý projekt vytvoří do závislého projektu. Obvykle zadáte True.

  • Identifikátor projektu

    Jednoznačně identifikuje nezávislý projekt. Hodnota vlastnosti je identifikátor GUID interního systému, který není možné upravit.

  • Použití vstupů závislostí knihovny

    Pokud je tato vlastnost False, systém projektu nebude propojit soubory OBJ pro knihovnu, kterou nezávislý projekt vytvoří do závislého projektu. Proto tato hodnota zakáže přírůstkové propojení. Obvykle zadáte false , protože sestavení aplikace může trvat dlouhou dobu, pokud existuje mnoho nezávislých projektů.

Referenční vlastnosti jen pro čtení (COM & .NET)

Na odkazech na sestavení COM a .NET existují následující vlastnosti a nelze je upravit.

  • Název sestavení

    Zobrazí název sestavení pro odkazované sestavení.

  • Kultury

    Zobrazí jazykovou verzi vybraného odkazu.

  • Popis

    Zobrazí popis vybraného odkazu.

  • Úplná cesta

    Zobrazí cestu k adresáři odkazovaného sestavení.

  • Identita

    Pro sestavení rozhraní .NET Framework zobrazí úplnou cestu. U komponent modelu COM zobrazí identifikátor GUID.

  • Popisek

    Zobrazí popisek odkazu.

  • Název

    Zobrazí název odkazu.

  • Token veřejného klíče

    Zobrazí token veřejného klíče použitý k identifikaci odkazovaného sestavení.

  • Silný název

    true pokud odkazované sestavení má silný název. Sestavení se silným názvem má jedinečnou verzi.

  • Verze

    Zobrazí verzi odkazovaného sestavení.

Viz také

Referenční dokumentace stránky vlastností projektu C++
Nastavení vlastností kompilátoru a sestavení C++ v sadě Visual Studio