次元内の特定のレベルの名前を取得します。レベル名はEsbOtlSetLevelNameでアウトラインに明示的に追加されます。
構文
EsbOtlGetLevelName ( hOutline, pszDimension, usLevel, pszName ) ByVal hOutline As Long ByVal pszDimension As String ByVal usLevel As Integer ByVal pszName As String
パラメータ | 説明 |
---|---|
hOutline |
アウトラインのコンテキスト・ハンドル。 |
pszDimension |
対象の世代を含む次元の名前。 |
usLevel |
名前を取得するレベル番号の番号。リーフ・メンバーはレベル0です。 |
pszName |
呼出し元によって割り当てられた、指定された次元のレベルの戻しのためのバッファ。バッファは有効なメンバー名(ESB_MBRNAMELEN)を保存するのに十分な大きさである必要があります。 |
備考
世代名はメンバー名と同じルールに従い、メンバー名全体で一意性が必要です。他の世代、レベル、メンバー名、または別名と重複できません。重複した名前を追加しようとすると、エラーが発生します。
レベル名は自動的には割り当てられません。この関数で名前を戻すには、名前を割り当てておく必要があります。名前はEsbOtlSetLevelNameで割り当てられます。
戻り値
関数が正常終了した場合、戻り値は0になります。それ以外の場合のコマンドの戻り値は次のとおりです:
OTLAPI_NO_GENLEVELNAME
OTLAPI_ERR_NOTADIM
例
Declare Function EsbOtlGetLevelName Lib "ESBOTLN" (ByVal hOutline As Long, ByVal pszDimension As String, ByVal usLevel As Integer, ByVal pszName As String) As Long Sub ESB_OtlGetLevelName() Dim sts As Long Dim Object As ESB_OBJDEF_T Dim hOutline As Long Dim Dimension As String Dim LevelNum As Integer Dim LevelName As String * ESB_MBRNAMELEN Object.hCtx = hCtx Object.Type = ESB_OBJTYPE_OUTLINE Object.AppName = "Sample" Object.DbName = "Basic" Object.FileName = "Basic" sts = EsbOtlOpenOutline(hCtx, Object, ESB_YES, ESB_YES, hOutline) '***************************************** '********** Get Level Name *************** '***************************************** Dimension = "Year" LevelNum = 2 If Not sts Then sts = EsbOtlGetLevelName(hOutline, Dimension, LevelNum, LevelName) End If End Sub
関連トピック