udisplaycontext.h 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144
  1. /*
  2. *****************************************************************************************
  3. * Copyright (C) 2014-2016, International Business Machines
  4. * Corporation and others. All Rights Reserved.
  5. *****************************************************************************************
  6. */
  7. #ifndef UDISPLAYCONTEXT_H
  8. #define UDISPLAYCONTEXT_H
  9. #include "unicode/utypes.h"
  10. #if !UCONFIG_NO_FORMATTING
  11. /**
  12. * \file
  13. * \brief C API: Display context types (enum values)
  14. */
  15. /**
  16. * Display context types, for getting values of a particular setting.
  17. * Note, the specific numeric values are internal and may change.
  18. * @stable ICU 51
  19. */
  20. enum UDisplayContextType {
  21. /**
  22. * Type to retrieve the dialect handling setting, e.g.
  23. * UDISPCTX_STANDARD_NAMES or UDISPCTX_DIALECT_NAMES.
  24. * @stable ICU 51
  25. */
  26. UDISPCTX_TYPE_DIALECT_HANDLING = 0,
  27. /**
  28. * Type to retrieve the capitalization context setting, e.g.
  29. * UDISPCTX_CAPITALIZATION_NONE, UDISPCTX_CAPITALIZATION_FOR_MIDDLE_OF_SENTENCE,
  30. * UDISPCTX_CAPITALIZATION_FOR_BEGINNING_OF_SENTENCE, etc.
  31. * @stable ICU 51
  32. */
  33. UDISPCTX_TYPE_CAPITALIZATION = 1,
  34. /**
  35. * Type to retrieve the display length setting, e.g.
  36. * UDISPCTX_LENGTH_FULL, UDISPCTX_LENGTH_SHORT.
  37. * @stable ICU 54
  38. */
  39. UDISPCTX_TYPE_DISPLAY_LENGTH = 2
  40. };
  41. /**
  42. * @stable ICU 51
  43. */
  44. typedef enum UDisplayContextType UDisplayContextType;
  45. /**
  46. * Display context settings.
  47. * Note, the specific numeric values are internal and may change.
  48. * @stable ICU 51
  49. */
  50. enum UDisplayContext {
  51. /**
  52. * ================================
  53. * DIALECT_HANDLING can be set to one of UDISPCTX_STANDARD_NAMES or
  54. * UDISPCTX_DIALECT_NAMES. Use UDisplayContextType UDISPCTX_TYPE_DIALECT_HANDLING
  55. * to get the value.
  56. */
  57. /**
  58. * A possible setting for DIALECT_HANDLING:
  59. * use standard names when generating a locale name,
  60. * e.g. en_GB displays as 'English (United Kingdom)'.
  61. * @stable ICU 51
  62. */
  63. UDISPCTX_STANDARD_NAMES = (UDISPCTX_TYPE_DIALECT_HANDLING<<8) + 0,
  64. /**
  65. * A possible setting for DIALECT_HANDLING:
  66. * use dialect names, when generating a locale name,
  67. * e.g. en_GB displays as 'British English'.
  68. * @stable ICU 51
  69. */
  70. UDISPCTX_DIALECT_NAMES = (UDISPCTX_TYPE_DIALECT_HANDLING<<8) + 1,
  71. /**
  72. * ================================
  73. * CAPITALIZATION can be set to one of UDISPCTX_CAPITALIZATION_NONE,
  74. * UDISPCTX_CAPITALIZATION_FOR_MIDDLE_OF_SENTENCE,
  75. * UDISPCTX_CAPITALIZATION_FOR_BEGINNING_OF_SENTENCE,
  76. * UDISPCTX_CAPITALIZATION_FOR_UI_LIST_OR_MENU, or
  77. * UDISPCTX_CAPITALIZATION_FOR_STANDALONE.
  78. * Use UDisplayContextType UDISPCTX_TYPE_CAPITALIZATION to get the value.
  79. */
  80. /**
  81. * The capitalization context to be used is unknown (this is the default value).
  82. * @stable ICU 51
  83. */
  84. UDISPCTX_CAPITALIZATION_NONE = (UDISPCTX_TYPE_CAPITALIZATION<<8) + 0,
  85. /**
  86. * The capitalization context if a date, date symbol or display name is to be
  87. * formatted with capitalization appropriate for the middle of a sentence.
  88. * @stable ICU 51
  89. */
  90. UDISPCTX_CAPITALIZATION_FOR_MIDDLE_OF_SENTENCE = (UDISPCTX_TYPE_CAPITALIZATION<<8) + 1,
  91. /**
  92. * The capitalization context if a date, date symbol or display name is to be
  93. * formatted with capitalization appropriate for the beginning of a sentence.
  94. * @stable ICU 51
  95. */
  96. UDISPCTX_CAPITALIZATION_FOR_BEGINNING_OF_SENTENCE = (UDISPCTX_TYPE_CAPITALIZATION<<8) + 2,
  97. /**
  98. * The capitalization context if a date, date symbol or display name is to be
  99. * formatted with capitalization appropriate for a user-interface list or menu item.
  100. * @stable ICU 51
  101. */
  102. UDISPCTX_CAPITALIZATION_FOR_UI_LIST_OR_MENU = (UDISPCTX_TYPE_CAPITALIZATION<<8) + 3,
  103. /**
  104. * The capitalization context if a date, date symbol or display name is to be
  105. * formatted with capitalization appropriate for stand-alone usage such as an
  106. * isolated name on a calendar page.
  107. * @stable ICU 51
  108. */
  109. UDISPCTX_CAPITALIZATION_FOR_STANDALONE = (UDISPCTX_TYPE_CAPITALIZATION<<8) + 4,
  110. /**
  111. * ================================
  112. * DISPLAY_LENGTH can be set to one of UDISPCTX_LENGTH_FULL or
  113. * UDISPCTX_LENGTH_SHORT. Use UDisplayContextType UDISPCTX_TYPE_DISPLAY_LENGTH
  114. * to get the value.
  115. */
  116. /**
  117. * A possible setting for DISPLAY_LENGTH:
  118. * use full names when generating a locale name,
  119. * e.g. "United States" for US.
  120. * @stable ICU 54
  121. */
  122. UDISPCTX_LENGTH_FULL = (UDISPCTX_TYPE_DISPLAY_LENGTH<<8) + 0,
  123. /**
  124. * A possible setting for DISPLAY_LENGTH:
  125. * use short names when generating a locale name,
  126. * e.g. "U.S." for US.
  127. * @stable ICU 54
  128. */
  129. UDISPCTX_LENGTH_SHORT = (UDISPCTX_TYPE_DISPLAY_LENGTH<<8) + 1
  130. };
  131. /**
  132. * @stable ICU 51
  133. */
  134. typedef enum UDisplayContext UDisplayContext;
  135. #endif /* #if !UCONFIG_NO_FORMATTING */
  136. #endif