HypConnected

Cloudデータ・プロバイダ・タイプ: Oracle Analytics Cloud - Essbase、Oracle Planning and Budgeting Cloud

オンプレミス・データ・プロバイダ・タイプ: Oracle Essbase、Oracle Hyperion Planning、Oracle Hyperion Financial Management

説明

HypConnected()は、シートの接続ステータスを提供します。

構文

HypConnected (vtSheetName)

ByVal vtSheetName As Variant

パラメータ

vtSheetName: 関数を実行するワークシートの名前。vtSheetNameがNullまたはEmptyの場合、アクティブなワークシートが使用されます。

戻り値

シートがプロバイダに接続されている場合はTrue、それ以外の場合はFalseを戻します。

例

Declare Function HypConnected Lib "HsAddin" (ByVal vtSheetName As Variant) As Variant

Sub Example_HypConnected
   Dim X As Variant
   X = HypConnected(Empty)
End sub

シートに接続している場合、値が-1の変数が戻され、VBAではTrueとして解釈されます。戻り値として-1を取得するには、変数(戻り値を取るもの)を数値型(Long、Integer、Doubleなど)として宣言する必要があります。次に示すスクリプトでこれを説明します。

Declare Function HypConnected Lib "HsAddin" (ByVal vtSheetName As Variant) As Variant
Sub Example_HypConnected()
Dim X As Integer 'Can also be Long or Double
X = HypConnected(Empty)  'Value of X will become -1 if Sheet1 is connected
End Sub

変数Xが定義されていない場合、VBAでは(定義されていないその他の変数も) Variant型として解釈されます。したがって、Sheet1が接続している場合、XはTrueに相当します。

変数Xがブール値として定義されている場合、戻り値は正確にTrueと表示されます。