.. highlightlang:: us

.. index:: AppSetGlobalOption

.. _appsetglobaloption:

AppSetGlobalOption
==================

.. us.tag  AppSetGlobalOption GERMAN App New590 Changed5147 Changed5400 Changed6200

:ref:`AppSetGlobalOption` setzt den Wert einer Option aus
:ref:`extrasweitere-optionen`.

.. function::  bool = AppSetGlobalOption(ssOption, val)

.. us.return

**Returnwert**

*bool* ist TRUE (1) wenn die Funktion erfolgreich war und sonst FALSE (0).

.. us.params

**Parameter**

.. uparam:: ssOption

   *ssOption* ist eine der folgenden Optionen:

   .. list-table::
      :header-rows: 1

      * - Name
        - Datentyp
        - Default
        - Beschreibung
      * - ``"user-home-directory"``
        - string
        -
        - siehe :ref:`GetUserDirectory`.
      * - ``"netcdf-directory"``
        - string
        -
        - Verzeichnis in dem importierte UniPlot-Datendateien (nc2) gespeichert
          werden. Das Verzeichnis muss vor Aufruf dieser Funktion existieren. 

          Wenn kein Verzeichnis angegeben wird, werden die Dateien in
          den Verzeichnissen gespeichert, aus denen sie importiert wurden.
      * - ``"delay-loading"``
        - integer
        - 1
        - Verzögertes Laden von Datendateien bei MDF- und TDM-Dateien.
      * - ``"update-shortcut-programs"``
        - integer
        - 0
        - Erzeugt oder aktualisiert den Menüeintrag von UniPlot im
          Windows-Startmenü.
      * - ``"update-shortcut-desktop"``
        - integer
        - 0
        - Erzeugt oder aktualisiert die Programmverknüpfung von UniPlot im
          Windows-Desktop.
      * - ``"update-shortcut-quicklaunch"``
        - integer
        - 0
        - Erzeugt oder aktualisiert die Programmverknüpfung von UniPlot im 
          Quick Launch Toolbar.
      * - ``"nc-allow-special-chars"``
        - integer
        - 0
        - 1: Die folgenden 10 Sonderzeichen bleiben beim Import von Datendateien 
          in Kanalnamen bleiben erhalten: ., -, +, , #, ~, !, ^, &, %. 
          
          0 (Default): Die Sonderzeichen werden durch Unterstriche ersetzt.
      * - ``"auto-compact"``
        - integer
        - 1
        - Kompaktes Speichern defrakmentierter Dokumentdateien beim Schließen.
      * - ``"gdi-driver"``
        - integer
        - 3
        - Treiber für Grafikausgabe: 1: GDI, 2: GDI+, 3: Direct2D (Default), siehe :ref:`AppSetGDI`.
      * - ``"gdi-driver-printer"``
        - integer
        - 1
        - Treiber für Druckerausgabe: 1: GDI (Default), 2: GDI+, Siehe :ref:`AppSetGDI`.
      * - ``"nc-utf8"``
        - integer
        - 1
        - Gibt an, dass die Datei UTF-8 enkodiert ist. Der Attribut-Wert wird
          ignoriert.

.. uparam:: val

   *val* ist der Wert der Option.

.. us.history

**History**

.. list-table::
   :header-rows: 1

   * - Version
     - Beschreibung
   * - R2020
     - Neue Option ``nc-utf8``.
   * - R2012 (5.40.0)
     - Die Optionen ``standard-netcdf-files`` und ``max-data-import`` wurden
       entfernt.
   * - 5.14.7
     - Neue Optionen.
   * - 5.9
     - Neu.

.. seealso::
   :ref:`uberblick-application-objekt`,
   :ref:`AppGetGlobalOption`,
   :ref:`AppLoadSettings`,
   :ref:`AppSaveSettings`

:sub:`id-397652`